Claude Code Telegram Bot 是一套把 Telegram 与 Claude Code 连通的机器人系统，采用 MIT 许可，当前版本 1.0.0。它让用户通过自然语言在手机上远程操作代码库，无需终端命令即可分析、修改与解释代码。
一、项目简介
该项目由作者 RichardAtCT 维护，基于 Python 与 Claude Code CLI，把对话式界面接入代码库，并按项目自动保存会话上下文。仓库地址 https://github.com/RichardAtCT/claude-code-telegram 。
二、项目功能
1. 自然语言操作代码
用日常语言让 Claude 分析、修改或解释代码，无需记忆命令。
2. 上下文保持
按项目自动持久化会话，跨对话保持上下文，减少重复说明。
3. 随时随地编码
在任何装有 Telegram 的设备上远程访问项目，适合外出时处理紧急改动。
4. 通知与安全
可接收来自 Webhook、定时任务与 CI/CD 的主动通知，并内置鉴权、目录沙箱与审计日志。
三、项目亮点
该机器人把 Claude Code 装进了口袋，MIT 开源便于自建。目录沙箱与审计日志让远程操作更可控。
对比远程方式
对比该机器人和 SSH 远程登录的区别，差异在交互方式。机器人用自然语言对话，SSH 需要终端命令与手动操作。
| 对比项 | Claude Code Telegram | SSH 远程 |
|---|---|---|
| 交互方式 | 自然语言对话 | 终端命令 |
| 上下文 | 自动保持 | 需自行管理 |
| 上手难度 | 较低 | 较高 |
四、项目结构
项目为 Python 工程，机器人逻辑、命令处理与会话存储分层组织，配置与鉴权模块独立，便于按需调整。
五、技术栈
- 开发语言 Python 3.11 及以上
- 依赖 Claude Code CLI
- 对接 Telegram Bot API
- 许可 MIT
项目由作者 RichardAtCT 维护，最后更新 2026 年，版本持续迭代，更新日志见 GitHub 提交历史。仓库地址 https://github.com/RichardAtCT/claude-code-telegram 。
六、本地快速部署启动
方式一 准备环境
安装 Python 3.11 及以上与 Claude Code CLI，并向 BotFather 申请 Telegram Bot Token。
方式二 安装与配置
执行 git clone https://github.com/RichardAtCT/claude-code-telegram.git 克隆后，按文档安装依赖并填入 Bot Token 与允许访问的目录。
方式三 启动与使用
启动机器人服务后，在 Telegram 中与机器人对话即可远程操作项目代码。
国内加速与备份
国内访问较慢时可用 ghfast.top 等镜像加速前缀，更详细的部署说明可扫码获取本站备份。备份包版本 v1.0.0，文件校验 sha256 3259efb81984589f5779abccf94025bc1703984d7e7f6924c335ab1397bf1083 。
适用场景与建议
适用场景方面，它适合经常出差或不便打开电脑的开发者，用手机就能查看与修改项目；也适合团队把它接到 CI 通知，主动推送构建与部署结果。建议为目录沙箱设置最小可访问范围，并定期检查审计日志。若项目涉及敏感代码，应限制允许访问的目录并妥善保管机器人令牌，降低远程操作风险。
七、项目代码地址
项目代码地址 https://github.com/RichardAtCT/claude-code-telegram 。
常见问题
问. 这个机器人是做什么的
它把 Telegram 与 Claude Code 连通，用自然语言远程操作代码库。
问. 怎么快速上手使用
准备好 Python 与 Bot Token，克隆项目安装配置后启动即可对话使用。
问. 和 SSH 有什么区别
对比 SSH 远程登录，该机器人用自然语言对话且自动保持上下文，更易上手。
问. 是否开源免费
项目以 MIT 协议开源，免费自用，需自备 Bot Token 与模型额度。
