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
- On the desktop, open Settings › Background. Turn on Desktop and phone notifications.
- 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.
- 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.
- 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.
- 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.
- 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.