How to Run Claude Code From Your Phone
Five practical ways to run Claude Code from a phone, with setup, security, host availability, permission, and mobile-interface trade-offs.
The reliable way to use Claude Code from a phone is to run it on a computer or server and treat the phone as a remote interface. That keeps the development environment intact and avoids trying to turn iOS or Android into a full workstation.
Here are five useful approaches, ordered from the simplest first-party experience to more configurable remote infrastructure.
Before choosing an interface
Decide where the agent should run:
- Your laptop: no extra server, but remote access stops when it sleeps.
- A home server: always available if your network and power are reliable.
- A VPS: reachable and usually always on, but it needs patching, backups, and careful credential boundaries.
The host can read whatever the agent account can read. Avoid copying broad production credentials onto an always-on box just because the phone interface is convenient.
1. Anthropic Remote Control
Claude Code’s Remote Control connects a running local session to Claude on the web or the iOS/Android app. Start it on the host:
claude remote-control
Open the session link or scan the QR code in the Claude app. Your repository, MCP servers, and local tools remain on the host.
Good for: the shortest supported route and a phone-friendly first-party interface.
Watch for: the Claude process and host must stay running, and the workflow is specific to Claude Code.
2. The official Telegram channel
Claude Code Channels can connect an allowlisted Telegram bot to a running session. You can send tasks, receive replies, and handle supported tool permission requests with Allow and Deny buttons.
Good for: people who already use Telegram and want short conversational interactions.
Watch for: bot-token security, a host process that must stay alive, and a chat interface that is not a full terminal.
The complete installation and permission model are in How to Connect Claude Code to Telegram.
3. SSH from a mobile terminal
A mobile SSH client connects directly to the development host. Add tmux so a
network interruption does not kill the agent:
ssh dev@example-host
tmux new -As claude
Good for: full shell access, standard tooling, and easy recovery when a specialized interface fails.
Watch for: SSH key handling, host hardening, reachability, and the awkward ergonomics of a terminal UI on a small screen. Prefer a VPN or overlay network over a casually exposed public port.
4. A browser terminal
Tools such as ttyd can expose a terminal through a browser. Put the terminal
behind a private network or authenticated outbound tunnel and test that an
unauthenticated request cannot reach it.
Good for: devices where a browser is easier than an SSH client.
Watch for: this is still remote shell access. Authentication, proxy headers, cookies, origin rules, updates, and session timeouts all become part of the security boundary.
5. Chatcode
Chatcode connects an owned server to a browser terminal and Telegram using an outbound gateway. It can host Claude Code, Codex, Gemini, and OpenCode sessions through the same interface.
Good for: an always-on multi-agent workflow where browser and Telegram access are requirements.
Watch for: the server still needs administration, and Chatcode’s gateway and relay become additional dependencies to trust. SSH remains useful as a separate recovery path.
The step-by-step flow is in Claude Code in Telegram with Chatcode.
Which option fits?
| Need | Start with |
|---|---|
| First-party Claude experience | Remote Control |
| Telegram messages and approvals | Official Channels plugin |
| Full terminal and standard infrastructure | SSH + tmux |
| Terminal in any mobile browser | Browser terminal behind a private tunnel |
| Browser + Telegram across several agents | Chatcode |
Start with the least infrastructure that meets the need. If Remote Control works, there is little value in building a tunnel. If you need an unrestricted shell, a chat bot will feel limiting no matter how polished it is.
Frequently asked questions
Can Claude Code run directly on a phone?
The practical setups run Claude Code on a computer or server and use the phone as a remote interface. The host keeps the repository, tools, credentials, and agent process.
What happens when the host goes to sleep?
The remote session becomes unavailable. Use an always-on host, adjust sleep settings carefully, or accept that a laptop-based workflow only works while the laptop is awake and connected.