Getting Started

Prerequisites

• macOS 13 (Ventura) or later
• iPhone running iOS 16 or later
• Claude Code installed on your Mac — npm i -g @anthropic-ai/claude-code

That's it. No VPS, no SSH keys, no API key, no account creation.

Step 1 — Download & open the Mac app

Download the Claudaway Mac app from the download page. Drag it to your Applications folder, then open it. Claudaway lives in your menu bar — look for the icon in the top-right of your screen.

Click the menu bar icon. A floating window opens with a QR code:

  ✓ Server running
  ✓ Encrypted tunnel active
  ✓ QR code ready

  [QR CODE]

  Scan with the Claudaway iOS app

  Waiting for connection...

The Mac app automatically starts a local server, creates an encrypted Cloudflare tunnel, and generates the pairing QR code — all with one click.

Step 2 — Install the iOS app

Download Claudaway from the App Store on your iPhone. Open it — no account needed.

Step 3 — Scan the QR code

Tap Scan QR Code in the iOS app and point your camera at the QR code on your Mac screen. The devices exchange encryption keys and connect instantly.

You only need to scan once. After the first pairing, your iPhone remembers the connection and reconnects automatically.

Step 4 — Start coding

You're connected. Type a prompt, tap the mic to dictate, or use the quick-action buttons. Claude Code runs on your Mac — you see everything on your phone in real-time.

You › Build a REST API with Express and JWT auth

Claude › I'll create the Express API with JWT authentication.
  Creating src/index.ts ...
  Creating src/middleware/auth.ts ...
  Creating src/routes/users.ts ...

[Accept] [Reject]

Tips

• The Mac app starts automatically on login (configurable in Preferences)
• Pairing persists across restarts — you only scan the QR once
• Your phone reconnects automatically if the connection drops
• Use the Preferences window to change your default workspace directory
• The tunnel URL changes each time the app restarts, but your phone handles this automatically

Gatekeeper note (first launch)

Since the app is distributed outside the Mac App Store, macOS may block it on first launch. To open it:

1. Right-click (or Control-click) the Claudaway app in Applications
2. Click Open
3. Click Open again in the confirmation dialog

You only need to do this once.

What's next?

Having issues? Check the troubleshooting guide. Want to understand the architecture? See how it works.