cccodroid

English · 简体中文 · Discord · Discussions · Contributing

A development launcher that runs Claude Code on Android phones. No root, no custom ROM, no chroot / proot / VM.

Android already runs on a Linux kernel. Once the tools run natively on that kernel, a phone can do real AI-assisted development: write code, compile C/C++, run Python / Node, build APKs and push with git — all on the phone.

cccodroid is a third-party project and is not affiliated with Anthropic. It runs the official, unmodified Claude Code: downloaded from Anthropic's official channel at install time (or, when that is unreachable, the identical file Anthropic publishes on npm, via a mirror), verified against the official sha256 manifest, never modified.

Why

When you use AI on a phone and the model needs to actually do something (run code, edit files, build a package), the work usually goes to a cloud sandbox, and the phone is just a screen. cccodroid brings execution back to your own device: the cloud does model inference, while your code, files and toolchain stay local, the environment persists across sessions, and the agent can reach the device itself. The approach is not tied to one agent — any command-line AI agent that runs on Linux arm64 can be brought to a phone the same way.

See Design philosophy.

Features

• Official Claude Code with a GUI: chat, streaming output, thinking, tool calls, file browser, session history.
  • Messages sent while Claude is working wait at the end of the chat marked Queued; Send now delivers one into the running turn without interrupting it. Stop only stops — queued messages are paused, never sent automatically.
  • /compact, /context and other built-in commands show their results immediately.
  • Each reply shows a live generation timer that settles to the total time when it finishes.
  • A quiet top bar: the top right shows a single ⋯; tap it and Files, Terminal, Browser, Command palette and New session slide out, tap again to tuck them away. If the page ever stops scrolling, long-press the title in the top bar to rebuild it.
  • Appearance and fonts: three palettes (Native, Qiusuo and Zhuyue), light or dark or following the system (status bar included); the launch screen, first-run setup screen and in-app browser follow along. Fonts ship with the app, so the phone's system font doesn't change how it looks: Inter with Source Han Sans for the interface, and serif Spectral with Source Han Serif for replies by default. Settings lets you change the interface font, the response font (serif / sans) and the text size (small / medium / large). Code and the terminal use the CC Mono monospace font.
  • Interface motion (from 0.4.11): the sidebar, menus, pages and panels show where they come from and where they go, with a spring feel and matching exits; the sidebar follows your finger when you swipe it open or push it back. Only position and opacity animate, never streaming text or long lists, so older phones stay smooth. Reply text is released at an even pace, so it no longer lurches when a provider sends a big chunk at once. Settings → General → Interface motion: System / On / Off.
  • Your messages sit on the right and replies span the width, as in the desktop app. Tool calls between two pieces of reply text fold into one "N steps" line; tap to see each step. Groups with a pending approval or a failure open by themselves. Under each reply: Copy (the raw Markdown) and Share (system share sheet). Replies render Markdown with tables, task lists, LaTeX math and syntax-highlighted code blocks.
  • Built-in help (sidebar → More → Help): a full user guide and advanced tips, with a table of contents, in Chinese and English. Next to it, Release notes collects every version's notes and is searchable.
  • Tablets in landscape and unfolded foldables: depending on the window width, the layout becomes two columns (chat plus a workspace on the right) or three (plus a docked sidebar). Files, the viewer, the terminal and the in-app browser open on the right without covering the chat, and you can drag the divider between them. Phones in portrait and narrow split screens look the same as before. Foldable layout (experimental): on foldables the columns line up with the fold, the input box moves below the fold when the device stands half-open, and a tri-fold gets one column per panel.
  • Work survives the background: you get a system notification when a turn finishes or Claude is waiting for your approval. It shows no heads-up banner. The notification only offers Deny and Open; to allow a command you have to return to the app and read it in full. If the system kills the app, reopening it marks the unfinished turn as Interrupted with a Continue button, and queued messages are still there.
  • Session management: the Chats page in the sidebar searches message content and filters, and you can pin the chats you use most. Deleted sessions go to a recycle bin first (restorable for 30 days). Pick sessions one by one or all at once and export them as a zip — save it anywhere with the system Save to picker, or share it directly — then import the zip on another device and carry on where you left off.
  • Terminal (top bar): a real terminal with tabs, running the same bash and toolchain Claude uses — hx (Helix), less, top, git and the rest. A row of extra keys supplies what phone keyboards lack (Esc, Tab, sticky Ctrl / Alt, arrows, Home / End, PgUp / PgDn, paste, font size); a text view lets you long-press to select and copy output. Terminals keep running when you close the panel and replay their output when you come back.
  • File viewer / editor (from the file browser): edit text and code and save — if the file changed on disk after you opened it (say Claude edited it), you are asked before anything is overwritten. Markdown renders with an edit toggle; images open fit-to-screen and tap to 1:1; PDFs render with pdf.js (CJK text and password-protected files included), pages drawn only as they scroll into view. Word and Excel files open directly; PowerPoint and legacy .doc files are converted to PDF once the LibreOffice component is installed. .html files show as live pages — CSS, JS and images they reference (in the same folder or a parent folder) load, and the page reloads when the file changes, so a browser game Claude wrote is playable with one tap. The top-right button is Share, which hands the file to the system share sheet.
  • DevTools (from 0.4.14): HTML previews and the in-app browser can open the bundled Eruda — elements, console, network, storage — offline. With it on, Pick element puts the selector and a short HTML snippet of whatever you tap into the message box, so you can tell Claude what to change.
  • Writing in Markdown: while you edit, math and code blocks are typeset in place and show their source only when the cursor is on them; the word count keeps up as you type, and unsaved drafts are kept automatically. Manuscripts of millions of characters open and edit fine (up to 16 MB), with the preview laying out only what's near the screen, so scrolling stays smooth.
  • Git panel (from the file browser or the editor): see changes, history and line-by-line diffs, tick files and write a message to commit, and also discard changes, switch or create branches, pull and push.
  • Switch right under the input box: model, thinking effort and permission mode. On a new chat's start screen you can pick the project and model before you say anything.
  • /goal <condition> keeps Claude going turn after turn until the condition is met, with checks and elapsed time shown above the input box. On a Claude account or API key, a long session left idle for almost an hour is compacted first, so picking it up again uses less quota or money. Drag the compaction line on the provider and model page to choose where compaction starts.
  • Rewind to here: every message you sent can be rewound — undo only the files Claude changed since, or cut the chat back to that point in a new session and ask again. Any reply can also be forked into a new session, leaving the original alone. When Claude works through a long job, its task list sits above the input box, and subagents get a card of their own: one row each with status and current step, a log of who messaged whom and why, and their briefs and reports saved as files in the project. Background commands are listed there too; when there are several they fold into one line