Claude Code on iPhone: 3 Ways to Run It

You can run Claude Code on iPhone today, but not the way you run it on a laptop. Claude Code needs an x86_64 (or arm64) Linux host, and iOS does not give you one — there is no Termux for iPhone, and the local terminals that do exist cannot run a modern Node.js. So on an iPhone the agent always runs somewhere else and your phone drives it. The fastest path is Cosyra on the App Store: a cloud Ubuntu container with Claude Code pre-installed that you reach from a native iOS app. Paste your Anthropic API key, type claude, and you are in. Sign up gets you 1 hour free, no credit card. The two other real paths are SSH from Blink Shell into your own machine, and Anthropic's Claude Code on the Web.

This is the iPhone-specific companion to our Claude Code on your phone walkthrough, which covers iPhone and Android together. The iPhone deserves its own page because iOS changes the answer in one big way: Android has Termux, so on a Pixel or Galaxy you can install Claude Code on the phone itself (we cover that in Claude Code on Android). iOS has no equivalent. That single difference is why the iPhone story is all about reaching a host, never about running the agent on the device. If you want the bigger tablet form factor, see Claude Code on iPad; for the full picture of every agent on mobile, start at our AI coding agents on mobile pillar.

Why won't Claude Code run locally on an iPhone?

Claude Code will not run locally on an iPhone because iOS has no Linux userland and the on-device terminals cannot run a modern Node.js. On Android this is a solved problem: Termux gives you a real package manager and Claude Code runs on the phone via npm plus a shell alias. Apple does not allow anything like Termux on iOS — apps cannot ship a general-purpose Linux environment that installs and runs arbitrary native binaries. So the two well-known iOS terminals each hit a wall:

• iSH emulates 32-bit i386 Alpine Linux. Modern Node.js crashes with Illegal instruction under that emulation — tracked in iSH issue #2335, open since 2024-01-21 — and the i386-only target rules out current Node prebuilt binaries anyway. No Node means no Node-based AI CLI.
• a-Shell ships native iOS-compiled tools and a curated set of WebAssembly binaries. It is fast and genuinely useful, but it has no apt, no apk, and no global npm install path, so you cannot install Claude Code into it.

We have an opinion the "just use a real laptop" crowd would push back on: the iPhone is a fine coding client precisely because you stop trying to make it the host. Once you accept that the phone's job is to drive a Linux box that lives elsewhere, every "you can't develop on a phone" complaint stops applying — the box does the work, and the phone is the window you open on the train. For deeper coverage of the local-terminal limits see Termux for iPhone and Cosyra vs iSH.

What are the three ways to run Claude Code on iPhone?

There are three real ways to run Claude Code from an iPhone as of 2026-06-28: a cloud terminal with Claude Code pre-installed (Cosyra, native iOS app), SSH from a terminal app into your own always-on machine, or Anthropic's Claude Code on the Web in Safari. All three share the same shape — the agent runs on a Linux host and the iPhone is the remote. They differ in who owns and babysits that host.

1. Cosyra (cloud terminal, native iOS app)

This is what we build. The Cosyra iOS app gives you a persistent Ubuntu 24.04 container with Claude Code, Codex CLI, OpenCode, and Gemini CLI already installed, 30 GB of storage, and hibernation that resumes exactly where you left off. We pre-install the four agents because setup friction is the thing that actually kills agent-driven mobile coding; nobody wants to debug an npm install on a phone keyboard. There is no SSH tunnel to keep alive and no laptop that has to stay awake. The same container is reachable from iPhone, Android, and web, so you can start on the couch and pick it up in a waiting room.

• Works when: you want zero setup and a host you do not have to maintain.
• Breaks when: you have no internet — the container lives in the cloud, so there is no offline mode. That is a real trade-off against a local terminal.
• Cost: 1 hour free on signup, no credit card. Extend with a 10-hour, 7-day trial when you want more. After that, $29.99/month or $300/year. See pricing.

2. SSH from Blink Shell into your own machine

