CC-Connect 使用教程

📖 项目简介

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

💡

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

✨ 核心亮点

🤖

7大 AI Agent

Claude Code、Cursor、Gemini CLI、Codex、Qoder、OpenCode、iFlow

📱

10大聊天平台

飞书、钉钉、Telegram、Slack、Discord、企业微信、LINE、QQ 等

🌍

无需公网IP

大部分平台使用 WebSocket/长轮询，无需暴露公网

🎮

完整聊天控制

切换模型、权限模式、会话管理，全通过聊天命令完成

📊 支持矩阵

AI Agent 支持

Agent	状态
Claude Code	✅ 支持
Codex (OpenAI)	✅ 支持
Cursor Agent	✅ 支持
Gemini CLI	✅ 支持
Qoder CLI	✅ 支持
OpenCode	✅ 支持
iFlow CLI	✅ 支持

聊天平台支持

平台	连接方式	需要公网IP
飞书 (Lark)	WebSocket	❌ 不需要
钉钉	Stream	❌ 不需要
Telegram	Long Polling	❌ 不需要
Slack	Socket Mode	❌ 不需要
Discord	Gateway	❌ 不需要
企业微信	WebSocket / Webhook	WS不需要
LINE	Webhook	⚠️ 需要
QQ	WebSocket	❌ 不需要

🚀 安装步骤

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

                bash
                npm install -g cc-connect
            

方式二：下载二进制文件

                bash
                # Linux amd64
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+）

                bash
                git clone https://github.com/chenhg5/cc-connect.git
cd cc-connect
make build
            

✅

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

⚙️ 配置说明

创建配置目录

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

编辑配置文件

在 config.toml 中配置你要使用的聊天平台和 AI Agent。每个项目可以绑定不同的 Agent + 平台组合。

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

启动服务

./cc-connect

然后在你的聊天 App 中就可以和 AI Agent 对话了！

💬 常用命令

会话管理

                /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 即可自动更新。