← All WorkflowsLast updated: September 2026 • macOS 15+ & iOS 18+

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.

Introduction

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

01

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.

02

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

03

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.

04

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

01

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 --version
02

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

03

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.

04

Launch Claude Code in Your Project Directory

Navigate to your workspace and launch the interactive agent.

cd ~/Projects/my-app && claude
05

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

claude

Pass 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-session

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