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 Store iOS · App Store
iPhone & iPad iPhone 与 iPad

Scan to download 扫码下载

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

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 在电脑上安装守护进程

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

Apple Silicon & Intel — signed & notarized, checksum-verified, installs under ~/.local and registers the launchd service. Prefer Homebrew? brew install --cask heypandax/tap/cc-pocket Apple 芯片与 Intel 通用——已签名公证、下载校验，装到 ~/.local 并注册 launchd 服务。偏好 Homebrew？brew install --cask heypandax/tap/cc-pocket

$`cc-pocket-daemon update`

The daemon updates itself (it also checks daily and notifies your phone). Homebrew installs: brew upgrade --cask heypandax/tap/cc-pocket 守护进程自我更新（每天自查并推送手机提醒）。Homebrew 安装的用 brew upgrade --cask heypandax/tap/cc-pocket

$`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 服务。

$`cc-pocket-daemon update`

The daemon updates itself (it also checks daily and notifies your phone). Re-running the install one-liner works too.守护进程自我更新（每天自查并推送手机提醒）。重跑安装命令也等效。

>`irm https://raw.githubusercontent.com/heypandax/cc-pocket/main/scripts/install.ps1 | iex`

x86_64. Needs the Claude Code CLI. One command: installs, registers the background service, and opens pairing right away. Prefer Scoop? scoop bucket add heypandax https://github.com/heypandax/scoop-bucket; scoop install cc-pocket-daemon x86_64。需已装 Claude Code CLI。一条命令：安装、注册后台服务并直接进入配对。偏好 Scoop？scoop bucket add heypandax https://github.com/heypandax/scoop-bucket; scoop install cc-pocket-daemon

>`cc-pocket-daemon update`

The daemon updates itself (it also checks daily and notifies your phone). Re-running the install one-liner works too; Scoop installs: scoop update cc-pocket-daemon 守护进程自我更新（每天自查并推送手机提醒）。重跑安装命令也等效；Scoop 安装的用 scoop update cc-pocket-daemon

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.
kotlin copy

    @Test fun reassembles() {
      val ev = parse(chunks)
      assertEquals(2, ev.size)
    }

Bash gradle :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-pocket 3 sessions
~/proj/app/cc-dashboard 8 sessions
~/work/api-server 1 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 Multiplatform Compose 跨平台
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 加星