目录

完整教程:如何将 Claude Code 接入 Telegram 打造专属 AI 编程助手

Claude Code 的强大处理能力和代码理解力不应只局限在你的本地终端环境。如果你想在手机上也能随时随地指挥你的 AI 代码助手,将它接入国民级跨平台通讯工具 Telegram 绝对是极佳的选择。

最近,通过官方支持的 Telegram 插件,我们可以轻松把本地运行的 Claude Code 服务映射为专属聊天机器人。今天,我们就来手把手梳理一次如何零代码为 Claude Code 接入 Telegram 机器人,体验随时发送指令的高效流。

以下是完整的图文配置教程:

1. 注册专属 Telegram 机器人并获取 Token

第一步,我们需要在 Telegram 创建一个"通信壳",用来和你的 Claude Code 服务建立连接传递消息:

  • 在 Telegram 中搜索并进入专门管理机器人的官方入口:BotFather
  • 向 BotFather 发送指令 /newbot,系统将提示你给新机器人起个显示名称,以及一个 用户名(username)
  • 请注意,用户名必须是以 bot 结尾(比如 MyClaudeHelperBot)。
  • 创建成功后,BotFather 会给你返回一大段文本,其中包含最重要的配置秘钥 —— Token (形如 8706275634:AAHfiqksKZ8...)。请妥善复制并保管这串字符,千万不要泄露给别人。

2. 在 Claude Code 中安装并配置 Telegram 插件

拿到机器人身份标识后,下一步就该让 Claude Code (简称为 cc) 接收处理这些消息了。

  • 在终端中运行启动 Claude Code 环境。
  • 在对话行中输入指令 /plugin 呼出插件管理器界面。
  • 在插件市场中搜索关键字 telegram
    • 如果你还没安装过,它会在 Discover (发现) 列表中出现,点击进行安装即可。
    • 如果安装过,则会在 Installed (已安装) 列表中显示。
  • 填入 Token:将刚拿到的 Telegram Token 授予插件。你有两种做法:
    • 直接输入精确指令:/telegram:configure <你的Token>
    • 也可以像日常那样直接对 Claude Code 说话:“帮我配置一下 telegram,token 是 12345...”。

3. 重启并加载插件通道服务

为了让本地启动的 Claude Code 开放指定的网络监听通道,你需要重启一次服务。 请退出当前 cc 会话,并输入以下命令重启:

claude --channels plugin:telegram@claude-plugins-official

重启完成后,你就可以在 cc 的环境上下文里正常使用以 /telegram 开头的各种后台控制命令了。

4. 将 TG 账号与机器人配对绑定 (Pairing)

连通网络通道后,最核心的问题来了:如何保证你在使用呢?对此官方通过了一次性配对码机制来验证。

  • 回到手机或桌面端 Telegram,全局搜索你刚刚创建的机器人名称(即带 bot 结尾的用户名),发起私聊。
  • 发送任意消息尝试唤醒,它会直接给你回复一个 6位数的配对验证码 (pairing code)
  • 接着切换回你电脑上的 cc 终端,输入以下配对指令:
/telegram:access pair xxxx  # 把 xxxx 替换为你取得的配对码

配对成功后,Claude Code 会主动给你发一条确认提示,这意味着两端已经成功握手绑定。你可以开始愉快地在 TG 上发号施令了!

5. 进阶推荐:为机器人增加白名单锁

既然是可以编写代码与读取文件系统的 AI,安全性绝对是不容忽视的一环!如果外人误打误撞搜到了你的机器人并且输入命令该怎么办?

除了你刚才成功的 Pair 配对,非常建议你启用最高级别的“仅限白名单”安全策略。 在终端里输入这条指令:

/telegram:access policy allowlist

一旦开启,该机器人将变为“高冷模式”:它只处理与你个人 TG 账号(即 Allowlist 名单内成员)绑定的会话,任何人哪怕知道了机器人名字也无法和你的个人代码环境通信,完美打消安全顾虑。


结语

恭喜体验达成!现在,你可以随时随地在 Telegram 上召唤你最强的代码伙伴 CC,不管是在沙发上突发各种架构灵感,还是通勤路上要执行预设终端脚本,简单发送消息就能轻松拉起。赶紧试一试,开启移动端 AI 编程的新篇章吧!