1. 手机远程操控 Claude Code 的真实痛点Claude Code 这类终端里的编码 Agent能力确实强但它有个天然限制你得坐在电脑前盯着终端。一旦离开工位编译到一半、想让它顺手改个文件、或者临时想到一个需求就只能干等回去再操作。我试过用 SSH 客户端连回家里机器体验很割裂——手机键盘敲命令本来就别扭还要在会话里来回切换效率反而更低。Channels 这个机制解决的正是这件事它把 Claude Code 变成一个可以被消息平台触发的常驻服务。你在 Telegram 里发一句话本机的 Claude Code 收到后开始干活把执行过程和结果直接回传到聊天窗口。对使用者来说Telegram 就是遥控器真正的算力、文件系统、项目代码都还在你自己的电脑上。适合谁用三类人最明显一是经常离开工位但项目还在跑的开发者二是想用手机做轻量任务整理文件、抓网页要点、跑脚本的人三是团队里想让多个人共用同一个编码 Agent 的场景。这篇就按完整链路走一遍装 Channels 插件、启动 Telegram 通道、在 settings.json 里把 API 通道统一到 TaoToken、绑定 Bot、最后用手机发一条消息验证本地真的执行并回传。需要提前说明的是Channels 依赖 Claude Code 本体所以电脑上得先有一个能正常跑的 Claude Code 环境另外准备一个 Telegram 账号和终端访问权限。下面每一步都给可复制的命令和配置照着做就行。2. 前置准备TaoToken 统一 Key 与 API 通道在装插件之前先把 API 通道理顺。Claude Code 默认走官方端点但很多人在多项目、多设备场景下希望有一个统一的 Key 和入口来管理调用TaoToken 就是干这个的它提供一个兼容的 API 地址和统一 Key你把它写进 Claude Code 的配置里后续所有请求都从这一个通道走换项目、换机器不用反复改。先拿到 Key。打开 https://taotoken.net/api 对应的控制台入口在 API Keys 页面创建一个新 Key复制出来。这个 Key 后面要填进 settings.json注意别直接贴到聊天记录或公开仓库里。TaoToken 的 API 基地址是https://taotoken.net/api注意这个地址不带任何查询参数配置里就写这个。控制台和文档入口分别是控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite如果你只是想先验证模型通不通可以用模型对话页面快速发一条测试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite长期跑编码任务、或者要接 Agent 的建议直接看 Coding Plan额度模型更适合持续调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite把 Key 和基地址准备好下一步写进配置。3. 可复制配置settings.json 骨架与插件安装Claude Code 的配置分两层一层是全局 settings.json管 API 通道和 Key另一层是插件本身管 Telegram 通道。先处理配置。全局 settings.json 一般位于用户目录下的.claude/settings.jsonWindows 是%USERPROFILE%\.claude\settings.json。如果文件不存在就新建。下面是一个可直接复制的骨架把YOUR_TAOTOKEN_KEY换成你刚才复制的 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_TAOTOKEN_KEY }, permissions: { allow: [], deny: [] } }这里两个字段是关键ANTHROPIC_BASE_URL指向 TaoToken 的 API 基地址ANTHROPIC_AUTH_TOKEN填你的统一 Key。Claude Code 启动时会读取这两个环境变量所有模型请求就走这个通道了。permissions先留空后面按需加白名单。配置写完先确认 Claude Code 是最新版再装插件claude update claude plugin install anthropic/channel-telegram安装过程中会问作用域选global这样所有项目都能用这个通道不用每个项目单独装。装完刷新一下插件列表claude plugin reload如果这一步报plugin not found多半是 marketplace 缺失或过期先刷新再装claude marketplace refresh claude marketplace install anthropic/official刷新后重新执行claude plugin install anthropic/channel-telegram。有个常见的坑插件装完但命令不生效这时候别急着重装先把当前 Claude Code 会话完全退出再重启插件注册才会真正加载。4. 绑定 Telegram Bot 与启动通道插件就位后去 Telegram 里创建机器人。搜索BotFather点 Start依次输入/newbot然后给机器人起一个显示名比如Claude Code再给一个以bot结尾的用户名比如claude_code_bot。BotFather 会返回一串 bot token复制保存下一步要用。回到终端运行 Telegram 配置命令按提示粘贴 token/telegram:configure保存成功后会看到状态回显说明 token 已经写进插件配置。接着启动带 Telegram 监听器的 Claude Codeclaude --channel telegram现在切到手机 Telegram按用户名搜索你刚创建的机器人点 Start随便发一条消息。机器人会回一个 6 位配对码。把这个码拿回终端输入出现提示时批准配对。终端和 Telegram 两边都会显示Paired. Say hi to Claude.说明链路通了。配对完成后有个安全步骤不能省。默认情况下任何找到你机器人的人都能发起配对请求。运行/telegram:access把 DM 策略从pairing改成allow-list。改完之后只有已批准的发送者能和机器人交互陌生人发消息不会触发任何执行。这一步在多人共用或者机器人用户名比较容易被猜到时尤其重要。如果你想让队友或家人也能用同一个机器人让他们各自给机器人发消息你在终端逐个批准配对码即可不需要重复装插件。5. 验证请求手机发消息触发本地执行链路搭好做一次真实验证。在手机 Telegram 里给机器人发一条明确的任务比如在当前项目创建一个 index.html做一个数字产品的落地页完成后把文件路径告诉我发送后观察两个地方。终端这边Claude Code 会立刻开始工作你能看到它读取目录、创建文件、写入内容的日志。手机这边机器人会把执行进度和最终结果回传包括创建的文件路径。如果任务涉及浏览器预览它还能截图发回 Telegram你在手机上就能看到落地页长什么样。验证成功的标志有三个终端出现实际的文件操作日志、手机收到结果回传、本地项目目录里确实多了index.html。三个都满足说明从 Telegram 到本地 Claude Code 的完整链路是通的。这里有个默认行为要注意Claude Code 在创建文件或运行某些命令前会请求许可。也就是说任务跑到一半可能停下来等你回终端批准这跟远程操控的初衷有点冲突。如果你在可信环境里想让它完全无人值守可以这样启动claude --channel telegram --dangerously-skip-permissions这个标志会跳过所有权限提示等于把系统访问权完全交给 Agent存在 prompt 注入等安全风险只在你完全信任的环境和任务里用。想恢复之前的会话并带上这些标志claude --channel telegram --dangerously-skip-permissions --continue验证通过后日常用法就很灵活了让它整理桌面文件、抓一个网页的要点、跑一段脚本、装个依赖这些都能在手机上发一句话完成。6. 本篇常见错排查插件命令不生效装完插件后/telegram:configure没反应先claude plugin reload还不行就完全退出 Claude Code 会话再重启。插件注册在会话启动时加载热重载不一定覆盖所有命令。配对码收不到手机给机器人发消息后没有回码检查claude --channel telegram是否还在前台运行。这个进程一旦退出监听就断了机器人不会响应。建议用 tmux 或后台方式常驻。请求报鉴权失败多半是 settings.json 里的 Key 或基地址写错。确认ANTHROPIC_BASE_URL是https://taotoken.net/api不带多余路径和参数ANTHROPIC_AUTH_TOKEN是完整 Key没有多余空格。改完配置要重启 Claude Code 才生效。改了配置但走的还是旧通道环境变量优先级问题。检查系统里是否还有旧的ANTHROPIC_BASE_URL环境变量覆盖了 settings.json有的话清掉。多人配对后权限混乱确认已经把 DM 策略改成allow-list否则未批准的发送者仍可能触发配对流程。定期在/telegram:access里检查已批准列表。无人值守模式没生效--dangerously-skip-permissions必须和--channel telegram一起在启动命令里写在配置里不生效。另外这个标志只影响权限提示不影响 API 通道。排查顺序建议从进程是否存活、配置是否被覆盖、Key 是否有效这三层往下走大部分问题都出在前两层。7. 通道打通之后把 Telegram 接到 Claude Code 上本质是把「坐在终端前」这个约束解开了。你不再需要为了一个小改动专门回到电脑前手机发一句话本机执行结果回传整个闭环在聊天窗口里完成。配置层面记住三件事API 通道统一走 TaoToken 的基地址和 Key写在全局 settings.json 里插件用global作用域装一次就够安全上务必把 DM 策略锁成allow-list。这三步做完剩下的就是怎么用的问题了。如果你还没拿到 Key从 API Keys 页面创建一个https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入细节和字段说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite想先验证模型响应用模型对话页面发一条测试最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite长期跑编码任务、接 Agent 的直接上 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite最后给一个实用建议把claude --channel telegram放进 tmux 会话里常驻这样即使你关掉终端窗口监听也不会断手机随时发消息都能触发。真正让远程操控好用的不是配置多复杂而是这个进程一直在。
Channels 实战：用手机 Telegram 远程访问 Claude Code 的配置与验证
1. 手机远程操控 Claude Code 的真实痛点Claude Code 这类终端里的编码 Agent能力确实强但它有个天然限制你得坐在电脑前盯着终端。一旦离开工位编译到一半、想让它顺手改个文件、或者临时想到一个需求就只能干等回去再操作。我试过用 SSH 客户端连回家里机器体验很割裂——手机键盘敲命令本来就别扭还要在会话里来回切换效率反而更低。Channels 这个机制解决的正是这件事它把 Claude Code 变成一个可以被消息平台触发的常驻服务。你在 Telegram 里发一句话本机的 Claude Code 收到后开始干活把执行过程和结果直接回传到聊天窗口。对使用者来说Telegram 就是遥控器真正的算力、文件系统、项目代码都还在你自己的电脑上。适合谁用三类人最明显一是经常离开工位但项目还在跑的开发者二是想用手机做轻量任务整理文件、抓网页要点、跑脚本的人三是团队里想让多个人共用同一个编码 Agent 的场景。这篇就按完整链路走一遍装 Channels 插件、启动 Telegram 通道、在 settings.json 里把 API 通道统一到 TaoToken、绑定 Bot、最后用手机发一条消息验证本地真的执行并回传。需要提前说明的是Channels 依赖 Claude Code 本体所以电脑上得先有一个能正常跑的 Claude Code 环境另外准备一个 Telegram 账号和终端访问权限。下面每一步都给可复制的命令和配置照着做就行。2. 前置准备TaoToken 统一 Key 与 API 通道在装插件之前先把 API 通道理顺。Claude Code 默认走官方端点但很多人在多项目、多设备场景下希望有一个统一的 Key 和入口来管理调用TaoToken 就是干这个的它提供一个兼容的 API 地址和统一 Key你把它写进 Claude Code 的配置里后续所有请求都从这一个通道走换项目、换机器不用反复改。先拿到 Key。打开 https://taotoken.net/api 对应的控制台入口在 API Keys 页面创建一个新 Key复制出来。这个 Key 后面要填进 settings.json注意别直接贴到聊天记录或公开仓库里。TaoToken 的 API 基地址是https://taotoken.net/api注意这个地址不带任何查询参数配置里就写这个。控制台和文档入口分别是控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite如果你只是想先验证模型通不通可以用模型对话页面快速发一条测试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite长期跑编码任务、或者要接 Agent 的建议直接看 Coding Plan额度模型更适合持续调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite把 Key 和基地址准备好下一步写进配置。3. 可复制配置settings.json 骨架与插件安装Claude Code 的配置分两层一层是全局 settings.json管 API 通道和 Key另一层是插件本身管 Telegram 通道。先处理配置。全局 settings.json 一般位于用户目录下的.claude/settings.jsonWindows 是%USERPROFILE%\.claude\settings.json。如果文件不存在就新建。下面是一个可直接复制的骨架把YOUR_TAOTOKEN_KEY换成你刚才复制的 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_TAOTOKEN_KEY }, permissions: { allow: [], deny: [] } }这里两个字段是关键ANTHROPIC_BASE_URL指向 TaoToken 的 API 基地址ANTHROPIC_AUTH_TOKEN填你的统一 Key。Claude Code 启动时会读取这两个环境变量所有模型请求就走这个通道了。permissions先留空后面按需加白名单。配置写完先确认 Claude Code 是最新版再装插件claude update claude plugin install anthropic/channel-telegram安装过程中会问作用域选global这样所有项目都能用这个通道不用每个项目单独装。装完刷新一下插件列表claude plugin reload如果这一步报plugin not found多半是 marketplace 缺失或过期先刷新再装claude marketplace refresh claude marketplace install anthropic/official刷新后重新执行claude plugin install anthropic/channel-telegram。有个常见的坑插件装完但命令不生效这时候别急着重装先把当前 Claude Code 会话完全退出再重启插件注册才会真正加载。4. 绑定 Telegram Bot 与启动通道插件就位后去 Telegram 里创建机器人。搜索BotFather点 Start依次输入/newbot然后给机器人起一个显示名比如Claude Code再给一个以bot结尾的用户名比如claude_code_bot。BotFather 会返回一串 bot token复制保存下一步要用。回到终端运行 Telegram 配置命令按提示粘贴 token/telegram:configure保存成功后会看到状态回显说明 token 已经写进插件配置。接着启动带 Telegram 监听器的 Claude Codeclaude --channel telegram现在切到手机 Telegram按用户名搜索你刚创建的机器人点 Start随便发一条消息。机器人会回一个 6 位配对码。把这个码拿回终端输入出现提示时批准配对。终端和 Telegram 两边都会显示Paired. Say hi to Claude.说明链路通了。配对完成后有个安全步骤不能省。默认情况下任何找到你机器人的人都能发起配对请求。运行/telegram:access把 DM 策略从pairing改成allow-list。改完之后只有已批准的发送者能和机器人交互陌生人发消息不会触发任何执行。这一步在多人共用或者机器人用户名比较容易被猜到时尤其重要。如果你想让队友或家人也能用同一个机器人让他们各自给机器人发消息你在终端逐个批准配对码即可不需要重复装插件。5. 验证请求手机发消息触发本地执行链路搭好做一次真实验证。在手机 Telegram 里给机器人发一条明确的任务比如在当前项目创建一个 index.html做一个数字产品的落地页完成后把文件路径告诉我发送后观察两个地方。终端这边Claude Code 会立刻开始工作你能看到它读取目录、创建文件、写入内容的日志。手机这边机器人会把执行进度和最终结果回传包括创建的文件路径。如果任务涉及浏览器预览它还能截图发回 Telegram你在手机上就能看到落地页长什么样。验证成功的标志有三个终端出现实际的文件操作日志、手机收到结果回传、本地项目目录里确实多了index.html。三个都满足说明从 Telegram 到本地 Claude Code 的完整链路是通的。这里有个默认行为要注意Claude Code 在创建文件或运行某些命令前会请求许可。也就是说任务跑到一半可能停下来等你回终端批准这跟远程操控的初衷有点冲突。如果你在可信环境里想让它完全无人值守可以这样启动claude --channel telegram --dangerously-skip-permissions这个标志会跳过所有权限提示等于把系统访问权完全交给 Agent存在 prompt 注入等安全风险只在你完全信任的环境和任务里用。想恢复之前的会话并带上这些标志claude --channel telegram --dangerously-skip-permissions --continue验证通过后日常用法就很灵活了让它整理桌面文件、抓一个网页的要点、跑一段脚本、装个依赖这些都能在手机上发一句话完成。6. 本篇常见错排查插件命令不生效装完插件后/telegram:configure没反应先claude plugin reload还不行就完全退出 Claude Code 会话再重启。插件注册在会话启动时加载热重载不一定覆盖所有命令。配对码收不到手机给机器人发消息后没有回码检查claude --channel telegram是否还在前台运行。这个进程一旦退出监听就断了机器人不会响应。建议用 tmux 或后台方式常驻。请求报鉴权失败多半是 settings.json 里的 Key 或基地址写错。确认ANTHROPIC_BASE_URL是https://taotoken.net/api不带多余路径和参数ANTHROPIC_AUTH_TOKEN是完整 Key没有多余空格。改完配置要重启 Claude Code 才生效。改了配置但走的还是旧通道环境变量优先级问题。检查系统里是否还有旧的ANTHROPIC_BASE_URL环境变量覆盖了 settings.json有的话清掉。多人配对后权限混乱确认已经把 DM 策略改成allow-list否则未批准的发送者仍可能触发配对流程。定期在/telegram:access里检查已批准列表。无人值守模式没生效--dangerously-skip-permissions必须和--channel telegram一起在启动命令里写在配置里不生效。另外这个标志只影响权限提示不影响 API 通道。排查顺序建议从进程是否存活、配置是否被覆盖、Key 是否有效这三层往下走大部分问题都出在前两层。7. 通道打通之后把 Telegram 接到 Claude Code 上本质是把「坐在终端前」这个约束解开了。你不再需要为了一个小改动专门回到电脑前手机发一句话本机执行结果回传整个闭环在聊天窗口里完成。配置层面记住三件事API 通道统一走 TaoToken 的基地址和 Key写在全局 settings.json 里插件用global作用域装一次就够安全上务必把 DM 策略锁成allow-list。这三步做完剩下的就是怎么用的问题了。如果你还没拿到 Key从 API Keys 页面创建一个https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入细节和字段说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite想先验证模型响应用模型对话页面发一条测试最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite长期跑编码任务、接 Agent 的直接上 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite最后给一个实用建议把claude --channel telegram放进 tmux 会话里常驻这样即使你关掉终端窗口监听也不会断手机随时发消息都能触发。真正让远程操控好用的不是配置多复杂而是这个进程一直在。
