Skip to content
Recaply.
Sign inSubmit a tool

LearnTutorials

Claude CodeTutorialsOpen Claude Code

Run Claude Code from your phone with Remote Control

Start a Claude Code task on your computer, then watch, steer and approve it from your phone or any browser with Remote Control, in under 15 minutes.

By Recaply EditorsIntermediate13 min5 stepsUpdated

A hand holds a phone joined by a long cord to an open laptop on a small table

What you need

On Team and Enterprise plans, an Owner must first turn on Remote Control in the Claude Code admin settings. It doesn't work through Amazon Bedrock, Google Cloud or Microsoft Foundry.

  1. Step 1: Update Claude Code and sign in

    2 min

    Remote Control needs a recent version and a claude.ai login, not an API key.

    1. In a terminal, run the command below to get the newest version.
    2. Installed with Homebrew? Run brew upgrade claude-code instead.
    3. If you're not signed in with your plan, run claude auth login and choose the claude.ai option.
    4. On your phone, install the Claude app and sign in with the same account.
    Run this
    claude update

    You should see a line saying Claude Code is up to date, or that it updated to a new version.

    It says Remote Control requires a claude.ai subscription?

    An API key or token is taking over from your login. Remove ANTHROPIC_API_KEY from your shell or settings file, then run claude auth login again.

    Keep API keys out of settings files you share or commit, such as .claude/settings.json.

  2. Step 2: Start Remote Control in your project

    2 min

    This opens a normal Claude Code session that you can also reach from other devices.

    1. Move into your project folder with cd.
    2. Run the command below, with a name you'll recognize on your phone.
    3. If Claude Code asks you to enable Remote Control, say yes.
    Run this
    claude --remote-control "[YOUR PROJECT NAME]"

    You should see an /rc active indicator in the terminal, linked to your session on claude.ai.

    It says Remote Control is disabled by your organization's policy?

    On Team or Enterprise, ask an Owner to turn on the Remote Control toggle in the admin settings. On Pro or Max, run claude auth logout, then claude auth login, to drop an old work login.

    Your code runs on your computer the whole time. The phone and browser are only a window into it, so leave the computer on.

  3. Step 3: Open the session on your phone

    2 min

    Each device shows the same conversation, so you can switch between them at any point.

    1. In the terminal, run /remote-control again to show the session link and a QR code.
    2. Scan the QR code with your phone's camera to open the session in the Claude app.
    3. Or open the link in any browser, or tap Code in the Claude app and pick the session by name.

    You should see your session with a computer icon and a green dot, showing the same messages as your terminal.

    The app shows Remote Control disconnected?

    Check that your computer is awake and online and that claude is still running. The session reconnects on its own, or run /remote-control in the terminal.

  4. Step 4: Hand off a task from your phone

    4 min

    Once a task is running, you can follow it, answer questions and approve changes away from your desk.

    1. In the Claude app, type a task like the one below and send it.
    2. Answer permission prompts as they arrive. They stay open until you reply.
    3. Attach a screenshot or file if it helps. Claude gets it on your computer.
    4. To switch models, send a command with its value, such as /model sonnet.
    Your prompt
    Fix the failing test in [FILE OR FOLDER]. Run the tests after each change and stop when they pass. Ask me before you change anything outside that folder.

    You should see Claude's steps arriving on your phone as it works, and the same messages in your terminal.

    A command like /plugin does nothing from your phone?

    Some commands only run in the terminal, such as /plugin and /resume. Text commands like /compact, /context and /usage work from the phone.

  5. Step 5: Turn on pushes and auto-connect

    3 min

    Pushes tell you when Claude needs you, so you don't have to keep checking the app.

    1. In the terminal, run /config and turn on Push when actions required.
    2. In the same panel, set Enable Remote Control for all sessions to true.
    3. Allow notifications when your phone asks.

    You should see a push the next time Claude needs a decision, and new sessions that show up in the app on their own.

    The config panel shows No mobile registered?

    Open the Claude app on your phone so it can refresh its push token. The warning clears the next time Remote Control connects.

    To get a push when a long job ends, ask for it in your prompt, such as "notify me when the tests finish".

You get

A Claude Code session on your own computer that you can watch, steer and approve from your phone or any browser

Try next

Install an agent skill in any AI coding agent6 steps · 5 minTrack and cap team AI spend in Claude, Copilot and OpenAI6 steps · 44 minInstall agent skills in Claude Code6 steps · 5 min

Did this guide work for you?

Sources

0 of 5Next: Update Claude Code and sign in