工作原理
终端与手机之间的双向桥梁
功能
不仅仅是通知
推送通知
AI 代理完成 → 立即推送通知。无轮询，无延迟。
双向交互
从 Telegram 与 AI 代理聊天。查看活跃会话、发送提示、回答问题 — 无需触碰电脑。
多会话
同时管理多个 AI 代理会话 — 切换会话、并行监控、每会话独立上下文。
安装
2 步，30 秒
需要 Node.js ≥ 20。
创建 Bot Token
Telegram: 打开 @BotFather → /newbot → 复制 Token。
Discord: Developer Portal → New Application → Bot → 复制 Token。
Slack: Slack API → Create New App → From scratch → 命名应用并选择工作区 → OAuth & Permissions → 添加 chat:write 权限 → 滚动到 OAuth Tokens → 生成并复制 Bot User OAuth Token。
运行一个命令
$ npx -y ccpoke no config found — starting setup wizard... ┌ 🤖 ccpoke setup │ ◇ Language │ English │ ◇ Chat platform │ Telegram │ ◇ Bot Token │ ****:ABC-xxx │ ◇ ✓ Bot: @your_bot │ ◇ Scan QR or open link to connect: │ https://t.me/your_bot?start=setup │ ◆ ✓ Connected! │ ◇ Select AI agents (space to toggle) │ Claude Code, Cursor CLI │ ◆ Config saved · Hooks installed │ └ 🎉 Setup complete! ccpoke: hook server listening on localhost:9377 ccpoke: telegram bot started
安装向导自动处理一切 — hooks、Bot 连接、代理选择。日常使用建议全局安装：npm i -g ccpoke。
路线图
长期路线图
多平台 — 支持 Telegram、Discord、Slack。更多平台即将推出。
阶段 1 · 已完成
通知桥接
AI 代理完成时推送通知 — git diff，通过 Telegram Mini App 查看完整响应。支持 Claude Code 和 Cursor CLI，适用于 macOS、Linux、Windows。
阶段 2 · 已完成
双向聊天
从 Telegram 与 Claude Code 聊天 — 查看会话、发送提示、远程回答简单问题。单面板，仅支持 macOS 和 Linux。
阶段 3 · 已完成
智能回复
处理复杂的 AskUser 交互 — elicitation 表单、带描述的多选、结构化输入 — 全部通过手机。
阶段 4 · 已完成
多会话
同时管理多个 Claude Code 面板 — 切换会话、并行监控、每会话独立上下文。
阶段 5 · 开发中
终端控制
查看实时终端输出、截图、浏览文件、执行命令 — 全部通过 Telegram。
阶段 6
生态系统
插件系统、团队协作、Web 仪表板与使用分析，以及更多平台集成。