The classic remote-into-your-own-box path. Blink Shell is a paid iOS terminal (Blink+ is $19.99/year as of 2026-06-28 per the App Store listing) built around SSH and Mosh. Mosh matters on a phone: it keeps the session alive across the cellular handoffs and IP changes that drop plain SSH the moment you walk between cell towers. You SSH into a Mac, Linux box, or VPS that already runs Claude Code, start tmux so the session survives app switching, and drive the agent from there.

• Works when: you already keep an always-on machine and are comfortable with SSH plus tmux.
• Breaks when: the machine sleeps, the home connection drops, or you do not want to keep a second computer awake just so the phone has a target.
• Cost: Blink+ ($19.99/yr) plus whatever the host costs. Tailscale's free tier covers personal networking.

3. Claude Code on the Web in Safari

Anthropic's Claude Code on the Web runs tasks on Anthropic-managed VMs (4 vCPU / 16 GB / 30 GB, Ubuntu 24.04). You connect a GitHub repo at claude.ai/code, kick off a task, and the VM clones, runs, and pushes a branch. You can monitor and steer it from the Claude iOS app. On an iPhone it renders in Safari, though the layout is built for bigger screens, so it is more comfortable for kicking off and reviewing than for hands-on iteration.

• Works when: your workflow is GitHub-native and you already pay for Claude Pro/Max/Team (research preview eligibility as of 2026-06-28).
• Breaks when: you work outside GitHub, you want OpenCode or Codex alongside Claude in one place, or your org has Zero Data Retention enabled.
• Cost: bundled with Claude Pro/Max/Team. See Anthropic pricing.

How do you set up Claude Code on iPhone with Cosyra?

You set up Claude Code on iPhone in about three minutes: install Cosyra from the App Store, paste an Anthropic API key into the container, and type claude. No Node install, no SSH tunnel, no jailbreak. These are the exact steps we run on a fresh iPhone.

Step 1: Install Cosyra on iPhone

Open the App Store on your iPhone and search for Cosyra. Sign in with Apple, Google, or email and the app provisions a fresh Ubuntu container on first launch, about 15 seconds in our testing. The four agent CLIs are already inside, so you skip the part that breaks most on-phone setups.

Step 2: Add your Anthropic API key

Get an API key from console.anthropic.com. In the Cosyra terminal:

Step 3: Clone a repo and run claude

Clone a repo and start a session:

Claude Code indexes the repo and starts working. Approve or reject diffs inline with a tap. When you close the app to catch your stop, the container hibernates; reopen it and the session is exactly where you left it — no re-clone, no re-auth.

What does iPhone Claude Code look like in practice?

iPhone Claude Code in practice is short prompts, one hand, and dead time that used to be wasted. The phone is not where you do a four-hour refactor; it is where you keep a long task moving while you are away from the desk. Two patterns we run constantly:

The commute kickoff

Standing on the platform, you remember the failing CI job from last night. Open Cosyra, pull the branch, and hand Claude Code the whole problem in one dictated sentence — press and hold the mic key, say it, release:

By the time the train arrives you have a diff to skim. Approve it, let it push, and the rest of the commute is reading the result instead of starting from a cold terminal at your desk.

The waiting-room review

Fifteen minutes in a waiting room is enough to review a teammate's pull request. Pull the branch, ask for a structured review focused on what you care about, and post it with gh pr review --comment from the same terminal. The container holds your gh auth, so there is no login dance. This is the kind of work the phone is genuinely good at: bounded, reviewable, no deep window juggling required.

How do the iPhone options compare?

The iPhone options line up cleanly against what matters for an agent client: whether you maintain the host, whether state persists, and what happens when you switch apps or lose signal. The table covers the real paths as of 2026-06-28. For the wider field of editors and terminals beyond Claude Code, our coding on iPhone guide lines every option up the same way, and best terminal apps for iPhone covers the client side.

Which path should you pick?

Choose Cosyra if you want no host to maintain and the same container across iPhone, Android, and web. Choose Blink + SSH if you already keep an always-on machine and want the agent running on hardware you control. Choose claude.ai/code if you live in GitHub and already pay for Claude Pro. Skip iSH and a-Shell for agent work — they are good terminals, but the iPhone's job here is to be a client, and neither runs the Node-based CLI. If you are on Android instead, the calculus changes because Termux lets the phone be the host; that is the whole point of our Claude Code on Android guide.

Frequently asked questions