CC-Connect 介绍与使用指南

在任何聊天工具里，远程操控你的本地 AI Agent

CC-Connect 是一个开源项目，它把运行在你本地机器上的 AI Agent 桥接到日常使用的即时通讯工具中。无论你身在何处，都可以通过手机、平板或任何有聊天应用的设备来控制你的 AI Agent。

核心特性

🤖 多 Agent 支持

支持 10+ 种主流 AI Agent，包括：

Agent	说明
Claude Code	Anthropic 官方 CLI 工具
Codex	OpenAI 官方编码 Agent
Cursor Agent	Cursor IDE 内置 Agent
Gemini CLI	Google AI CLI 工具
Kimi CLI	月之暗面 Kimi CLI
Qoder CLI	Qoder 编码 Agent
OpenCode	Crush 出品的开源 Agent
iFlow CLI	iFlow 编码助手
Pi	Cursor 后台 Agent
ACP 兼容 Agent	通过 Agent Client Protocol 接入任意 Agent

📱 多平台覆盖

支持 11 大聊天平台，大部分无需公网 IP：

平台	连接方式	公网 IP
飞书	WebSocket	❌
钉钉	Stream	❌
Telegram	Long Polling	❌
Slack	Socket Mode	❌
Discord	Gateway	❌
微博	WebSocket	❌
企业微信	WebSocket	❌
微信个人号（ilink）	HTTP 长轮询	❌
QQ	WebSocket	❌
LINE	Webhook	✅

🔄 多机器人中继

在群聊中绑定多个机器人，让它们相互协作。例如：先问 Claude 的回答，再听 Gemini 的见解。

🧠 持久化记忆

直接在聊天中读写 Agent 的指令文件（/memory），无需回到终端。

⏰ 智能定时任务

使用自然语言创建 cron 任务。例如：“每天早上 6 点总结 GitHub trending”

🎮 完整聊天控制

通过斜杠命令完成所有操作：

/new [名称]        创建新会话
/list              列出所有会话
/switch <id>       切换会话
/mode              查看权限模式
/mode yolo         自动批准所有工具
/model             列出可用模型
/model switch <alias>  切换模型
/dir <路径>        切换工作目录
/provider list     列出 Provider
/cron add          添加定时任务

快速开始

通过 AI Agent 安装（推荐）

让 AI Agent 帮你完成整个安装过程：

请参考 https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md 帮我安装和配置 cc-connect

手动安装

npm 安装：

npm install -g cc-connect

Homebrew（macOS / Linux）：

brew install cc-connect

从 GitHub Releases 下载：

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

配置

推荐使用 Web UI 配置（见下文）。手动配置：

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

运行

cc-connect

升级

# npm
npm install -g cc-connect

# Homebrew
brew upgrade cc-connect

# 二进制自更新
cc-connect update           # 稳定版
cc-connect update --pre     # 含预发布版本

Web 管理后台

v1.3.0 新增 — 内置全功能可视化管理界面，无需额外依赖。

功能：

✅ 项目增删改查
✅ 服务商管理
✅ 会话监控
✅ 定时任务编辑
✅ 直接在浏览器里和 Agent 对话
🌐 支持 5 种语言 (en/zh/zh-TW/ja/es)

使用：

cc-connect web    # 配置并打开管理后台
cc-connect        # 启动服务

核心功能详解

会话管理

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

开启空闲自动新建会话：

[[projects]]
reset_on_idle_mins = 60

工作目录切换

/dir                         查看当前目录与历史
/dir <路径>                  切换到指定目录
/dir <序号>                  按历史序号切换
/dir -                       返回上一个目录
/dir reset                   恢复配置中的 work_dir
/cd <路径>                   /dir 的兼容别名

权限模式

/mode              查看可用模式
/mode yolo         自动批准所有工具（无需确认）
/mode default      每次工具调用前询问

Provider 管理

/provider list              列出所有 Provider
/provider switch <名称>     运行时切换 API Provider

模型选择

/model                      列出可用模型
/model switch <alias>       按别名切换模型

定时任务

/cron add 0 6 * * * 帮我总结 GitHub trending

Agent 回传文件

当 Agent 生成了截图、图表、PDF 等文件时，可以主动发回当前聊天：

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

配置控制（默认开启）：

attachment_send = "on"   # 或 "off" 禁用

用户隔离 (run_as_user)

在 Linux/macOS 上，可以以另一个 Unix 用户身份启动 Agent，实现文件系统级别隔离：

[[projects]]
name = "claude-sandboxed"
run_as_user = "partseeker-coder"
run_as_env = ["PGSSLROOTCERT"]

审核配置：

cc-connect doctor user-isolation

生命周期事件钩子

v1.3.0 新增 — 支持在事件触发时执行 Shell 或 HTTP Webhook：

[[hooks]]
event = "message.created"
action = "shell"
command = "echo 'New message from {{user_id}}'"

事件类型：message.created、message.sent、session.start、session.end、cron.triggered、auth.request、error

平台接入指南

平台	文档	连接方式
飞书	docs/feishu.md	WebSocket
钉钉	docs/dingtalk.md	Stream
Telegram	docs/telegram.md	Long Polling
Slack	docs/slack.md	Socket Mode
Discord	docs/discord.md	Gateway
微博	docs/weibo.md	WebSocket
企业微信	docs/wecom.md	WebSocket / Webhook
微信个人号（ilink）	docs/weixin.md	HTTP 长轮询
QQ	docs/qq.md	WebSocket

平台能力对照

能力	飞书	钉钉	Telegram	Slack	Discord	微信
文本与斜杠命令	✅	✅	✅	✅	✅	✅
Markdown / 卡片	✅	✅	✅	✅	✅	✅
流式回复	✅	✅	✅	✅	✅	✅
图片与文件	✅	✅	✅	✅	✅	✅
语音 / TTS	⚠️	⚠️	✅	⚠️	⚠️	✅
私聊	✅	✅	✅	✅	✅	✅
群聊	✅	✅	✅	✅	✅	✅

更新日志

v1.3.0 主要更新

🌐 Web 管理后台 — 可视化配置，内置浏览器对话
🔗 生命周期事件钩子 — Shell / HTTP Webhook 触发
🎯 技能管理 — /skills 页面，预设技能浏览
🌍 全局服务商管理 — 支持从 cc-switch 导入
💬 微信个人号支持 — ilink 长轮询，无需公网 IP
📱 微博私信 — WebSocket，微信体验
✈️ 飞书增强 — @提及、多级回复、Emoji 反应
🤖 新增 Agent — Kimi CLI、Pi agent

目录