chenhg5/cc-connect

项目介绍

cc-connect 是一个 Go 服务，位于本机运行的 AI 编程代理与常用即时通讯平台之间。它把 Claude Code、Codex、Cursor Agent、Gemini CLI、Kimi CLI、OpenCode 以及任意兼容 ACP 的代理，接入飞书、钉钉、Slack、Telegram、Discord、企业微信、LINE、Matrix 等聊天工具。你在聊天里发消息，cc-connect 转给本地代理 CLI，再把结果流式回传到会话中。

架构上平台适配器与代理适配器分离，一个进程可以承载多个项目，每个项目组合不同的代理和平台。多数平台走 WebSocket、长轮询或 Socket Mode，通常不需要公网 IP；LINE 的 Webhook 和企业微信的 Webhook 模式是例外。

快速使用

安装顺序不能颠倒：代理 CLI 必须先安装并完成登录，否则 cc-connect 会以 claudecode: claude CLI not found in PATH 之类的错误退出。

1. 安装至少一个代理 CLI，例如 npm install -g @anthropic-ai/claude-code 或 npm install -g @openai/codex，再用 claude --version 确认可执行文件在 PATH 中。
2. 交互式登录，例如 claude login。
3. 安装 cc-connect：npm install -g cc-connect、brew install cc-connect、从 GitHub Releases 下载二进制，或用 Go 1.22+ 执行 make build 自行构建。
4. 运行 cc-connect。首次启动会创建 ~/.cc-connect/config.toml，并打印形如 http://localhost:9820 的 Web 管理地址。
5. 在 Web 界面新建项目、添加平台，粘贴对应平台开发者后台的机器人 token 并保存。配置会热加载，之后给机器人发消息即可把任务转给本地代理。

cc-connect web 只负责打开配置界面，服务本身仍需另开终端运行 cc-connect。也可以手动复制 config.example.toml 到 ~/.cc-connect/config.toml 进行配置，各平台步骤见平台配置指南，例如 飞书 和 Telegram。

运行与权限

会话控制通过聊天里的斜杠命令完成：/new、/list、/switch 管理会话，/dir 切换或重置工作目录，/mode 设置权限模式（yolo 自动批准所有工具调用），/model、/provider 切换模型与供应商，/cron 添加定时任务，/memory 读写代理指令文件。用 /whoami 或 /status 获取自己的用户 ID，填入 [[projects]] 下的 admin_from，才能执行 /dir、/shell 等特权命令。

项目在空闲后会自动切换到新会话（reset_on_idle_mins，默认 30 分钟，设为 0 可关闭），以减少上下文漂移。代理生成的图片或文件可通过 cc-connect send --image、--file 回传到当前聊天，默认上限 50 MiB，可用 attachment_send 全局关闭。

使用约束

• 必须至少有一个已安装且已登录的代理 CLI，否则代理会拒绝每一条请求。
• OS 用户隔离（run_as_user）仅在 Linux/macOS 上支持，目前只适用于 Claude Code；需要对监督用户配置免密 sudo，并通过 cc-connect doctor user-isolation 预检后才能启动。
• 部分能力受平台限制：Markdown 渲染、图片和语音取决于厂商 API，语音通常还需要在 config.toml 中启用 [speech] 或 TTS 提供商。
• README 声明 MIT 许可证，但 GitHub 元数据未列出许可证，再分发前建议核对 LICENSE 文件。
• README 中大量赞助商与第三方 API 中转推广是商业内容，不属于功能说明。

HotRepo 点评

cc-connect 在 2026-02-28 的 Show HN 帖子中出现过，当时 1 分、2 条评论，HotRepo 暂无日榜和 Star 快照记录。该讨论里作者把自己与另一个 Discord/Codex 单平台桥接项目作对比，强调模块化适配器是主要差异（回复）。README 展示了较宽的代理与平台支持矩阵以及处于 beta 的更新日志，但站内没有可用数据来判断采用情况或长期热度。