How to use Claude Code from your phone, with no API key

Short answer

The problem

Claude Code runs in a terminal on your PC. When you are away from your desk, you may still want to ask it about your notes or your code: what is still open, where a function is used, what a file says.

Your phone can't reach a terminal on your PC by itself, and opening a way into your PC from outside takes setup and care. The steps below don't open your PC, and don't need an API key.

How it works

Questions (with the file you have open) and answers are saved in the plainhub-chat branch of the mailbox repository. Keep your PC on and awake while you ask from your phone.

What you need

Start on your phone? Send the link to your PC

The first setup needs a terminal, so it happens on your PC. If you are on your phone now, open app.plainhub.dev, sign in, then tap AI at the top and Connect your own agent. Tap Send to your PC to send the link to yourself (where your phone can't share, tap Copy link instead). On your PC, sign in to PlainHub with the same GitHub account and open the link: it opens on From your phone, with the same steps as below.

Step 1: Make the mailbox repository

On github.com, create a new repository just for this, for example YOUR_NAME/claude-mailbox:

Step 2: Install and give the agent a token

Once, in a terminal on your PC:

npm i -g plainhub
plainhub auth

plainhub auth opens GitHub's page for a new fine-grained token, with Contents: Read and write already selected. Under Repository access, choose Only select repositories and pick the mailbox repository. Generate the token and paste it in the terminal.

Step 3: Start the agent in your folder

Go to the folder you want to ask about, for example the clone of your notes repository, and start the agent with the mailbox:

cd ~/notes
plainhub agent --mailbox YOUR_NAME/claude-mailbox

Leave this terminal open. The agent answers only while it is running.

Pick the folder with care. Claude Code can read everything in it, so don't use your home folder itself, or a folder with secrets (.env files, keys).

Step 4: Connect from your phone

On your phone, sign in to app.plainhub.dev with the same GitHub account. Tap AI at the top, then Connect your own agent, then From your phone. Enter YOUR_NAME/claude-mailbox and tap Connect.

If you let PlainHub use only some of your repositories, let it use the mailbox repository too: tap Add it on GitHub under the message, select the repository, save, and tap Connect again.

Ask

Open the AI panel and ask in plain words, for example:

What is still open in this folder?

The answer comes from the Claude Code on your PC. Deep questions that read many files can take 20 seconds or more.

Your agent: your Claude Code, anywhere

When it doesn't work

To check everything at once, run plainhub doctor --mailbox YOUR_NAME/claude-mailbox on your PC. It shows what is missing and changes nothing.

The Your agent guide has every step and message.

Try PlainHub without signing in

FAQ

Do I need an API key?
No. Claude Code runs on your PC, signed in with your own Claude account, as it does in your terminal.

Can Claude Code change my files?
Not by default. It only reads the folder you start it in. If you want it to change files and run commands, start the agent with --cockpit in a folder you trust. The panel starts in Plan, which changes nothing, unless your own Claude Code settings make auto the default. In Auto, Claude Code makes the changes and runs the commands it judges safe without asking (commands run on your PC, as you), and sends the rest to your phone to approve. Files can carry instructions that Claude Code may follow, so don't use Auto with someone else's files open. See Cockpit mode.

Does my PC need to stay on?
Yes. Your PC does the work, so keep it on and awake, with the agent running, while you ask.

Where do my questions go?
Questions and answers are stored in the plainhub-chat branch of your private mailbox repository. When Claude Code answers, the parts of your files that it reads are sent to Anthropic.


Sources

Checked: 2026-11-08