用途
cc-connect 是一个桥接工具，把运行在本地机器上的 AI 编程智能体接入用户日常使用的即时通讯平台。它让用户不必守在终端前，通过聊天应用即可远程操控本地 AI 智能体，完成代码审查、研究、自动化、数据分析等任务。
主要能力
- 通用智能体支持：支持 10 种以上 AI 智能体，包括 Claude Code、Codex、Cursor Agent、Kimi CLI、Qoder CLI、Gemini CLI、OpenCode、iFlow CLI、Pi、Devin、Copilot，以及任何支持 Agent Client Protocol（ACP）的智能体。
- 多平台接入：支持 13 个聊天平台，包括飞书、WPS 协作、钉钉、Slack、Telegram、Discord、企业微信、微博、LINE、QQ、QQ Bot（官方）、Matrix，以及个人微信（Weixin personal ilink）。多数平台无需公网 IP。
- 多智能体编排：可在群聊中绑定多个机器人，让它们相互通信，例如向 Claude 提问、从 Gemini 获取见解，在同一对话中完成。
- 聊天内完整控制：通过斜杠命令切换模型（/model）、调整推理（/reasoning）、更改权限模式（/mode）、管理会话；使用 /dir <path> 切换目录（/cd <path> 为兼容别名），/dir <number> 或 /dir - 快速跳转历史。
- 持久记忆：通过 /memory 读写智能体指令文件，无需接触终端。
- 智能调度：用自然语言设置 cron 任务，例如“每天早上 6 点总结 GitHub 趋势”。
- 多模态支持：发送语音消息或截图，cc-connect 处理 STT/TTS 和多模态转发。
- 多项目架构：一个进程支持多个项目，每个项目可拥有自己的智能体与平台组合。
- 多语言界面：原生支持英语、简体中文、繁体中文、日语和西班牙语。
使用方式
- 安装 AI 智能体 CLI：至少安装一个要桥接的智能体，并确保其二进制文件在 PATH 中。Cursor Agent 和 OpenCode 需按官方安装页面操作。
- 认证智能体：每个智能体有各自的登录流程，需先交互式运行一次以存储凭据。
- 安装 cc-connect：可通过 Homebrew（macOS/Linux）、GitHub Releases 下载二进制文件，或从源码构建（需 Go 1.22+）。
- 启动并打开 Web UI：首次启动会打印类似 URL，在浏览器打开。若 9820 端口被占用，可传 --web-port 9821 或在 config.toml 设置 web_port。注意 cc-connect web 仅打开浏览器和配置界面，不启动服务，仍需在另一终端运行 cc-connect。
- 在 Web UI 配置平台机器人令牌：创建项目，添加至少一个平台，粘贴对应平台开发者控制台的机器人令牌，保存后 cc-connect 会热重载。
也可通过 AI 智能体安装配置（推荐），或手动配置。手动配置时，可在项目中设置 admin_from = "alice,bob" 允许特定用户 ID 运行特权命令（如 /dir 和 /shell），admin_from 必须放在 [[projects]] 下。使用 /whoami 或 /status 获取当前用户 ID。运行 /dir reset 可恢复配置的 work_dir 并清除持久化覆盖。
适用场景
- 远程通过手机或平板与本地 AI 编程助手交互。
- 在群聊中协调多个 AI 智能体协同工作。
- 通过自然语言设置定时任务，自动执行总结、检查等操作。
- 需要在不暴露公网 IP 的情况下接入聊天平台。
- 多项目并行开发，每个项目使用不同智能体与平台组合。
限制
- 必须先安装并认证至少一个 AI 智能体 CLI，否则 cc-connect 会退出并提示找不到 CLI。
- 企业微信 Webhook 模式需要公网 URL；长连接/WS 风格设置通常不需要。
- 语音功能需在 config.toml 中启用 [speech] / TTS 提供商。
- OS 用户隔离（run_as_user）目前仅 Claude Code 支持，且需目标用户具备无密码 sudo 等条件。
- 附件发送默认上限 50 MiB，可通过 max_attachment_size_mb 或环境变量调整。
- 会话在长时间不活动后自动轮换（默认 30 分钟），可通过 reset_on_idle_mins = 0 关闭。
- 部分平台（如 QQ NapCat/OneBot）为非官方自托管桥接，行为取决于 NapCat/网络设置。
- 具体收费、价格、平台完整支持矩阵等细节暂未提供。
