人工智能代码智能体交互助手工具调用【免费下载链接】ccpocketMobile client for Codex and Claude — control coding agents from your phone via WebSocket bridge项目地址https://gitcode.com/gh_mirrors/cc/ccpocket点击查看免费下载CC Pocket是一款免费开源的手机端编码代理客户端让你在手机上远程控制自己电脑上的Codex和Claude Code会话。它的核心安全理念是自托管self-hosting 最小数据收集。你的代码始终留在自己的机器上Bridge Server 负责在 WebSocket 上校验每一个路径请求Claude 订阅鉴权则需要显式开启才能使用。这篇指南带你完整看懂它的安全设计。一、自托管架构代码为什么不会经过第三方服务器CC Pocket 由两部分组成CC Pocket App - 你电脑上的 Bridge Server - Codex / Claude手机 App 只是遥控器真正的 Agent 进程Codex CLI / Claude Code运行在你自己的 Mac、Linux 或 Windows 主机上通过 Bridge Server 中转。这意味着代码不过境源码、git 仓库、shell 操作全部发生在本地不进入任何托管 IDE 或开发者的服务器零遥测无分析统计、无崩溃上报、无行为追踪、无广告标识符见 PRIVACY_POLICY.md唯一的例外是可选的推送通知开启后仅通过 Firebase 匿名认证传递通知令牌不携带对话内容。换句话说你的数据这条线只有一条手机 → 你自己的 Bridge Server。二、目录白名单BRIDGE_ALLOWED_DIRS 如何锁住文件访问Bridge Server 通过 WebSocket 暴露文件系统操作因此目录白名单是第一道防线。相关实现位于 path-utils.ts环境变量默认值作用BRIDGE_ALLOWED_DIRS$HOME逗号分隔的项目目录白名单BRIDGE_FILE_DOWNLOAD_ALLOW_ALL_PATHS未设置仅限项目内设为1才允许下载白名单外的任意文件关键设计点默认锁在 $HOME不配置时Bridge 只能访问你的用户目录*是唯一的全放行值只有精确写入*才会解除限制防止误写通配符见 index.ts路径解析后校验每个请求路径都会先resolve规范化再检查是否落在白名单内符号链接指向白名单外同样会被拒绝。核心判断逻辑 isPathWithinAllowedDirectory 通过相对路径前缀防止../穿越并在 websocket.ts 中对文件操作、目录浏览等接口逐一执行按需扩容需要访问$HOME外的项目时显式追加即可例如BRIDGE_ALLOWED_DIRS$HOME,/scratch/myuser。# 只允许访问两个目录并启用 API Key 认证 BRIDGE_ALLOWED_DIRS$HOME,/scratch/myuser \ BRIDGE_API_KEYmy-secret \ npx ccpocket/bridgelatest三、连接认证BRIDGE_API_KEY 与网络层安全BRIDGE_API_KEY可选的 API Key 认证。设置后手机连接时必须携带该 Keyindex.ts 在启动时启用认证并打印提示。官方部署文档明确推荐启用仅在Tailnet 里全是完全可信的个人设备时才建议关闭网络层建议局域网内扫二维码直连即可离开家庭网络后官方推荐使用Tailscale组虚拟专用网再连接ws://tailscale-ip:8765而不是把端口暴露到公网详见 bridge-tailscale-aliyun-guide.zh-CN.md手机侧凭据加密API Key 与 SSH 私钥在手机上通过平台原生加密存储iOS Keychain / Android Keystore不存普通文件见 SECURITY.md️mDNS 可关闭macOS 上自动禁用 mDNS 广播其他平台可用BRIDGE_DISABLE_MDNS1关闭减少局域网内的服务暴露面。完整配置项清单见 packages/bridge/README.md 的 Configuration 表格setup命令可把上述设置持久化为 macOS launchd / Linux systemd 后台服务。四、Claude 鉴权风险为什么订阅登录必须显式开启这是 CC Pocket 安全设计中最需要理解的一块详细说明见 auth-troubleshooting.zh-CN.md 与 packages/bridge/README.md。两种鉴权方式对比方式启用条件风险API Key推荐配置ANTHROPIC_API_KEY即可低符合 Anthropic 对第三方产品的官方要求Claude 订阅登录OAuth必须显式设置BRIDGE_ALLOW_CLAUDE_OAUTH1并重启存在不确定性未来可能被限制风险从何而来Anthropic 的 Legal and compliance 页面允许平台托管未修改的 Claude Code由终端用户用自己的订阅登录——CC Pocket 正是运行官方 Agent SDK 并把凭据加载完全委托给宿主机的 Claude Code 环境自身不复制、不存储、不刷新任何 OAuth 凭据但 Agent SDK 概览页同时要求未经事先批准的第三方产品应使用 API Key而不是提供 Claude.ai 登录或订阅限流这两条声明对 CC Pocket 这种自托管 远程操控架构的适用范围并不清晰因此订阅鉴权未来可能被限制或失效。所以 CC Pocket 选择了显式 opt-in策略默认关闭订阅登录只有你明确运行下面的命令才会开启——BRIDGE_ALLOW_CLAUDE_OAUTH1 npx ccpocket/bridgelatest官方建议如果不追求订阅额度直接用ANTHROPIC_API_KEY最稳妥。此外运行在 Amazon Bedrock 上的 Claude Code 使用 AWS 凭据签名两条鉴权都不需要packages/bridge/README.md 中有专门章节。五、安全设计速查清单 ✅机制位置默认行为目录白名单BRIDGE_ALLOWED_DIRS仅$HOME路径校验含符号链接path-utils.ts始终执行API Key 认证BRIDGE_API_KEY关闭推荐开启全路径文件下载BRIDGE_FILE_DOWNLOAD_ALLOW_ALL_PATHS关闭Claude 订阅登录BRIDGE_ALLOW_CLAUDE_OAUTH1关闭手机凭据存储Keychain / Keystore始终加密数据收集隐私政策零遥测、零分析总结CC Pocket 的安全模型可以概括为一句话默认收紧、显式放开。自托管架构保证代码不出本机目录白名单 路径规范化校验封死文件越权API Key 与 Tailscale 守住网络入口而 Claude 订阅鉴权则被刻意设计成知情后手动开启的可选项。理解了这套机制你就能安心地把编码代理真正装进口袋 。赞分享人工智能代码智能体交互助手工具调用【免费下载链接】ccpocketMobile client for Codex and Claude — control coding agents from your phone via WebSocket bridge项目地址https://gitcode.com/gh_mirrors/cc/ccpocket点击查看免费下载相关推荐Kickflip Android SDK完全指南打造革命性云视频直播应用的终极工具Kickflip Android SDK完全指南打造革命性云视频直播应用的终极工具 Kickflip Android SDK是一款功能强大的云视频直播工具专音视频移动开发ToolJet 自托管实例级登录配置指南Instance Login 的 SSO、域名白名单与登录策略详解ToolJet 自托管实例级登录配置指南Instance Login 的 SSO、域名白名单与登录策略详解 本文基于 ToolJet 仓库 instance低代码后端前端AI 应用MCP 服务Apache APISIX 内嵌 Dashboard 完整指南启用配置、IP 白名单与 Admin API Key 鉴权实战Apache APISIX 内嵌 Dashboard 完整指南启用配置、IP 白名单与 Admin API Key 鉴权实战 本指南聚焦 Apache APIAPI网关后端云原生微服务创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
