1. CC-Connect 是什么手机远程操控 Claude Code 与 Codex 的完整场景CC-Connect 是一个开源的 AI Agent 桥接工具它把跑在你电脑上的 Claude Code、Codex、Gemini CLI、Cursor Agent 等命令行 Agent 接入到聊天平台让你用手机就能发指令、收结果。核心检索词就是「CC-Connect 下载安装教程」和「Claude Code 远程控制」——前者解决怎么装后者解决装完怎么用。适合谁经常让 Claude Code 跑长任务、但人不在电脑前的开发者用 Codex 做批量重构、想随时查看进度的独立开发者以及需要把 AI Agent 接入团队聊天工具做自动化的运维同学。它的工作方式不复杂CC-Connect 在你本机起一个常驻进程这个进程负责拉起 Claude Code 或 Codex 的子进程同时连接聊天平台。你在手机聊天窗口里发一句话消息经平台推送到本机进程进程把这句话转成 Agent 的输入Agent 执行完把输出回传你再在手机上看到结果。整个过程你的代码不出本机只有指令和结果在聊天通道里流动。我试过把它接到飞书和 Telegram 两个平台体感是「把终端装进了口袋」。以前 Claude Code 跑一个跨文件重构我得守在电脑前看它一步步改现在发完指令去泡杯咖啡手机震动就是任务完成的通知。对于 Codex 这类擅长批量操作的 Agent远程触发的价值更明显——你可以在通勤路上让它整理昨天的提交记录到公司直接看结果。需要提前说清楚一点CC-Connect 本身不提供模型能力它只是「遥控器」。真正干活的 Claude Code、Codex 需要各自有可用的模型通道。这就是为什么后面要接 TaoToken 的统一 Key——一个 Key 同时喂给多个 Agent省去每个工具单独配通道的麻烦。下面从下载安装开始一步步走到手机端发起任务并验证返回。2. TaoToken 前置准备统一 Key 与 API 通道配置在装 CC-Connect 之前先把模型通道准备好否则装完 Agent 也跑不起来。TaoToken 的作用是提供统一的 API 入口Claude Code、Codex 这些工具都通过同一个 Base URL 和 Key 访问模型不用每个工具去折腾不同的通道配置。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。第一步拿到 Key。打开控制台页面 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 登录后进入 API Keys 管理页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 创建一个新 Key 并复制保存。这个 Key 就是后面所有 Agent 共用的凭证建议命名成「cc-connect」方便区分。第二步确认你要接的 Agent 和对应模型 ID。Claude Code 走 Anthropic 兼容协议Codex 走 OpenAI 兼容协议两者在 TaoToken 上都用同一个 Base URLhttps://taotoken.net/api区别在路径和模型名。你可以在模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 先试跑一次确认 Key 有效、模型能返回再去配 Agent。第三步理解配置的落点。Claude Code 读的是环境变量或 settings 文件Codex 读的是~/.codex/auth.json。CC-Connect 在拉起这些 Agent 时会继承你本机的环境所以只要本机 Agent 能跑通CC-Connect 就能远程触发。换句话说配置顺序是先让 Claude Code / Codex 在本机命令行跑通再装 CC-Connect 做远程桥接。这里有个容易忽略的点CC-Connect 常驻进程和 Agent 子进程用的是同一套环境变量。如果你在 shell 里 export 了 Key但 CC-Connect 是用 systemd 或 launchd 拉起的它可能读不到你的 shell 环境。稳妥做法是把配置写进文件settings.json / auth.json而不是只依赖 export。下面第三节给出可直接复制的片段。如果你打算长期跑编码任务或 Agent 自动化可以顺带了解 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它面向的就是这种持续调用场景。不过本篇重点是 CC-Connect 的安装与远程验证通道配置够用即可。3. 可复制配置CC-Connect 安装包选择与 Agent 接入片段先解决下载。CC-Connect 提供四个安装包选错架构是最常见的坑。对照表如下安装包适用系统cc-connect-v1.3.4-darwin-arm64.dmgApple Silicon MacM1/M2/M3/M4cc-connect-v1.3.4-darwin-amd64.dmgIntel 芯片 Maccc-connect-v1.3.4-windows-arm64.exeWindows ARM 设备骁龙 X Elite 等cc-connect-v1.3.4-windows-amd64.exe普通 WindowsIntel/AMD CPU不确定架构时Mac 上执行uname -m输出arm64选 darwin-arm64输出x86_64选 darwin-amd64。Windows 上打开「设置 → 系统 → 关于」看「系统类型」是「基于 x64」还是「基于 ARM」。99% 的普通 Windows 电脑选 amd64。装完后先配 Claude Code。它的配置写在~/.claude/settings.json可复制片段如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5-20250929 } }注意 Base URL 只写到/api不要自己加/v1Claude Code 会按 Anthropic 协议拼路径。Model ID 用你在模型对话页确认过的那个。再配 Codex。它读~/.codex/auth.json可复制片段{ OPENAI_API_KEY: sk-你的TaoToken密钥, OPENAI_BASE_URL: https://taotoken.net/api }如果你的 Codex 版本用 TOML 配置对应~/.codex/config.tomlmodel gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key OPENAI_API_KEY三件套记牢Base URL 是https://taotoken.net/apiKey 是控制台创建的那串Model ID 按工具选Claude Code 用 claude 系列Codex 用 gpt-5-codex 系列。CC-Connect 本身不需要单独填 Key它继承本机 Agent 的配置。最后配 CC-Connect 的聊天平台连接。以 Telegram 为例在 CC-Connect 配置里填入 Bot Token 和目标会话 ID启动后它会在本机拉起 Agent 子进程。启动命令类似cc-connect start --agent claude-code --platform telegram具体参数名以你下载版本的cc-connect --help为准。启动后本机应能看到 Agent 进程被拉起手机聊天窗口里发/model或/provider可以切换 Agent。4. 验证请求手机端发起一次 Agent 任务并确认返回配置写完必须验证否则你不知道是通道问题还是桥接问题。分两步先在本机确认 Agent 能跑再在手机端确认远程能触发。本机验证 Claude Codeclaude -p 用一句话说明当前目录有几个文件如果返回正常说明 TaoToken 通道和 Claude Code 配置都对。若报 401回到第三节检查 Key 和 Base URL。本机验证 Codexcodex exec print hello两条都通再启动 CC-Connect。启动后观察日志正常会打印「agent started」「platform connected」之类的行。此时在手机聊天窗口发送帮我看看当前项目里有哪些 TODO 注释Agent 会在本机执行结果回传到聊天窗口。第一次验证建议用只读任务比如「列出 src 目录结构」「统计代码行数」避免远程触发写操作时出意外。成功结果的判断标准有三个手机端收到 Agent 的完整回复本机 CC-Connect 日志显示任务执行完成Agent 进程没有异常退出。如果手机端一直转圈先看本机日志有没有收到消息再看 Agent 有没有被拉起。我踩过的坑是聊天平台 Bot 权限没开全消息根本没推到本机日志里一片安静——这种情况查平台侧配置不是 CC-Connect 的问题。验证通过后你可以试更复杂的任务比如让 Claude Code 做一次小范围重构或者让 Codex 批量改文件名。远程触发的价值在长任务上体现得最明显发完指令锁屏手机通知响了再看结果。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth远程桥接涉及本机 Agent、CC-Connect 进程、聊天平台三层报错定位要按层排查。401 Unauthorized最常见几乎都是 Key 或 Base URL 问题。检查~/.claude/settings.json里的ANTHROPIC_AUTH_TOKEN是否和控制台一致Base URL 是否为https://taotoken.net/api不带/v1。Codex 侧检查~/.codex/auth.json的OPENAI_API_KEY。改完配置要重启 CC-Connect否则它拉起的还是旧环境。local proxy failed / connection refusedCC-Connect 连不上本机 Agent 或模型通道。先确认本机claude -p test能跑通再确认 CC-Connect 进程有网络权限macOS 首次运行会弹网络授权别点拒绝最后看是不是防火墙拦了本地端口。这个报错和 Key 无关别去反复换 Key。reading choices / unexpected responseAgent 收到了非预期格式的返回通常是 Base URL 写错导致返回了 HTML 错误页或者 Model ID 不存在。回到模型对话页确认模型名拼写Claude Code 的 Model ID 区分大小写和日期后缀。OAuth / authentication failedClaude Code 或 Codex 尝试走官方 OAuth 登录流程说明你的配置没生效它回退到了默认认证。检查配置文件路径是否正确~/.claude/settings.json不是settings.json以及环境变量有没有被 shell 里的旧值覆盖。用env | grep ANTHROPIC确认实际生效的值。排查顺序建议固定本机 Agent 能否跑通 → CC-Connect 日志有无收到消息 → 聊天平台 Bot 权限是否完整。三层逐层排除比盲目改配置快得多。如果本机跑不通问题在通道本机通但手机不通问题在桥接或平台。6. 长期使用建议与接入文档入口CC-Connect 跑起来之后建议把 Agent 配置和 CC-Connect 配置都纳入版本管理Key 用环境变量或密钥管理别提交明文。定时任务用/cron配置比如每天早上让 Agent 总结一次仓库动态结果自动推到手机。多 Agent 切换用/model和/providerClaude Code 适合长上下文重构Codex 适合批量代码操作按任务类型选。需要补充通道细节时接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。Claude Code 的 Anthropic 兼容接入说明在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 遇到协议层问题时对照检查。想先验证模型返回再配 Agent用模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 最快。最后提醒一句CC-Connect 是遥控器不是替代品。它不改变 Agent 的能力边界只是把触发入口从键盘挪到了手机。真正决定任务质量的还是你给 Claude Code 或 Codex 的指令以及背后模型通道的稳定性。把本机 Agent 调顺远程体验自然就顺。