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

> HB Code sends an alert to your iPhone or Android phone when Claude Code or Codex asks you a question. For the end of a task, ask the agent for an alert.

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.

Updated November 20, 2026

## 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.

## Details in the handbook

- [Alerts written by the agent](https://www.hbcode.ai/docs/tools/agent-tools.md#notifications): Documents, speech, video, alerts, sessions, and session messages
- [Remote access and the device list](https://www.hbcode.ai/docs/setup.md#remote-access): Setup: sign-ins, regions, and remote access
- [Push tokens and the desktop_online hint](https://www.hbcode.ai/docs/android/media.md#push): Android: previews, recording services, push, and billing
- [StoreKit, the connected preview, and push](https://www.hbcode.ai/docs/ios/media.md#purchases): iOS: viewers, Review Mode, dictation, and purchases

## Guides

- [How to check usage limits and use more than one account](https://www.hbcode.ai/claude-code-usage-limits.md)
- [How to check what Claude Code or Codex did](https://www.hbcode.ai/claude-code-ui.md)
- [How to run several Claude Code and Codex sessions](https://www.hbcode.ai/claude-code-sessions.md)
- [How to use Claude Code or Codex on your phone](https://www.hbcode.ai/claude-code-mobile.md)
- [How to see what the subagents of Claude Code do](https://www.hbcode.ai/claude-code-subagents.md)
- [How to try Claude Code and Codex on the same task](https://www.hbcode.ai/claude-code-vs-codex.md)
- [How to run Codex in a desktop app on Mac and Windows](https://www.hbcode.ai/codex-desktop-app.md)
- [How to switch Claude Code and Codex accounts without logging out](https://www.hbcode.ai/switch-claude-code-codex-accounts.md)
- [How to let Claude Code write and Codex review the change](https://www.hbcode.ai/claude-code-codex-review.md)
- [How to use Claude Code and Codex on Windows](https://www.hbcode.ai/claude-code-windows.md)
- [How to use Claude Code and Codex from an Android phone](https://www.hbcode.ai/claude-code-android.md)
- [How to run Claude Code in a desktop app on Mac and Windows](https://www.hbcode.ai/claude-code-desktop-app.md)
- [How to continue a Claude Code terminal session on your phone](https://www.hbcode.ai/claude-code-resume-session.md)
- [How to keep your computer awake while Claude Code or Codex works](https://www.hbcode.ai/claude-code-keep-computer-awake.md)
- [How to monitor your Claude Code and Codex usage over time](https://www.hbcode.ai/claude-code-usage-monitor.md)
- [Download HB Code](https://www.hbcode.ai/downloads)
