Claude Code on iPhone: The Complete Guide (2026)

Claude Code lives in your terminal. Your terminal lives on your laptop. So the second you walk away — to grab coffee, to a meeting, to the couch — you lose all visibility into what your agents are doing. That gap is the whole problem, and your iPhone is the obvious place to close it.

This guide covers everything you can actually do with Claude Code from an iPhone today: monitor running agents, get push notifications when they need you, see live status on your lock screen, and keep tabs on several sessions at once. No remote desktop, no jailbreak, no babysitting.

What "Claude Code on iPhone" actually means

Claude Code itself runs on your dev machine — that doesn't change. What you move to your phone is the part that matters when you step away: awareness and control of state. There are three distinct things people mean by this:

• Monitoring — knowing what each agent is doing right now, and getting pinged when one finishes or needs a decision.
• Notifications — a push the instant an agent hits a permission prompt, completes a task, or errors out.
• Full remote control — actually typing back into a session from your phone. Powerful, but heavier to set up and riskier.

For most developers, the first two cover 95% of the pain. You rarely need to drive from your phone — you need to know when to walk back to your desk.

The fastest setup: hooks + a monitor app

Claude Code ships with hooks — events it fires when things happen (a session starts, stops, asks for permission, or sends a notification). Point those hooks at a phone app and you get mobile visibility in about a minute.

1. Install Agentfy and grab your webhook URL from the app.
2. Paste the app's setup prompt into any Claude Code session — it edits ~/.claude/settings.json for you. (Or add the hooks by hand.)
3. Run an agent. Watch the status appear on your phone.

Full walkthrough here: How to get Claude Code notifications on your iPhone.

Live Activities and the Dynamic Island

This is the part that feels like magic. iOS 18 Live Activities let an app show persistent, updating status on your lock screen and in the Dynamic Island — no unlocking, no opening anything. For Claude Code, that means a glanceable readout like "2 cooking · 1 needs you" sitting on your lock screen while you do something else.

When an agent flips to the "your move" state, the island updates instantly. You glance, you see it's a npm test permission, you approve it from the notification, and you never broke focus. Deep dive: Monitor Claude Code with Live Activities and Dynamic Island.

Running several agents at once

The phone really earns its place when you're running more than one agent. Three terminals across two projects is impossible to track by tabbing between windows — but trivial when each one reports to a single consolidated view on your phone. If that's your workflow, read how to run multiple Claude Code agents in parallel next.

What about full remote control?

If you genuinely need to type back into a session from your phone, your options are a remote terminal (SSH via an app like Blink or Termius into a tmux session) or a tool built specifically for remote Claude Code control. These work, but they come with tradeoffs: you're exposing a shell, typing commands on a touch keyboard, and taking on the security of whatever tunnel you set up.

We compared the full landscape — notification-only tools through full remote terminals — in the best apps to monitor Claude Code from your phone.

Is any of this private?

With a hooks-based monitor, the only thing leaving your machine is session state — a project name, a status, and the permission context (for example, Bash: npm test). Your code, full prompts, and file contents stay local. A remote terminal is different: that's a real shell, so treat it with the same care you'd give any SSH endpoint.

The short version

You don't need to run Claude Code on your iPhone. You need your iPhone to tell you what Claude Code is doing on your Mac. Hooks plus a monitor app gets you there in a minute, and Live Activities make it effortless to glance at.

Agentfy is free to start and does exactly this — agent status on your lock screen, push the moment one needs you.