cc-connect: 把你的 AI 编程助手装进口袋
在任意聊天软件中控制本地 AI Agent
本文介绍 cc-connect,一个让 AI 编程助手与即时通讯平台无缝对接的开源工具。
一、为什么你需要 cc-connect?
想象一下这些场景:
- • 🚇 在地铁上用手机给 Claude Code 发消息,让它帮你 review 代码
- • 🏠 周末在家用微信直接让 AI 帮你排查生产环境 bug
- • ✈️ 出差时通过钉钉让 Agent 帮你跑测试、写文档
这就是 cc-connect 要解决的问题:让你随时随地通过任意聊天软件控制本地运行的 AI 编程助手。
二、cc-connect 是什么?
cc-connect 是一个开源桥梁工具,它将本地运行的 AI 编程 Agent 连接到各种即时通讯平台。
┌─────────────────────────────────────────────────────────────┐
│ 你的消息平台 │
│ (微信/飞书/钉钉/Telegram/Slack/Discord/QQ) │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ cc-connect 桥接器 │
│ 将消息转发给本地 AI Agent │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 本地 AI Agent │
│ (Claude Code / Codex / Cursor / Gemini CLI / OpenCode) │
└─────────────────────────────────────────────────────────────┘
三、支持的功能矩阵
🤖 支持的 AI Agent(7 种)
| Agent | 状态 |
|---|---|
| Claude Code | ✅ 支持 |
| Codex (OpenAI) | ✅ 支持 |
| Cursor Agent | ✅ 支持 |
| Gemini CLI (Google) | ✅ 支持 |
| Qoder CLI | ✅ 支持 |
| OpenCode (Crush) | ✅ 支持 |
| iFlow CLI | ✅ 支持 |
💬 支持的聊天平台(10 种)
| 平台 | 文本 | Markdown | 图片/文件 | 语音 | 群聊 | 私聊 | 需要公网IP |
|---|---|---|---|---|---|---|---|
| 飞书 | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ |
| 钉钉 | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ |
| Telegram | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| Slack | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ |
| Discord | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ |
| LINE | ✅ | ⚠️ | ⚠️ | ❌ | ⚠️ | ✅ | ⚠️ |
| 企业微信 | ✅ | ⚠️ | ✅ | ⚠️ | ✅ | ✅ | ❌ |
| 微信(个人) | ✅(beta) | ✅(beta) | ✅(beta) | ✅(beta) | ✅(beta) | ✅(beta) | ❌ |
| ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | |
| QQ Bot | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ |
✅ = 完全支持 | ⚠️ = 部分支持 | ❌ = 不支持
四、核心特性
1. 随时随地控制
不再局限于终端。无论你在手机上、平板上,只要能发消息,就能指挥你的 AI 助手。
2. 无需公网 IP
大多数平台使用 WebSocket/长连接模式,不需要暴露你的服务器到公网。飞书、钉钉、Telegram、Slack、Discord 都支持。
3. 多 Agent 切换
一个进程可以连接多个 AI Agent。在群里问 Claude一个问题,再让 Gemini 回答另一个——它们可以互相交流。
4. 完整的会话管理
/new [name] # 开始新会话
/list # 列出所有会话
/switch <id> # 切换会话
/dir <path> # 切换工作目录
5. 定时任务 (Cron)
用自然语言设置定时任务:
/cron add 0 6 * * * 每天早上6点总结GitHubTrending
6. 模式切换
/mode yolo # 自动批准所有工具
/mode default # 每个工具都询问
7. 发送图片/文件
Agent 生成图片后,可以直接发回聊天窗口:
cc-connect send --image /path/to/chart.png
cc-connect send --file /path/to/report.pdf
五、安装与配置
安装方式
# 方式一:npm(推荐)
npm install -g cc-connect
# 方式二:下载二进制
curl -L -o cc-connect https://github.com/chenhg5/cc-connect/releases/latest/download/cc-connect-linux-amd64
chmod +x cc-connect
sudo mv cc-connect /usr/local/bin/
# 方式三:源码编译(需要 Go 1.22+)
git clone https://github.com/chenhg5/cc-connect.git
cd cc-connect
make build
配置
# 创建配置目录
mkdir -p ~/.cc-connect
# 复制配置模板
cp config.example.toml ~/.cc-connect/config.toml
# 编辑配置
vim ~/.cc-connect/config.toml
配置示例(飞书)
[project.my_project]
agent = "claude-code" # 使用的 Agent
platform = "feishu" # 消息平台
[platform.feiuhs]
type = "feishu"
app_id = "你的AppID"
app_secret = "你的AppSecret"
verification_token = "你的VerificationToken"
encrypt_key = "你的EncryptKey" # 可选
六、各平台详细配置
飞书 (Feishu)
- 1. 打开 https://open.feishu.cn/
- 2. 创建企业自建应用
- 3. 添加权限:
im:chat:readonly,im:chat:send_as_bot,im:message:send_as_bot - 4. 创建事件订阅:
im.message.receive_v1 - 5. 获取 App ID、App Secret、Verification Token
- 6. 将机器人添加到群聊
Telegram
- 1. @BotFather 创建机器人
- 2. 获取 Bot Token
- 3. 配置 cc-connect
钉钉
- 1. 钉钉开放平台创建应用
- 2. 添加机器人
- 3. 获取 App Key、App Secret
微信个人版 (Beta)
需要安装 beta 版本:
npm install -g cc-connect@beta
微信使用 ilink 长连接模式,不需要公网 IP,扫码即可登录。
七、使用示例
启动
cc-connect
常用命令
# 查看当前会话
/current
# 切换模型
/model switch claude-3-5-sonnet
# 切换工作目录
/dir /path/to/project
# 添加定时任务
/cron add 0 8 * * * 发送天气提醒
八、为什么选择 cc-connect?
| 特性 | cc-connect | 其他方案 |
|---|---|---|
| 支持平台数 | 10+ | 1-3 |
| 支持 Agent 数 | 7 | 1-2 |
| 无需公网IP | ✅ | ❌ |
| 开源免费 | ✅ | ❌ |
| 中文支持 | ✅ | ⚠️ |
九、总结
cc-connect 为开发者提供了一个强大而灵活的解决方案,让 AI 编程助手不再局限于终端。无论你是在通勤路上、出差途中,还是 просто 不想开电脑,都能通过熟悉的聊天软件与 AI 助手无缝协作。
立即体验:
- • GitHub: https://github.com/chenhg5/cc-connect
- • Discord: https://discord.gg/kHpwgaM4kq
- • Telegram: https://t.me/+odGNDhCjbjdmMmZl
🐋 本文由蓝小鲸编写 | 关注 AI + 开发者工具
夜雨聆风