Download下载 Features特性 How it works工作原理 Security安全 View on GitHub →

Drive Claude Code from your phone. 在手机上操控你的 Claude Code。

Drive Claude Code — or OpenAI Codex. Resume sessions, stream the output, and approve the agent's tool permissions remotely — from anywhere, end-to-end encrypted. 操控 Claude Code——或 OpenAI Codex。恢复会话、看流式输出、远程批准智能体的工具授权——从任何地方，端到端加密。

View on GitHub在 GitHub 查看 How it works工作原理

MIT·open source·zero-knowledge relay·no account

Fix relay reconnect default
Lidapeng-MacBook · ~/proj/app/cc-pocket
The reconnect loop dies after the 3rd retry — the scope owning the timer is cancelled when the socket closes.
Bash gradle :relay:test 9s
kotlincopy
fun reconnect() {
  scope.launch {
    delay(backoff)
    open()        // guarded
  }
}
Guard added — reconnect now survives scope cancellation.
+
Message Claude…
Claude needs permission
Run command · Bash
rm -rf ./build && ./gradlew clean

Get started开始使用

Get the app, then connect.装上 App，连接电脑。

On a phone? Tap to install. On a computer? Scan the QR with your phone's camera. 用手机？点一下直接安装。用电脑？打开手机相机扫码即可。

iOS · App StoreiOS · App Store
iPhone & iPadiPhone 与 iPad

Scan to download扫码下载

Download on the App Store前往 App Store 下载
Android · APKAndroid · APK
Install package on GitHubGitHub 安装包

Scan to download扫码下载

Download APK on GitHub前往 GitHub 下载 APK

Prefer the desktop app? Get it for macOS (.dmg) (Apple Silicon · signed) or Windows (.msi) — drive one computer from another. 想用桌面端？下载 macOS（.dmg）（Apple 芯片 · 已签名）或 Windows（.msi） 版——用一台电脑操控另一台。

Then connect your computer — three commands然后连接电脑——三条命令

1

Install the daemon on your computer在电脑上安装守护进程

$brew install --cask heypandax/tap/cc-pocket

Apple Silicon & Intel — Homebrew picks the right signed build.Apple 芯片与 Intel 通用——Homebrew 自动选对应的签名构建。

$brew upgrade --cask heypandax/tap/cc-pocket

Homebrew reinstalls & restarts the daemon onto the new build — no reboot needed.Homebrew 自动重装并把守护进程切到新版本——无需重启电脑。

$curl -fsSL https://raw.githubusercontent.com/heypandax/cc-pocket/main/scripts/install.sh | bash

x86_64. Installs under ~/.local + a systemd --user service.x86_64。装到 ~/.local 下，并注册 systemd --user 服务。

$curl -fsSL https://raw.githubusercontent.com/heypandax/cc-pocket/main/scripts/install.sh | bash

Same one-liner — re-run it. The installer restarts the service onto the new binary for you.同一条命令，重跑一遍即可——安装脚本会自动把服务重启到新版本。

>scoop bucket add heypandax https://github.com/heypandax/scoop-bucket; scoop install cc-pocket-daemon

x86_64. Needs Scoop + the Claude Code CLI. Lands on PATH and runs in the background — then just cc-pocket-daemon pair.x86_64。需先有 Scoop 和 Claude Code CLI。装好即进 PATH 并后台运行 —— 然后 cc-pocket-daemon pair 配对。

>scoop update cc-pocket-daemon

Updates to the newest release; the daemon restarts onto it.更新到最新版本，守护进程会重启到新版本。

2

Pair your phone配对你的手机

$cc-pocket-daemon pair

Prints a QR + a 6-digit code in your terminal.在终端里打印一个二维码和 6 位配对码。

3

Open the app, scan the QR打开 App，扫码

…or type the 6-digit code. You're connected end-to-end.……或输入那 6 位码。你已端到端连接。

Requires an installed, logged-in claude CLI.需要电脑上已安装并登录的 claude CLI。

You stepped away. Claude is blocked on a permission prompt. 你离开了工位，Claude 正卡在一个授权弹窗上。
Approve it from your pocket in two taps. 在口袋里两下点掉它。

Claude needs permission
Edit file
src/relay/WsClient.kt

Features核心特性

Four jobs, done from your pocket.四件事，口袋里搞定。

01

Approve from anywhere随处批准

Tool-permission requests reach your phone the moment Claude raises one. Allow or deny in seconds — and if you don't, it times out to a safe deny.Claude 一发起工具授权请求，就推到你手机上。几秒内允许或拒绝——若不处理，超时后自动安全拒绝。

auto-deny on timeout
Chat
~/proj/app/cc-pocket · ⑂ main
Claude needs permission
Run command · Bash
rm -rf ./build && ./gradlew clean
0:18 ⑂ main
02

Pick up any session接起任何会话

Resume the exact Claude session you left running on your computer — or start a fresh one in any repo.恢复你电脑上正跑着的那个 Claude 会话——或在任意仓库里新开一个。

