开篇吐槽
你是否经历过这样的尴尬时刻:
Claude Code 正在帮你写代码,突然有个问题要讨论,但你得切出去打开浏览器,或者掏出手机在 Discord 里戳一下?就像两个人在开会,其中一个得跑到隔壁房间才能说话。
如果你点过头,那么我有个好消息:有个神奇的项目叫 cc-connect,它干了一件看似简单但价值巨大的事——让你能在任何地方和你的 AI 编程助手聊天。
这个项目到底是什么?
简单来说,cc-connect 是一座桥梁。它的一端连接着你本地的 AI 编程工具(Claude Code、Cursor、OpenAI Codex 等),另一端连接着你常用的各种聊天平台(Feishu、钉钉、Slack、Telegram、Discord 等)。
想象一下:你的 AI 编程助手不再是个"宅男",整天待在你的 IDE 里,而是被"传送"到了各个聊天平台,可以和你在任何地方"碰面"。
为什么这个项目这么 cool?
1. 无需公网 IP 的魔法
这是 cc-connect 最牛的地方。大多数 AI 编程工具都是本地运行的,想要在外面用它们,通常得:
- 部署到服务器上(需要公网 IP)
- 配置 VPN(麻烦)
- 使用云服务(花钱)
但 cc-connect 用了个骚操作——它支持的大部分平台都采用 WebSocket 或长轮询的方式,意思是:连接是由你的本地机器主动发起的。你不需要等别人来敲门,而是你主动打电话。
| 平台 | 连接方式 | 需要公网 IP? |
|---|---|---|
| Feishu / Lark | WebSocket | ❌ 不需要 |
| 钉钉 | Stream | ❌ 不需要 |
| Telegram | Long Polling | ❌ 不需要 |
| Slack | Socket Mode | ❌ 不需要 |
| Discord | Gateway | ❌ 不需要 |
| LINE | Webhook | ✅ 需要 |
| 企业微信 | Webhook | ✅ 需要 |
对于大多数人来说,这意味着开箱即用。你的笔记本电脑、台式机,甚至树莓派都能跑。
2. 支持多个 AI 编程工具
不仅仅是 Claude Code,目前已支持:
- Claude Code ✅
- OpenAI Codex ✅ (Beta)
- Google Gemini CLI 🔜 规划中
- 还有一堆其他的工具在探索中
这意味着无论你用什么工具,都有可能接入 cc-connect 的生态。
3. 权限管理不是摆设
cc-connect 继承了 Claude Code 的权限模式,支持多种权限级别:
/mode # 查看当前权限模式
/mode default # 默认模式:每个工具调用都需要批准
/mode acceptEdits # 文件编辑自动通过,其他还需批准
/mode plan # 仅计划模式:AI 只提建议,你来执行
/mode yolo # YOLO 模式:完全信任,自动执行
你可以根据场景灵活切换。在办公室用 default 谨慎一点,夜里赶工期可以 yolo 一下。
4. 会说话的 AI(Beta 功能)
最新版本还支持语音转文字功能。在 Feishu、钉钉、Telegram 等平台发送语音消息,cc-connect 会调用 Whisper API 自动转录,然后把文字传给 AI。
就像你突然有了一个能听懂你的 AI,而不是非得打字。这对开发者来说真是解放双手的好东西。
架构有多优雅?
打开项目代码,你会发现它的设计相当清爽:
┌──────────────┐ ┌────────────┐ ┌──────────────┐
│ Feishu/钉钉 │◄───►│ Engine │◄───►│ Claude Code │
│ Slack/... │ │ (Router) │ │ Cursor/... │
└──────────────┘ └────────────┘ └──────────────┘
Platform Core Agent
采用接口驱动设计:
- Platform 接口:适配各种聊天平台
- Agent 接口:适配各种 AI 工具
- Engine 核心:负责路由和会话管理
这样做的好处是什么?扩展性爆表。想加个新平台或新 AI 工具?只需实现对应的接口,然后注册上去就行,核心逻辑一行都不用改。
会话管理,体验无敌
cc-connect 的会话管理超级贴心:
/new [name] # 开启新的对话会话
/list # 列出所有会话
/switch <id> # 切换到某个会话
/current # 查看当前会话信息
/history [n] # 看最近 n 条消息
/stop # 停止正在运行的任务
每个用户都有独立的会话,完整的对话历史。你可以在 Slack 上开了一个会话,然后在 Telegram 上继续。上下文完全保留,就像在同一个地方聊天。
配置有多友好?
拿出 config.example.toml 看一眼,你会发现这根本就是配置即文档:
# 比如想接入 Feishu
[[projects]]
name = "my-backend"
[projects.agent]
type = "claudecode"
[projects.agent.options]
work_dir = "/path/to/backend"
mode = "default"
[[projects.platforms]]
type = "feishu"
[projects.platforms.options]
app_id = "cli_xxxx"
app_secret = "xxxx"
一个 TOML 文件,清清楚楚。而且项目提供了每个平台的详细设置指南,跟着文档走,小学生都能配置好。
甚至还有更骚的操作——AI 代理辅助安装。你可以把安装指南扔给 Claude Code,让它帮你完成整个安装和配置过程。这简直是"元编程"的绝妙体现。
高级玩法:提供商管理
最新版本加入了一个相当实用的功能——运行时切换 API 提供商,无需重启。
[[projects.agent.providers]]
name = "anthropic"
api_key = "sk-ant-xxx"
[[projects.agent.providers]]
name = "relay"
api_key = "sk-xxx"
base_url = "https://api.relay-service.com"
然后在聊天里:
/provider list # 看有哪些提供商
/provider switch 1 # 换到第 1 个
这对于需要在不同 API 服务间切换的开发者来说,简直是救星。你甚至可以从 cc-switch 一键导入已有的配置。
安装有多简单?
三种方式任选:
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
装好后,一个命令启动:
cc-connect # 自动找配置文件
cc-connect -config /path/to/config.toml # 指定配置文件
谁应该用这个项目?
- 远程开发者 —— 不在办公室也能和 Claude Code 协作
- 团队协作 —— 通过 Slack 或钉钉和团队分享 AI 的建议
- 多设备工作者 —— 在手机、平板、各台电脑间切换,会话无缝衔接
- 对隐私有要求的开发者 —— 代码完全留在本地,只有消息通过平台中转
- 喜欢折腾的开发者 —— 架构清爽,扩展性强,改改代码就能加新平能
社区和维护
项目还比较新(v1.0.1 刚发布),但代码质量不错:
- 清晰的架构和接口设计
- 详细的中英文文档
- 支持的平台和工具在不断增加
- Issue 和 Pull Request 都欢迎
虽然目前星数不算很多(14 个 star),但这根本不影响它的价值。好东西不怕没人用,最怕用的人不知道。
最后的话
cc-connect 的核心思想其实很简单:让本地 AI 编程工具无缝接入你的工作流。但实现这个想法的过程却需要:
- 了解各平台的通信协议和 API
- 巧妙设计让平台和 AI 工具完全解耦
- 考虑到权限、会话、上下文等各种细节
这样的项目就是开源生态的精华——解决真实问题,代码精良,文档完善,易于扩展。
如果你用 Claude Code、Cursor 或其他 AI 编程工具,真的值得花 10 分钟了解一下 cc-connect。说不定它能彻底改变你的开发体验。
一句话总结:它是本地 AI 编程工具和聊天平台之间缺失的那一环。
相关链接
- GitHub 仓库:chenhg5/cc-connect
- 快速开始:按照
INSTALL.md或直接问 Claude Code - 平台设置指南:每个平台都有专门的文档
- 配置示例:
config.example.toml包含了所有可能的配置项
如果你有任何问题或建议,欢迎提 Issue 或 PR。开源社区就是在互相帮助中前进的。