How to get a phone notification when Claude Code or Codex needs you

Turn on Desktop and phone notifications in HB Code, and your phone gets an alert when the agent asks you a question or sends you a message during a run. For the end of a task, just ask the agent to send one.

HB Code is a desktop app for Mac and Windows. It runs Claude Code and Codex on your own computer with your own Claude and ChatGPT plans.

Steps

  1. On the desktop, open Settings › Background. Turn on Desktop and phone notifications.
  2. Set Agent notifications. Important asks the agent to alert you only for results and for questions that block it. Frequent also asks for milestones and failures.
  3. Connect your phone. On the desktop, open Settings › Connections and turn on Allow Remote Access. Sign in on the phone with the same HB Code account. Allow notifications when the phone asks.
  4. Start a new session and send the task. For an alert at the end, ask for it in the task: Send me a phone alert when you're done.
  5. When the agent asks a question, the alert says Claude has a question or Codex has a question. Tap the alert to open the session.
  6. Answer in the app. Tap one of the choices, or write your own answer.

Notes

  • The end of a run by itself doesn't send a phone alert. The agent sends the alert, so ask for it in the task.
  • A Claude session gets the alert tool on its next run. A Codex session gets it only when the session is new, so start a new Codex session after you turn the setting on.
  • An approval request by itself doesn't send a phone alert. It shows in the session and waits there.
  • The Agent notifications setting is an instruction to the agent. It doesn't filter the alerts for questions.
  • Turn the setting off to stop new alerts.
  • The phone apps need HB Code Pro after a 10-day connected preview.

Questions

Does HB Code notify me when Claude Code finishes?
Only when the agent sends an alert. The end of a run by itself sends none. Ask in the task: Send me a phone alert when you're done.
Do I get an alert when the agent needs approval?
No. An approval request by itself doesn't send a phone alert. It shows in the Chat tab of the session and waits there for you.
Does it work for Codex too?
Yes. Codex and Claude Code use the same alerts. Start a new Codex session after you turn the setting on.
Can the agent send too many alerts?
You set how often the agent should alert you. Important asks it to keep to results and blocking questions. Frequent also asks for milestones and failures.