Claude Code on Android: Official Options and Termux Routes
November 18, 2026

You can use Claude Code on Android today, but Anthropic doesn't ship a version that runs on the phone itself. The supported way is to use your phone as a remote for a session running somewhere else: in Anthropic's cloud, or on your own computer. Running the CLI directly on the device, through Termux, is a community workaround that has been broken or fragile since April 2026.
Here's the short version:
- Officially supported: the Claude app for Android, which reaches cloud sessions, Remote Control, and Dispatch.
- Unofficial, on-device: Termux with a compatibility layer, Ubuntu inside Termux via proot-distro, or Android's Linux VM on a few Pixels.
- Unofficial but low-risk: SSH from your phone into a machine where Claude Code is properly installed.
If you only want to check on a task from the couch, stop at the official options. The rest is for people who want the agent's process on the phone and accept that it can break with any update.
Quick comparison
| Route | Where Claude Code runs | Supported by Anthropic? | Main catch |
|---|---|---|---|
| Claude app: cloud sessions | Anthropic's cloud | Yes | Repository needs to be on GitHub |
| Claude app: Remote Control | Your computer | Yes | Computer must stay on |
| Claude app: Dispatch | Your computer (Desktop app) | Yes | Limited to certain plans |
| SSH from the phone | Your computer or server | The install is; the phone is only a terminal | You manage the network path |
| proot-distro Ubuntu in Termux | The phone | No | Slow, heavy, about 2 GB by the community guide's estimate |
| Native Termux with glibc layer | The phone | No | Depends on a third-party launcher and patches |
| Android's Linux VM | The phone | No | Only on certain devices, experimental |
What Anthropic officially supports on Android
Start with the system requirements. The CLI's supported platforms are macOS, Windows, Ubuntu, Debian, and Alpine Linux, on x64 or ARM64 hardware. Android isn't on the list. The install troubleshooting page is blunter: prebuilt binaries exist for macOS, Linux (glibc and musl), and Windows, and Claude Code does not ship a binary for other platforms.
What Anthropic does support on Android is the Claude app. Its mobile docs describe the app as "a client for Claude Code sessions rather than a place where code runs." There's no separate Claude Code mobile app. You open the Code tab in the regular Claude app, signed in with the same claude.ai account you use for Claude Code.
From there you get three ways to work.
Cloud sessions: nothing running on your own hardware
A cloud session runs on infrastructure Anthropic manages. You pick a repository and branch in the Code tab, describe the task, and submit it. The session keeps going after you put the phone away, and it's there on your laptop later.
The requirements: your repository is on GitHub, and you're on a plan that includes cloud sessions. Our guide to Claude Code on the web covers the GitHub connection and environment setup.
Remote Control: your computer does the work
Remote Control connects the Claude app to a Claude Code session running on your own machine. Code execution and file access stay local, and the phone is a window into that session. You start it on the computer with claude remote-control, or /remote-control inside an open session, then pick the session in the app or scan the QR code.
Two things to know before you rely on it:
- Your computer has to stay on with the
claudeprocess running. - It needs a claude.ai subscription. Anthropic's docs say API keys aren't supported, and neither are third-party providers such as Amazon Bedrock.
The full walkthrough is in Claude Code Remote Control.
Dispatch: message a task to the Desktop app
Dispatch lets you message a task from the Claude app and have the Desktop app on your computer run it. Anthropic lists it for Pro, Max, and Ultra plans, and not for Team or Enterprise.
What the Android app can't do
Anthropic's docs list a few limits:
- Commands that only exist in the terminal interface, such as
/pluginand/resume, don't work from the app. - You can't select the Bypass permissions mode from the app.
- If the Code tab is missing, your plan or organization may not include these features.
Why Claude Code doesn't just install in Termux
Termux is a terminal emulator and Linux environment app for Android. It looks like the obvious place to run a CLI, and for a while it worked: you installed Node.js, installed the npm package, and ran claude.
That changed in April 2026. The open GitHub issue anthropics/claude-code #50270 reports that starting with v2.1.113, Claude Code switched from a JavaScript entry point to a native Linux binary, and that this broke Termux. Anthropic's setup docs confirm the packaging side: the npm package now installs the same native binary as the standalone installer, pulled in as a per-platform dependency, and Android isn't among the supported npm platforms.
The underlying problem is the C library.
- Desktop Linux uses glibc (or musl on Alpine). Anthropic publishes binaries for both.
- Android uses Bionic, its own C library. A binary linked against glibc can't run directly in Termux.
The issue carries Anthropic's platform:android and regression labels and was still open when we checked on November 18, 2026. A separate request to publish an Android build was closed as a duplicate. So the bug is tracked, and it isn't resolved.
One note on Termux itself: its README recommends the F-Droid or GitHub builds. It describes the Google Play build as an experimental branch with missing functionality.
Unofficial routes for running Claude Code in Termux
Everything in this section is unsupported. Anthropic's docs don't describe any of it, and an update on either side can break it. We describe each approach and link the source; follow the source's current instructions, not a copy of them.
Ubuntu inside Termux with proot-distro
proot-distro is a Termux project that runs a full Linux userland, such as Ubuntu, on top of Termux without root. Its README gives the basic flow:
pkg install proot-distro
proot-distro install ubuntu:24.04
proot-distro login ubuntu
Inside that Ubuntu shell you have real glibc, so Anthropic's standard Linux installer can run there. This is the route to try first if you want the CLI on the phone, because nothing about Claude Code itself is patched. Our Claude Code install guide covers the Linux install and how to verify it.
It is not the same as a supported Ubuntu machine, though. The proot-distro README lists the limits:
- Performance. proot intercepts every system call, so filesystem-heavy work such as package installs and compilation is noticeably slower.
- No background services. Service managers like systemd generally don't work.
- No real root, no kernel namespaces, no nesting. Tools that need them will fail.
A community guide puts the disk cost of this route at roughly 2 GB.
Native Termux with a glibc compatibility layer
The second approach keeps you in plain Termux and adapts Anthropic's Linux ARM64 binary to run there. The best-documented example is the community repo claude-code-android, which calls this "Path A." Its docs say it runs the official binary through Termux's glibc-runner layer and installs its own launcher to fetch and patch new versions.
The repo is open about the trade-offs, and they're worth reading before you run someone's install script on a phone that holds your photos and accounts:
- You trust a third-party launcher to download and patch each new Claude Code release. The repo says plainly this is a community workaround, not an official Android build.
- It changes DNS for Claude Code to Google's resolvers by default, to avoid a known connection hang.
- Older phones fall back to a pinned v2.1.112, the last JavaScript-based release, which never updates.
- 32-bit devices won't work at all.
Things also break in less obvious ways. One report on Anthropic's tracker describes grep calls inside Claude Code failing on a loader-launched Termux install, with an exit code that scripts read as no match. That's the kind of quiet failure you take on with this route.
Android's Linux VM on some Pixels
The same repo documents a third path: Android's built-in Linux development environment, a Debian virtual machine exposed under Developer options on some devices. Because it's a real Linux VM, Anthropic's installer runs inside it without Termux. The repo marks this as experimental and has only tested it on a couple of Pixel models, so treat it as something to try, not something to plan around.
What tends to stop working
| Area | What to expect on unofficial routes |
|---|---|
| Updates | Anthropic's native installs update themselves in the background. A patched or pinned install depends on its own launcher, or stays on an old version. |
| Speed | proot adds overhead to every file operation. |
| Bundled tools | Shims that assume a normal binary path can misbehave, as the grep report shows. |
| Support | Bug reports from Termux land in a long-running open issue, not a supported platform queue. |
| Security | Anything Termux can reach, the agent can reach. Grant storage and other permissions only when a task needs them. |
SSH and Tailscale: the phone as a terminal
There's a middle path that gives you the real CLI without running it on Android: install Claude Code on a Mac, Linux box, or cloud server, and connect to it from the phone over SSH. Anthropic's own platform comparison lists remote servers as one of the things the CLI is best for, and the install on that machine is a fully supported one.
You need three pieces:
- An SSH server on the machine that has Claude Code.
- An SSH client on the phone. Termux packages OpenSSH, and there are standalone Android SSH apps.
- A network path between them. On the same Wi-Fi this is trivial. Away from home, a private network tool such as Tailscale, which has an Android app, is one common way to connect the two.
Running claude inside a terminal multiplexer such as tmux on the remote machine keeps the session alive when your phone's connection drops.
How does this compare with Remote Control? Remote Control needs no network setup, because the local session only makes outbound HTTPS requests, and you get the app's interface and push notifications. SSH gives you the full terminal UI, every slash command, and works with an API key or a third-party provider, which Remote Control doesn't.
Claude Code on Android: which route to pick
- Your repo is on GitHub and the task can run unattended: cloud session from the Claude app.
- The work needs your local files, tools, or MCP servers: Remote Control.
- You want the full terminal, or you use an API key: SSH into your own machine.
- You have no other computer and want it on the phone anyway: proot-distro Ubuntu first, then the native Termux route if you accept the trust trade-off.
- You want a model running on the phone itself, offline: that's a different project. See how to run an LLM locally on Android. Claude Code always needs an internet connection.
If you'd rather not set any of this up
A coding agent on a phone takes real setup, and plenty of people would rather run something that already works once they're back at their desk. That's where Taku comes in. Taku Apps and Sites, built by the best AI minds. Find one, run it, and keep it in your Mac Dock. Taku is in Beta, and the Mac app is available now.
Key points
- Anthropic's supported platforms for the Claude Code CLI don't include Android.
- The Claude app for Android is the official route: cloud sessions, Remote Control, and Dispatch, all from the Code tab.
- Claude Code in Termux broke at v2.1.113 when the CLI moved to a native glibc binary, and the tracking issue is still open.
- proot-distro Ubuntu, a glibc compatibility layer, and Android's Linux VM all work for some people, and none is supported.
- SSH into a machine with a normal install is the most dependable way to get the full CLI on a phone screen.
FAQ
Can you run Claude Code on Android?
You can use it from Android through the Claude app, which controls sessions running in the cloud or on your computer. Running the CLI on the phone itself isn't supported by Anthropic and needs a community workaround.
Does Claude Code work in Termux?
Not with a plain npm install on current versions. An open GitHub issue reports that releases from v2.1.113 onward ship a native Linux binary that Termux can't run directly. Workarounds exist, including Ubuntu via proot-distro and community patches.
Is there a Claude Code app for Android?
There's no separate app. Claude Code features live in the Code tab of the regular Claude app for Android.
Can I use Claude Code on my phone without a computer?
Yes, with cloud sessions. They run on Anthropic's infrastructure, so you only need the Claude app, a qualifying plan, and a repository on GitHub.
Is it safe to run a community Claude Code installer on my phone?
Read the script and the project's security notes first. An agent in Termux can reach whatever Termux can reach, and a third-party launcher is one more thing you have to trust.
Does Remote Control work with an API key?
No. Anthropic's docs say Remote Control needs a claude.ai subscription and doesn't support API keys. SSH into your own machine is the alternative.