cc-connect:让 AI 编程助手随时随地在线

背景：AI 编程助手的”离线困境”

近两年，AI 编程助手（Claude Code、Cursor、Gemini CLI 等）已经成为许多开发者的日常工具。它们能写代码、做代码审查、分析数据、处理文档——只要坐在电脑前，效率提升是显而易见的。

但问题来了：你不可能一直坐在电脑前。

出门开会、通勤途中、临时起意想让 AI 帮你跑个脚本——这些场景下，你只能放弃，或者远程连回电脑操作。更麻烦的是，这些 AI 工具本质上是跑在本地的命令行程序，它们没有网页界面、没有移动端，天然地被”锁”在终端里。

cc-connect 就是为了打破这道墙而生的。虽然但是，身体第一，工作和生活的界限大家还是要守好。

它解决了什么问题

cc-connect 的核心思路很直接：在本地 AI Agent 和你惯用的即时通讯平台之间架一座桥。

手机/平板上的飞书、Telegram、微信...        ↕    cc-connect（运行在你的电脑上）        ↕  Claude Code / Gemini CLI / Codex...

这个桥解决了三类问题：

1. 移动访问问题你可以在任何有网络、有聊天 App 的地方，发消息给 AI Agent，就像和同事聊天一样。AI 的回复也会直接出现在对话框里。

2. 公网 IP 问题大多数人的电脑没有公网 IP，无法直接被外部访问。cc-connect 通过 WebSocket 长连接、Long Polling 等反向连接方式，让飞书、钉钉、Telegram、Discord 等平台无需公网 IP 即可接入。只有 LINE 和 Webhook 模式的企业微信才需要公网地址。

3. 多 Agent 协作问题你可以在同一个群聊里绑定多个 AI Bot，让 Claude 和 Gemini 互相交流，形成多 Agent 协作工作流，而不需要写任何编排代码。

支持范围

怎么安装

方式一：让 AI 帮你装（最省事）

把下面这句话发给 Claude Code 或任意 AI Agent：

Follow https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md to install and configure cc-connect.

AI 会读取安装文档并自动完成配置。

方式二：npm 全局安装

npm install -g cc-connect

方式三：下载二进制文件（Linux 示例）

curl -L -o cc-connect https://github.com/chenhg5/cc-connect/releases/latest/download/cc-connect-linux-amd64chmod +x cc-connectsudo mv cc-connect /usr/local/bin/

方式四：源码编译（需要 Go 1.22+）

git clone https://github.com/chenhg5/cc-connect.gitcd cc-connectmake build

怎么配置和运行

安装完成后，创建配置文件：

mkdir -p ~/.cc-connectcp config.example.toml ~/.cc-connect/config.tomlvim ~/.cc-connect/config.toml

配置文件中需要填写：你要使用的 AI Agent 类型、聊天平台的 Bot Token / App ID 等凭证。各平台的详细配置步骤在项目 docs/ 目录下有独立指南（feishu.md、telegram.md、slack.md 等）。

主要功能一览

连接成功后，你可以在聊天界面使用斜杠命令控制 Agent：

会话管理

/new [名称]      开启新会话/list            列出所有会话/switch <id>     切换会话/current         查看当前会话

权限模式

/mode            查看可用模式/mode yolo       全自动（所有工具自动批准）/mode default    手动确认模式

模型和 Provider 切换

/model           列出可用模型/model <别名>    切换到指定模型/provider list   列出 API Provider/provider switch <名称>  运行时切换

定时任务（自然语言描述）

/cron add 0 6 * * * Summarize GitHub trending

附件回传

当 AI Agent 在本地生成了图表、PDF、截图等文件，可以直接发回聊天窗口：

cc-connect send --image /path/to/chart.pngcc-connect send --file /path/to/report.pdf

使用时需要注意的事

1. 安全性是第一要务

cc-connect 实质上是把你电脑的操作权限暴露给了聊天平台。Bot Token 一旦泄露，任何拿到 Token 的人都能操控你的 AI Agent。 务必：

• • 不要把 Token 提交到 Git 仓库
• • 建议在聊天平台侧设置白名单，只允许你自己的账号发送指令
• • 非必要不使用 yolo 模式（全自动批准所有工具调用）

2. 公网 IP 的必要性因平台而异

大多数平台（飞书、钉钉、Telegram、Slack、Discord）使用反向连接，不需要公网 IP。但 LINE 和企业微信的 Webhook 模式需要公网可访问的地址，部署前要确认网络环境。

3. Beta 版功能更多但可能不稳定

项目提供 stable 和 beta 两个版本。Beta 版包含更多新功能，但稳定性未经充分验证：

npm install -g cc-connect@beta   # 安装 betacc-connect update --pre           # 更新到 beta

如果是生产环境或长期使用，建议优先用 stable 版本。

4. 多项目支持，配置别混淆

cc-connect 支持一个进程管理多个项目，每个项目可以独立绑定不同的 Agent 和平台。配置较多时，建议用清晰的命名约定区分各项目的配置块，避免 Token 和 Agent 类型配错。

5. 附件回传功能默认开启

attachment_send = "on" 是默认值，意味着 Agent 生成的文件会自动发回聊天。如果你不希望 AI 主动往群里发文件，可在配置文件中设为 "off"：

attachment_send = "off"

小结

cc-connect 做的事情说起来很简单：给本地 AI Agent 装上一个”聊天界面”。但它真正解决的，是 AI 编程工具从”桌前工具”变成”随身助理”的最后一公里问题。对于重度依赖 AI 辅助开发、同时又需要离开电脑的场景，这个工具值得一试。

项目地址：https://github.com/chenhg5/cc-connect许可证：MIT