1. 项目定位与用途
CC Pocket 是一款移动客户端应用，定位为 AI 编码代理的远程控制中心。它允许用户通过智能手机完全启动、监控和管理运行在远程主机（如 Mac mini、Linux 服务器）上的 Claude Code 和 Codex 会话。核心用途是将手机作为主要交互界面，取代传统的终端和桌面环境，让开发者能在任何地点通过触摸操作处理编码代理的决策、审批和输出查看，实现“从任何地方编码”的移动工作流。
项目档案应用项目
K9i-0/ccpocket 是什么？用途、安装与使用指南
CC Pocket 是一款 Flutter 移动应用，通过自托管 Node.js 桥接服务器，让你能从手机远程启动、监控和管理 Claude Code 与 Codex 编码代理会话。支持实时输出查看、代码差异审查、快速审批和推送通知，实现真正的移动编码工作流。本文涵盖项目定位、安装步骤、使用方法和架构特点。
AI 总结
CC Pocket 是一款移动应用，通过 WebSocket 桥接服务器让用户能从手机远程启动、监控和管理 Claude Code 与 Codex 编码代理，实现真正的移动编码工作流。
中文项目介绍
CC Pocket 是一款专为 AI 编码代理设计的移动客户端应用，允许用户通过智能手机完全控制运行在远程主机上的 Claude Code 和 Codex 会话。
它解决了开发者在离开电脑时无法有效管理和决策 AI 编码代理工作的痛点。传统远程控制方案只能延续已有会话，而 CC Pocket 创新性地让会话从手机启动并全程在手机交互，主机仅在后台运行代理，实现了真正的“移动优先”编码工作流。
该应用适用于多种场景：单独开发者在 Mac mini 或树莓派上运行长时间代理会话时，可通过手机监控进度并快速审批；独立黑客在通勤或步行时继续编码工作；AI 原生工程师同时管理多个会话并响应批准请求；自托管者希望代码保留在自有机器上并通过手机安全远程控制。
技术架构上，CC Pocket 采用 Flutter 开发移动客户端，通过 WebSocket 连接 Node.js 桥接服务器，桥接服务器遵循 Claude CLI 的 stream-json 协议与本地 CLI 通信。项目采用 Monorepo 结构管理，状态管理已完成从 Riverpod 到 flutter_bloc 的迁移，并支持 Shorebird 热更新。
详细信息与使用说明
2. 解决的问题
传统编码代理交互严重依赖键盘和终端，当开发者离开电脑时无法及时响应代理的提问、审批工具调用或审查代码变更。Claude Code 的内置 Remote Control 功能只能延续已有会话，无法从手机启动新会话。CC Pocket 解决了这一痛点：它通过自托管桥接服务器建立手机与主机的持久连接，使会话生命周期完全由手机控制，主机在后台静默运行，从而让开发者能随时随地做出决策，不再被物理位置束缚。
3. 适用场景
- 单独开发者：在远程机器上运行长时间代理任务，通过手机监控进度、快速批准工具调用，无需时刻守在电脑前。 - 独立黑客与创始人：利用通勤、步行等碎片时间继续编码工作，处理代理的提问和决策，保持产品迭代速度。 - AI 原生工程师：同时管理多个编码代理会话，通过推送通知及时响应批准请求，高效切换上下文。 - 自托管用户：希望代码和敏感数据保留在自有机器上，通过手机安全远程控制本地编码环境，避免使用托管 IDE 的隐私顾虑。
4. 安装方式
安装分为桥接服务器和移动应用两步。在主机机器上，需先安装 Node.js 18+ 和至少一个 CLI 提供程序（Codex 或 Claude Code），然后执行 `npx @ccpocket/bridge@latest` 启动桥接服务器。API 密钥需通过环境变量 `ANTHROPIC_API_KEY` 配置（版本需 >=1.25.0），避免使用 `/login` 方式。移动端扫描服务器启动后显示的 QR 码即可连接，或直接从 App Store 下载安装。注意：旧版桥接（<1.25.0）因 Anthropic 政策原因已弃用。
5. 使用方式
启动桥接服务器后，手机应用通过 QR 码或手动输入 URL 连接。连接成功后，可浏览项目列表并选择要操作的目录。在聊天界面中，可发送 Markdown 格式的提示词、附加图片，实时查看代理的流式输出、计划和工具活动。当代理请求批准时，通过触摸按钮快速响应。代码差异审查支持语法高亮和图片对比。会话历史自动保存，可随时恢复。对于远程主机，可通过 SSH 管理启动、停止和更新流程。具体操作细节如会话创建、权限处理等，仓库中未提供完整命令列表。
6. 补充说明与实现特点
架构上，CC Pocket 采用客户端-服务器模式：Flutter 移动应用通过 WebSocket 与 Node.js 桥接服务器通信，桥接服务器通过 stdin/stdout 与本地 Claude CLI 交互，遵循 stream-json 协议规范。项目采用 Monorepo 结构，使用 npm workspaces 管理桥接服务器和移动应用包。状态管理已从 Riverpod 完全迁移至 flutter_bloc，涵盖连接、会话列表、聊天流和差异视图等核心状态。移动端支持 Shorebird 热更新，可快速推送修复。桥接服务器还支持 mDNS 自动发现、保存多台机器配置、推送通知等高级功能。Agent Teams 扩展设计已在规划中，将基于 Claude SDK 支持子代理团队协作。
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
CC Pocket 与 Claude Code 的 Remote Control 有什么区别？
Remote Control 是在桌面启动会话后 handoff 到手机，手机仅作为延续；CC Pocket 的会话从手机启动并全程在手机交互，主机仅在后台运行，实现真正的移动优先工作流。
桥接服务器需要什么环境？
需要 Node.js 18+ 和至少一个 CLI 提供程序（Codex 或 Claude Code），通过 `npx @ccpocket/bridge@latest` 启动，API 密钥通过环境变量 `ANTHROPIC_API_KEY` 配置。
如何解决 Claude 认证失败？
在 Bridge 机器上重新登录 Claude Code，可通过 SSH 连接后执行 `claude` 并运行 `/login`，或使用 `claude auth login` 命令完成认证。
支持哪些连接方式？
支持 QR 码扫描、mDNS 自动发现、保存的机器配置和手动 URL 输入，可连接本地或远程主机，并支持通过 SSH 管理远程主机。
代码数据是否上传到第三方？
所有代码和会话数据均保留在用户自有机器上，桥接服务器仅转发控制指令和输出流，不存储或上传代码内容，确保数据隐私。