1. 手机远程驱动 Claude Code 的真实痛点与 remote-claude 是什么remote-claude 是一个把本地 Claude Code 会话桥接到飞书的开源工具让你在手机上就能查看 Claude 的输出、确认方案、继续下发指令。它解决的核心问题很具体Claude Code 在跑长任务时经常需要人确认比如它写完一个模块会停下来问“要不要继续重构”或者遇到歧义会等你补充上下文。你人一旦离开电脑整个流程就卡住了。我试过下班前丢一个重构任务给它结果刚上地铁就收到它停在某个交互确认上回家一看进度为零。这个场景下remote-claude 的价值就出来了。它通过飞书机器人把本地终端里的 Claude Code 会话“搬”到手机上你在飞书里发一句话电脑上的 Claude Code 就继续干活输出结果也会推回飞书卡片。适合谁用经常用 Claude Code 做 VibeCoding、需要长时间跑任务、又不想被绑在电脑前的开发者。它本身也支持 CodeX所以如果你同时用多个编码 Agent一套飞书入口就能管起来。但这里有个容易被忽略的坑多工具 API Key 分散。Claude Code 用一套 KeyCodeX 用另一套remote-claude 桥接时又要配置模型访问凭证。切换工具时改环境变量、改配置文件繁琐且容易出错。TaoToken 的统一 Key 接入正好解决这个问题——一个 Key 覆盖多个模型入口remote-claude 和 Claude Code 都指向同一个 Base URL省掉来回切换的麻烦。下面我会从环境准备、TaoToken 配置、remote-claude 安装、飞书机器人创建到完整验证一步步带你复现这套远程驱动工作流。2. TaoToken 统一 Key 前置准备与 npm/uv 环境搭建在装 remote-claude 之前先把两件事搞定TaoToken 的 API Key 和本地 npm/uv 环境。这两步不做后面会反复报错。先说 TaoToken。它的作用是给你一个统一的模型访问入口Claude Code、CodeX 以及 remote-claude 桥接时都用同一个 Key 和 Base URL。你需要先去官网注册并拿到 API Key。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 Key。API 入口是 https://taotoken.net/api 注意这个地址不加 UTM 参数配置时直接写这个。拿到 Key 后先确认本地环境。remote-claude 依赖 npm、uv 和 tmux。npm 用来安装 remote-claude 包uv 是 Python 包管理器remote-claude 部分组件用 Python 写tmux 用来维持会话不中断。检查命令如下node -v npm -v uv --version tmux -V如果 uv 没装用官方脚本安装curl -LsSf https://astral.sh/uv/install.sh | shtmux 在 macOS 上用 brew 装Ubuntu 用 aptbrew install tmux # 或者 sudo apt install tmuxnpm 一般随 Node 安装如果版本太低建议用 nvm 管理。这些依赖装好后再配置 TaoToken 的环境变量。Claude Code 读取的是 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 这两个变量。你可以在 shell 配置文件里写入export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKEN你的TaoToken Key写完后执行source ~/.zshrc或source ~/.bashrc生效。验证一下echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN能正确输出就说明环境变量生效了。这一步很关键因为 remote-claude 启动 Claude Code 时会继承当前 shell 的环境变量如果这里没配好后面 Claude Code 会报 401 认证失败。另外提醒一句TaoToken 的 Key 不要提交到 Git 仓库建议放在本地 shell 配置或 .env 文件里并加入 .gitignore。3. remote-claude 安装与飞书机器人配置可复制片段环境准备好后开始装 remote-claude。它有两种安装方式npm 安装和源码安装。npm 方式最简单npm install -g remote-claude第一次安装会拉取 uv 和 tmux 相关依赖可能有点慢耐心等。如果 npm 安装遇到权限问题可以加 sudo 或者配置 npm 全局目录。源码安装适合想改代码的人git clone https://github.com/yyzybb537/remote_claude.git cd remote_claude ./init.sh装完后需要配置飞书机器人。remote-claude 提供了向导命令remote-claude lark init执行后浏览器会跳转到飞书智能体应用创建页面按向导一步步操作扫码创建企业自建应用、开通所需权限、配置事件回调、写入本地配置。这里有个关键点——创建版本后必须发布只有发布后的机器人才能在飞书里搜索到。我踩过的坑是创建完没发布在飞书里搜不到机器人折腾了半天才发现。飞书配置完成后remote-claude 会在本地生成配置文件。如果你用 TaoToken 统一 Key需要确保 remote-claude 启动 Claude Code 时能读到正确的环境变量。可以在 remote-claude 的配置里显式指定或者直接在 shell 里 export。为了更清晰我建议在项目目录下建一个.env文件ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_AUTH_TOKEN你的TaoToken Key然后在启动 remote-claude 前 source 这个文件。如果你同时用 CodeXCodeX 的配置在~/.codex/auth.json需要写入 Base URL、Key 和 Model ID 三件套{ base_url: https://taotoken.net/api, api_key: 你的TaoToken Key, model: claude-sonnet-4-20250514 }这样 Claude Code 和 CodeX 都走 TaoToken 同一个入口Key 统一管理不用来回切换。配置完成后启动 remote-claude 的飞书客户端cla这个命令会以当前目录路径为会话名启动 Claude并同时启动飞书客户端。你可以用remote-claude list查看所有已经和飞书打通的本地会话。看到会话列表里有你刚启动的目录就说明桥接成功了。4. 从手机飞书发送指令到 Claude Code 完成编码的验证步骤现在进入最关键的验证环节从手机飞书发指令看电脑上的 Claude Code 是否执行并返回结果。第一步在电脑上进入你的项目目录执行cla启动会话。假设你的项目在~/projects/demo启动后终端会显示 Claude Code 的交互界面同时 remote-claude 在后台把会话注册到飞书。第二步打开手机飞书搜索你创建的机器人比如“alllen的智能助手”发送/menu指令会弹出菜单卡片。在会话管理里选择“创建群聊”进入你刚才启动的会话。第三步在群聊里直接发一条指令比如帮我在 src/utils 下创建一个 formatDate.js实现时间戳转 YYYY-MM-DD 格式并写一个简单的测试用例。发送后电脑上的 Claude Code 会收到这条指令并开始执行。你可以在手机飞书里看到 Claude 的实时输出包括它创建文件、写代码、运行测试的过程。如果它需要确认比如问“是否要覆盖已存在的文件”你直接在飞书里回复“是”或“否”即可。第四步验证结果。等 Claude 执行完在飞书里会看到它返回的总结比如“已创建 formatDate.js 和对应测试测试通过”。此时回到电脑上检查文件是否真的生成了ls src/utils/formatDate.js cat src/utils/formatDate.js如果文件存在且内容正确说明整条链路打通了。你还可以在飞书里继续发指令比如“把测试用例改成 Jest 风格”Claude 会继续修改。整个过程你都不需要碰电脑。这里有个细节remote-claude 依赖 tmux 维持会话所以即使你关闭终端窗口只要 tmux 会话还在Claude Code 就继续运行飞书依然能收到输出。你可以用tmux ls查看会话用tmux attach重新连接。如果想让会话在后台长期运行启动时确保 tmux 没有被杀掉。另外如果你同时用 CodeXremote-claude 也支持。启动 CodeX 会话的方式类似飞书里同样能收到输出。这样你手机上就有一个统一的入口管着 Claude Code 和 CodeX 两个编码 AgentKey 都走 TaoToken不用分别配置。5. 本篇常见报错排查401、local proxy failed、reading choices 与 OAuth配置过程中最容易遇到几类报错我逐个说下排查思路。401 认证失败。这是最常见的通常是 TaoToken Key 没配好或环境变量没生效。先检查echo $ANTHROPIC_AUTH_TOKEN是否有输出再确认 Base URL 是不是https://taotoken.net/api。如果 Key 正确但还报 401可能是 remote-claude 启动时没有继承 shell 环境变量。解决办法是在启动cla前先source ~/.zshrc或者在 remote-claude 配置里显式写入 Key。另外注意 Key 有没有多余空格或换行。local proxy failed。这个报错通常出现在 remote-claude 尝试连接本地 Claude Code 会话时。原因可能是 tmux 会话没启动或者 Claude Code 进程已经退出。先tmux ls看会话在不在如果不在重新执行cla启动。如果会话在但还报错检查 remote-claude 的日志看它连接的端口或 socket 路径是否正确。有时候是权限问题确保当前用户对 tmux socket 有读写权限。reading choices 报错。这个一般出现在 Claude Code 返回结果解析时remote-claude 读取 choices 字段失败。可能是模型返回格式和预期不一致。先确认 TaoToken 的 Base URL 是否正确因为不同入口返回的 JSON 结构可能略有差异。如果用的是 CodeX检查~/.codex/auth.json里的 model 字段是否写对Model ID 要和 TaoToken 支持的模型一致。另外如果 Claude Code 版本太旧也可能导致解析失败建议升级到最新版。OAuth 相关报错。如果你之前用 Claude 官方 OAuth 登录过环境变量里可能残留旧的 token导致和 TaoToken 的 Key 冲突。检查~/.claude目录下有没有旧的凭证文件必要时清理掉只保留 TaoToken 的配置。另外飞书机器人创建时如果 OAuth 回调地址配错也会报错重新执行remote-claude lark init走一遍向导即可。排查时建议开两个终端一个跑cla看实时输出一个看 remote-claude 日志。日志一般在~/.remote-claude/logs下tail 一下就能看到具体错误堆栈。大部分问题都是环境变量和 Key 配置引起的耐心对一遍就能解决。6. 统一 Key 接入后的远程编码工作流与长期使用建议整套流程跑通后你的日常工作流会变成这样早上到公司在项目目录执行cla启动会话然后该干嘛干嘛。中午吃饭时手机飞书收到 Claude 的确认请求你回一句“继续”它接着干。下午开会时它写完一个模块飞书推送结果你扫一眼没问题就让它提交。下班路上它还在跑测试你在地铁上就能看到进度。这种工作流的核心是 TaoToken 统一 Key 带来的便利。Claude Code、CodeX、remote-claude 桥接都指向同一个 Base URL 和 Key你不用为每个工具单独配一套凭证。如果你同时跑多个项目每个项目目录启动一个cla会话飞书里会列出所有会话切换起来也方便。长期使用有几个建议。第一tmux 会话要定期清理避免堆积太多僵尸会话用tmux kill-session -t 会话名关掉不用的。第二TaoToken 的 Key 建议定期轮换在控制台重新生成后更新环境变量即可。第三remote-claude 的飞书机器人权限最小化只开必要的消息和事件权限避免安全风险。第四如果你用 Coding Plan 做长期编码任务可以在 TaoToken 控制台看用量合理规划。最后说个实用技巧你可以在飞书里给机器人发/menu随时查看会话列表不用记命令。如果某个会话卡住了在飞书里发“取消当前任务”或者直接CtrlC的等效指令Claude 会停下来等你下一步指示。这套工作流我用了几个月最大的感受是编码这件事真的可以脱离工位了你只需要在关键节点做决策剩下的交给 Claude Code 和 remote-claude 在后台跑。