CC-Connect 使用教程

项目简介

CC-Connect 是一个将本地 AI 编程助手（Claude Code、Cursor、Gemini CLI、Codex 等）桥接到聊天平台（飞书、钉钉、Telegram、Slack、Discord、企业微信等）的开源工具。让你在手机上通过聊天消息，远程控制电脑上的 AI Agent 编写代码、审查代码、执行任务——随时随地，无需公网 IP。

💡
GitHub 地址：
https://github.com/chenhg5/cc-connect

核心亮点

支持矩阵

AI Agent 支持

聊天平台支持

安装步骤

方式一：通过 npm 安装（推荐）

npm install -g cc-connect

方式二：下载二进制文件

# Linux amd64curl -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

✅
AI 辅助安装：把 https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md 发给 Claude Code 或任意 AI Agent，它会自动帮你安装配置！

配置说明

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

[[projects]]name = "my-project"agent = "claude-code"platform = "telegram"work_dir = "/path/to/your/project"admin_from = "your_telegram_id"

./cc-connect

常用命令

会话管理

/new [名称]         创建新会话/list               列出所有会话/switch <id>        切换会话/current            查看当前会话/dir [路径|reset]    切换工作目录

模型与模式

/model              列出可用模型/model switch <名称>  切换模型/mode               查看可用模式/mode yolo          全自动模式

定时任务

/cron add 0 6 * * * 每天早上6点总结GitHub趋势

常见问题

Q: 需要公网 IP 吗？

大部分平台（飞书、钉钉、Telegram、Slack、Discord）都不需要公网 IP，使用 WebSocket 或长轮询方式连接。只有 LINE 需要 Webhook 公网 URL。

Q: 支持哪些 AI Agent？

目前支持 7 种：Claude Code、Codex（OpenAI）、Cursor Agent、Gemini CLI、Qoder CLI、OpenCode、iFlow CLI。可以同时配置多个 Agent，在聊天中自由切换。

Q: 可以在一个群里用多个 Agent 吗？

可以！CC-Connect 支持多 Bot 接力（Multi-Bot Relay），在群聊中绑定多个 Bot，让它们互相沟通。比如问 Claude 一个问题，再让 Gemini 给出不同角度的见解。

Q: 如何升级？

npm 安装用 npm install -g cc-connect，二进制版本用 cc-connect update 即可自动更新。