💬 12 · ⑂ main · 2h ago
Sessions
Lidapeng-MacBook · ⑂ main
+
New session
~/proj/app/cc-pocket
Refactor auth module
add a unit test for the stream parser
💬 12 · ⑂ main · 2h ago
Fix stream parser test
the parser drops the last token on EOF
💬 6 · ⑂ fix/parser · 5h ago
Add relay websocket client
scaffold the Ktor WS client with reconnect
💬 23 · ⑂ feat/relay · yesterday
03

Watch it think, live实时看它思考

Real-time streaming output, code blocks and tool events — follow along on the go, exactly as it renders in the terminal.实时流式输出、代码块、工具事件——在路上也能跟上，和终端里渲染的一模一样。

↑1.2k ↓340
Refactor auth module
~/proj/app/cc-pocket · sonnet-4.5
add a unit test for the stream parser
I'll add a focused test that feeds a chunked SSE response and asserts the reassembled events.
kotlincopy
@Test fun reassembles() {
  val ev = parse(chunks)
  assertEquals(2, ev.size)
}
Bashgradle :protocol:test
Running the suite to confirm the new test fails first
↑1.2k ↓340
04

Switch the working directory随时切目录

Point Claude at any repo on your computer, mid-conversation — recents, a live breadcrumb, and per-project session counts.对话中途就能把 Claude 指向电脑上任意仓库——最近项目、实时面包屑、每个项目的会话数。

~/proj/app · 3 sessions
Choose a directory
Lidapeng-MacBook
Recents
~/proj/app/cc-pocket3 sessions
~/proj/app/cc-dashboard8 sessions
~/work/api-server1 session
~ / proj / app
analyse
nanobanana

More capabilities更多能力

And a lot more in your pocket.口袋里还有更多。

The four above are the headline — here's the rest of what ships in the app. It now also runs as a desktop app (macOS · Linux · Windows) to drive one computer from another.上面四件事是主线，下面是 app 里其余的能力。它现在也以桌面 App（macOS · Linux · Windows）的形式运行，让你用一台电脑操控另一台。

Control & permissions掌控与授权

Four execution modes, a persisted default mode, reasoning effort, and per-session allow rules.四档执行模式、可持久化默认模式、推理强度、本会话授权记忆。

See what it's doing实时可见

Live streaming, tool events, extended thinking, background tasks, and context usage.实时流式、工具事件、扩展思考、后台任务、上下文用量。

Sessions & projects会话与项目

Pick Claude or Codex per session, resume any session, a tree project browser, filtering, and desktop handoff.每个会话选 Claude 或 Codex、接起任意会话、树状项目浏览、筛选、桌面接力。

Ways to talk to it多种输入

Voice dictation, image attachments, slash commands, and model switching.语音听写、图片附件、斜杠命令、切换模型。

Stay in the loop随时掌握

Finish notifications, a resilient reconnect, off-LAN access, and multi-device pairing.完成推送、稳定重连、异地可用、多设备配对。

Private by design隐私即设计

End-to-end encryption, a zero-knowledge relay, no accounts, and open source.端到端加密、零知识中继、免账号、开源。

See everything it does →查看全部能力 →

How it works工作原理

A zero-knowledge bridge, phone to computer.从手机到电脑的零知识桥接。

phone · desktop
Compose MultiplatformCompose 跨平台
wss · ciphertext →E2E encrypted
relay
zero-knowledge broker零知识中继
wss · ciphertext →opaque frames
daemon
your computer你的电脑
stdio →local
claude / codex
CLI on your machine本机 CLI

The relay only forwards opaque encrypted frames. Plaintext never leaves your phone and your computer. 中继只转发不透明的加密帧。明文永远不离开你的手机和你的电脑。

Security安全

The relay can't read a thing.中继什么也读不到。

Zero-knowledge relay零知识中继

Forwards ciphertext only; holds no message content and no private keys.只转发密文；不保存任何消息内容，也不持有私钥。

End-to-end encrypted端到端加密

P-256 ECDH + HKDF + AES-256-GCM, an X3DH/Noise-style handshake; plaintext stays on your two trusted endpoints.P-256 ECDH + HKDF + AES-256-GCM，X3DH/Noise 式握手；明文只留在你的两个可信端点。

No accounts, no login无账号、免登录

Pair by scanning a QR or typing a 6-digit code; the daemon's key travels out-of-band so even a malicious relay can't MITM.扫码或输入 6 位配对码即可；守护进程的密钥经带外传递，即便恶意中继也无法中间人攻击。

Open & self-hostable开源可自托管

Clean-room Kotlin, MIT, zero content logging; run your own relay.纯净室 Kotlin，MIT 许可，零内容日志；可自建中继。

Trust without trusting us.信任，但不必信任我们。
Read the full threat model →阅读完整威胁模型 →

Free and open source. MIT licensed. Clean-room Kotlin. Android · iOS · desktop, one Compose Multiplatform codebase. 自由开源，MIT 许可，纯净室 Kotlin 实现。Android · iOS · 桌面，同一套 Compose Multiplatform 代码。

Star on GitHub在 GitHub 加星