Skip to content

How to Run Claude Code on Your Phone

Tap the shortcut, sign in with your Claude plan, and Claude Code runs in a cloud terminal.

Updated 5 min read Cosyra team

Cosyra Terminals screen with Claude Code first in the Your shortcuts row
Claude Code welcome screen in a Cosyra terminal on a phone
Claude Code Select login method screen on a phone, with Claude account with subscription selected

Claude Code runs on your phone through Cosyra for iPhone or Cosyra for Android. Cosyra gives the phone a cloud Linux workspace with Claude Code already installed. You tap the Claude Code shortcut, sign in once with your Claude account, and work in a real terminal.

The steps and screenshots below are from the Cosyra 2.8.5 iPhone app with Claude Code 2.1, taken in October 2026. The flow is the same on Android.

What you need

Set up Claude Code on a mobile device

Step 1

Install Cosyra and open Terminals

Install the app and sign in. It opens on Terminals. The row at the top is Your shortcuts, and Claude Code is the first one.

The chip next to the title shows your workspace. It reads Sleeping until you open a terminal, then Awake.

Cosyra Terminals screen: workspace status, the Your shortcuts row with Claude Code, Codex and Gemini CLI, and the Projects list

Step 2

Tap the Claude Code shortcut

Tap Claude Code. The workspace wakes up and a terminal opens with Claude Code in it.

Cosyra shows a sheet called Connect Claude Code. Tap Connect Claude subscription to sign in from the sheet, or close it and sign in inside the terminal. Both end in the same place. The next steps show the terminal route.

Claude Code first asks for a text style. Press return to keep Auto.

Claude Code welcome screen asking for a text style, in a Cosyra terminal

Step 3

Choose how you sign in

Claude Code lists three login methods:

  • Claude account with subscription, for Pro, Max, Team or Enterprise.
  • Anthropic Console account, billed by API usage.
  • 3rd-party platform, for Amazon Bedrock, Microsoft Foundry or Vertex AI.

Move with the arrow keys in the toolbar above the keyboard and press return.

Claude Code Select login method: Claude account with subscription, Anthropic Console account, or 3rd-party platform

Step 4

Claude Code prints a sign-in link and waits at Paste code here if prompted. Tap the link. It opens in your phone's browser.

Claude Code showing a sign-in URL and a Paste code here if prompted line in the terminal

Step 5

Sign in and paste the code

Sign in on Claude's page with the account that has your plan and approve the request. Claude shows a code.

Copy the code, switch back to Cosyra, paste it at the prompt and press return. Claude Code confirms the login and opens its prompt.

Claude log in page in mobile Safari, opened from the Claude Code sign-in link

Step 6

Give Claude Code a task

Claude Code works in the folder the terminal is in. To work on a repository, clone it first, or go back to Terminals, tap New and choose Open folder.

git clone https://github.com/you/your-repo.git
cd your-repo
claude

Then type what you want in plain words, for example "find why the login test fails and fix it".

Using Claude Code from a phone keyboard

Claude Code leans on keys a phone keyboard does not have. Cosyra adds a toolbar above the keyboard with Esc, Tab, Ctrl, Alt and the arrow keys, plus a microphone for dictation. The docs list every toolbar key.

Long tasks keep running

The terminal lives in the workspace, not in the app. Start a refactor, lock the phone and it carries on. When you open Cosyra again the same session is on screen, with everything Claude did while you were away.

The same workspace opens from any device you sign in on, so a session you start on the phone is there on a tablet too.

Questions

Can you run Claude Code on a phone?

Yes. Claude Code is a command-line tool, so it needs a terminal and a Linux or macOS environment. Cosyra gives your phone a cloud Linux workspace with Claude Code already installed. You tap the Claude Code shortcut and it opens in a terminal.

Which Claude plan do I need?

Claude Code signs in with a Claude Pro, Max, Team or Enterprise plan. You can also sign in with an Anthropic Console account and pay for API usage, or use Amazon Bedrock, Microsoft Foundry or Vertex AI.

Does Claude Code work the same on iPhone and Android?

Yes. Claude Code runs in the cloud workspace, not on the phone. The shortcut, the terminal and your sessions are the same in the iOS and Android apps.

Does Claude Code keep working when I lock my phone?

Yes. The terminal runs in your workspace, so a long task carries on while the phone is locked or you are in another app. Open Cosyra again and the session is still there.

Do I have to sign in every time?

No. The sign-in is stored in your workspace. New terminals start Claude Code already signed in.

What does it cost?

Cosyra is a subscription: Core is $20 a month and Pro is $30 a month. Eligible new users can start a 7-day free trial in the App Store app. Claude usage is separate and comes from your Claude plan or your Anthropic API account.