Claude Code Mobile: How to Run Anthropic's Agent from iPhone (2026)
Run, monitor, and guide Claude Code directly in your Mac terminal from your pocket.
Anthropic's Claude Code is a powerful agentic coding tool that runs locally in your Mac terminal. However, long-running agent tasks often take minutes to analyze codebases and generate tests. With Macky, you can launch Claude Code sessions, step away from your desk, watch live execution streams, and approve file edits directly from your iPhone.
Key Advantages
Live Terminal Streaming Without Battery Drain
Instead of streaming high-bandwidth desktop video, Macky sends direct terminal data over WebRTC. You get instant character streaming with ANSI colors and minimal power draw on cellular data.
Interactive Approvals from Mobile Keyboard
When Claude Code asks to execute a bash command or write files to disk, you can inspect the diff and tap 'y' directly using mobile-optimized accessory keys (Esc, Tab, Ctrl, Enter).
Full Shell & Screen GUI vs Single-Process Cloud Polling
Unlike native `claude remote-control` which locks you to a single CLI process over cloud polling relays, Macky provides a full Unix PTY shell and Remote Desktop screen mode to verify localhost web apps visually.
Zero Cloud Relay or Key Leaks
Your Anthropic API key, local git repo, and environment secrets stay securely on your Mac. Macky creates an encrypted peer-to-peer tunnel directly to your Mac.
Step-by-Step Implementation
Ensure Claude Code is installed on your Mac
Install Claude Code globally via npm on your Mac and complete the one-time authentication.
npm install -g @anthropic-ai/claude-code && claude --versionStart the Macky Host on Mac
Open Macky on your Mac. It sits quietly in the menu bar and allows authenticated WebRTC connections from your paired iPhone.
Connect from Your iPhone
Open the Macky iOS app, select your Mac, and enter your master password to establish an instant end-to-end encrypted terminal session.
Launch Claude Code in Your Project Directory
Navigate to your workspace and launch the interactive agent.
cd ~/Projects/my-app && claudePrompt and Supervise on the Go
Type your feature prompt, watch Claude generate edits, review proposed changes with git diff, and approve executions directly from your phone.
Quick Command Cheatsheet
Start Claude interactive session
Starts the interactive prompt loop in your current directory.
claudePass direct instruction
Executes a single task autonomously.
claude "Refactor auth middleware to use async/await"Resume existing session in tmux
Keep Claude running even if you disconnect cellular data.
tmux attach -t dev-sessionFrequently Asked Questions
Why use Macky instead of native Claude Code Remote Control (`/rc`)?
Anthropic's `/rc` is restricted to managing a single Claude Code process via cloud polling. With Macky, you get your full Mac terminal (running Docker, Git, tmux, or other AI agents like Codex and Ollama) plus full Remote Desktop screen sharing to test the frontend app on localhost:3000.
Can I use Claude Code when my Mac is on Wi-Fi and my iPhone is on 5G?
Yes. Macky uses WebRTC ICE protocols with automated STUN/TURN traversal. It connects seamlessly across mobile cellular networks without needing port forwarding or a public IP.
Does Claude Code run locally on the Mac or on the iPhone?
Claude Code runs on your Mac using your local Node.js runtime, tools, and repositories. Your iPhone acts as a lightweight remote terminal interface.
Run Your Mac from Anywhere
Download Macky to access your full Mac terminal and desktop from your iPhone.