面向 Codex 和 Claude 的移动客户端，通过 WebSocket 桥接实现手机远程控制编码代理会话。
CC Pocket 是一个跨平台（iOS、Android、macOS）的编码代理远程控制客户端。它在开发主机上部署轻量级 Bridge Server（Node.js/TypeScript），通过 WebSocket 将手机与运行中的 Claude Code 或 Codex CLI 会话连接，使手机成为远程控制台。
核心能力包括：实时流式查看代理计划与工具活动、触控优先的审批 UI 与推送通知、语法高亮 Diff 审查（含图片 diff）、Markdown 提示词编辑器、多会话并行管理与项目分组、Git Worktree 自动隔离、SSH 远程主机管理、mDNS 局域网自动发现与 QR 码快速连接。支持 Claude 四种权限模式（Default/Accept Edits/Plan/Bypass All）和 Codex 多档审批策略，两者均支持沙箱配置。Bridge Server 可注册为 macOS (launchd) 或 Linux (systemd) 后台服务，会话历史与 Claude Code 完全兼容。
安装部署
前置条件：Node.js 18+，主机已安装 Codex CLI 或 Claude Code（需配置 ANTHROPIC_API_KEY，非 OAuth 登录）。
npx @ccpocket/bridge@latest
客户端下载：iOS (App Store)、Android (Google Play)、macOS 桌面 (.dmg，从 GitHub Releases 下载)。
连接方式：扫描终端 QR 码、保存的机器列表、mDNS 自动发现、手动 URL 输入。
关键环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
BRIDGE_PORT | 8765 | WebSocket 端口 |
BRIDGE_HOST | 0.0.0.0 | 绑定地址 |
BRIDGE_API_KEY | 未设置 | 启用 API 密钥认证 |
BRIDGE_ALLOWED_DIRS | $HOME | 允许的项目目录，逗号分隔 |
BRIDGE_DISABLE_MDNS | 未设置 | 禁用 mDNS 自动发现 |
DIFF_IMAGE_AUTO_DISPLAY_KB | 1024 | 图片 diff 自动显示阈值 |
DIFF_IMAGE_MAX_SIZE_MB | 5 | diff 预览最大图片大小 |
Claude 权限模式：Default / Accept Edits / Plan / Bypass All
Codex 审批策略：Untrusted / On Request / On Failure / Never Ask
.gtrconfig（Worktree 配置）：位于项目根目录，支持 [copy]（include/exclude/includeDirs/excludeDirs）和 [hook]（postCreate/preRemove）配置段，用于控制 git worktree 创建时的文件复制规则与生命周期钩子。
架构概览：手机 App ↔ WebSocket ↔ Bridge Server（主机）↔ Claude Agent SDK / Codex CLI。仓库采用 npm workspaces 管理，Bridge Server 为 TypeScript，移动端为 Flutter (Dart 73.1%)，macOS 桌面端为独立原生应用。仓库中存在 Firebase 配置文件（推测用于推送通知）和 .mcp.json 配置。
注意事项：CC Pocket 本身不运行任何 AI 模型，不替代 Claude Code 或 Codex CLI，不隶属于 Anthropic 或 OpenAI。Windows/WSL 支持尚未原生验证。存在 "Supporter / Purchases" 功能但定价细节未在 README 中详述。