← Best Practices

Use Claude Code From Your Phone: View Sessions & Approve Tools on iOS

As a developer, you’ve definitely been in this situation: you’re in the middle of refactoring code or debugging with Claude Code, and suddenly you have to leave your computer—for a meeting, a commute, or just to grab coffee. At that moment, Claude Code might be generating code, waiting for you to approve a tool call, or throwing up a question that needs your confirmation. The traditional approach is either staring at your phone while SSH’d back to the computer, or simply pausing work. But the former is a terrible experience: terminal output crammed onto a tiny screen, and approvals rely entirely on typing commands manually. The best way to connect Claude Code via phone is to use the PandaNpc iOS app to bring the full desktop session stream into your hands, enabling you to view, approve, and answer anytime, anywhere.

Why You Need to Connect Claude Code via Phone

Claude Code’s interaction model is "streaming generation + permission confirmation". Typical tool calls (e.g., reading/writing files, executing commands) require your authorization, while AskUserQuestion cards require you to input an answer before proceeding. If you’re not at your computer, Claude Code either gets stuck or eventually times out and gives up. Worse, you have no idea where it is in the process—is it still generating, or has it been waiting for you for a long time?

PandaNpc’s iOS app (launching June 2026) completely solves this pain point. It uses the pandapaw component (cc-bridge / cc-tty) to "expose" the Claude Code session on your development machine to your phone. You only need to scan a QR code to pair, and then you can see the full session stream on your phone, including permission approval cards for every tool call and every question card. This means you can swipe to approve or reject operations, or even type answers to let Claude Code continue, just as if you were sitting at your computer.

Three Steps to Remote Control Claude Code from Your Phone

Step 1: Deploy the pandapaw Bridge Service on Your Dev Machine

PandaNpc doesn’t replace how Claude Code runs directly; instead, it uses a lightweight bridge layer called pandapaw to forward the standard terminal output to your phone in real time. Depending on your preference, you can choose between two modes:

  • cc-bridge (default mode): Runs in claude -p (stream-json) headless mode, using Claude API / SDK credits, suitable for background automation and long tasks.
  • cc-tty (recommended): Takes over the Claude Code terminal in REPL mode, uses your Max subscription credits without consuming extra API credits, ideal for daily interactive high-frequency use.

Installation is very simple: run a single command on your macOS, Windows, or Linux development machine (see documentation at pandanpc.com), and pandapaw will generate a unique pairing token and QR code. There’s no need to manually configure firewalls or port forwarding—pandapaw connects via a secure WebSocket tunnel, so your phone only needs internet access.

Step 2: Pair by Scanning the QR Code with the iOS App

Open the upcoming PandaNpc iOS app, and the main screen will display a camera icon. Tap it to scan the QR code shown on your dev machine’s terminal. The phone will automatically parse the pairing information and establish a secure connection. No need to manually enter tokens, IP addresses, or keys—the pairing QR code is valid for a short time, and you can regenerate it when it expires.

Once paired successfully, the app immediately pulls the full state of the current Claude Code session: if you were already running a task, your phone will show the recent conversation history and any pending authorization cards.

Step 3: View Sessions, Approve Tools, and Answer Questions on Your Phone

This is the core experience of connecting Claude Code via phone. The app’s session view clearly distinguishes three types of information:

  1. Normal output: Code, explanations, or logs generated by Claude, displayed in a chronological stream that you can scroll back through.
  2. Permission cards: When Claude Code needs to execute a tool (e.g., Read, Bash, Edit), a card pops up on your phone with "Approve / Reject / Modify Parameters" buttons. Tap to authorize without typing any commands.
  3. Question cards: When Claude asks you a question (e.g., "Please confirm the database connection string"), the card shows the full question along with an input field. You type your answer on the phone keyboard and submit it; Claude Code immediately receives the response and continues executing.

Even better, when your phone is locked, Live Activity shows the current status in real time: "Generating", "Waiting for Permission", or "Completed". You can glance at your lock screen to see if Claude Code is waiting for you, without having to unlock your phone and refresh repeatedly.

Notes and Frequently Asked Questions

🔒 Security and Networking

  • pandapaw connections are encrypted by default, but it’s recommended to use only on trusted networks (e.g., home Wi-Fi, company VPN). On public Wi-Fi, you can further secure the connection via relay nodes provided by PandaNpc (optional).
  • The pairing QR code is valid for 2 minutes by default; regenerate it after expiration to prevent interception.

💡 cc-tty Mode vs. cc-bridge

  • cc-tty is suitable for high-frequency use by users who have purchased a Max subscription: it does not consume API credits; all interactions use Claude Code’s Max quota, with lower latency.
  • cc-bridge is suitable for scenarios requiring fine-grained API control (e.g., usage statistics), but it consumes API call volume. Most developers should just use cc-tty.

❓ Troubleshooting Common Issues

  • Can’t connect after scanning the QR code? Check that pandapaw is running on the dev machine and that both phone and dev machine have public network access (or are on the same LAN).
  • Session not syncing? Pull down to refresh in the app to force sync state; if the Claude Code process restarts, you need to re-scan the QR code to pair again.
  • Approval buttons not responding? Ensure your iOS network is normal and the app has background activity permissions (enable background refresh in Settings).

Summary

Connecting Claude Code via phone is no longer a "workaround"—it’s part of your everyday development flow. The PandaNpc iOS app, with the pandapaw bridge and real-time session sync, lets you seamlessly continue coding in any scenario: approve a file write while waiting for the subway, answer a question during a meeting, or even review generated code while lying in bed. All operations are based on the real Claude Code session; no state is faked, and no logic is altered.

When your development task takes you away from your computer, open PandaNpc, scan the code, and Claude Code’s control is right in your pocket.

First published on pandanpc.com