CC-Connect AI Bridge 是一个本地 AI 编程智能体与即时通讯平台之间的桥接工具,由 ara.so 在 2026 Skills 合集中收录。它让已经在本地运行的 AI 编程智能体可以从常用的聊天软件中直接调用,大多数平台无需公网 IP。
【用途与定位】 CC-Connect 的核心作用是把本地运行的 AI 编程智能体接入用户日常使用的通讯平台,从而可以在手机或团队聊天频道里向本地智能体下达任务、查看流式回复并继续对话,而不必始终停留在终端前。
【支持的智能体与平台】 支持的智能体类型包括:claude-code(Claude Code,Anthropic)、codex(Codex,OpenAI)、cursor(Cursor Agent)、gemini(Gemini CLI,Google)、qoder(Qoder CLI)、opencode(OpenCode / Crush)、iflow(iFlow CLI)。 支持的平台类型包括:telegram(Telegram,长轮询,无需公网 IP)、feishu(飞书 / Lark,WebSocket,无需公网 IP)、dingtalk(钉钉,Stream,无需公网 IP)、slack(Slack,Socket Mode,无需公网 IP)、discord(Discord,Gateway,无需公网 IP)、wecom(企业微信,WebSocket 无需公网 IP / Webhook 需要)、line(LINE,Webhook,需要公网 IP)、qq(通过 NapCat/OneBot,无需公网 IP)、qqbot(QQ Bot 官方,无需公网 IP)、weixin(个人微信,测试版,ilink 长轮询,无需公网 IP)。
【安装方式】 提供三种安装途径:
- npm:稳定版
npm install -g cc-connect;测试版npm install -g cc-connect@beta(包含个人微信/微信 ilink 等测试功能)。 - 二进制文件:Linux amd64 与 macOS arm64 均可通过 curl 下载对应发行包,chmod 后移动到 /usr/local/bin/。
- 从源码构建(Go 1.22+):克隆仓库后执行 make build,二进制位于 ./bin/cc-connect。
自更新:
cc-connect update(稳定版)或cc-connect update --pre(测试版/预发布)。 另提供 AI 辅助安装方式:向 Claude Code 或任意 AI 编程智能体发送指定提示词,指向项目的 INSTALL.md 自动完成安装与配置。
【配置方式】
配置位于 ~/.cc-connect/config.toml(默认路径),可从 config.example.toml 复制生成。最小配置(以 Claude Code + Telegram 为例)需要项目名、work_dir、data_dir、admin_from,以及 agent.type 和 platform.type/token。
多项目配置:在同一个配置文件中定义多个 [project.*] 段,每个项目可分别指定不同的智能体类型和平台,例如项目一用 Claude Code 接 Telegram,项目二用 Gemini 接飞书。
平台专属配置:Telegram 使用 token(从 @BotFather 获取);飞书使用 app_id、app_secret、verification_token;Slack 使用 bot_token 与 app_token(app_token 须以 xapp- 开头并启用 Socket Mode);Discord 使用 token;钉钉使用 client_id 与 client_secret;企业微信使用 corp_id、agent_id、secret 及 connection_type;个人微信(测试版)需先安装 beta 版本并执行 cc-connect weixin setup 扫码登录。
配置项可使用 $VAR_NAME 语法引用环境变量。
【运行方式】
默认读取 ~/.cc-connect/config.toml,直接执行 cc-connect 即可;可通过 --config 指定自定义配置路径,通过 --project 仅运行指定项目。
【聊天内命令】 /help 显示全部命令;/model <name> 切换 AI 模型;/mode <mode> 更改权限模式;/reasoning <level> 调整推理强度;/dir <path> 切换工作目录,/dir <number> 跳转到历史目录,/dir - 切换回上一目录,/dir reset 恢复配置的 work_dir;/cd 为 /dir 的别名;/memory 读写智能体的记忆/指令文件;/shell <cmd> 运行 shell 命令(仅管理员);/session 管理会话(列出、继续、新建);/continue 从上次会话继续(通过 fork 避免继承损坏状态);/cron <spec> <task> 安排周期任务;/stop 停止当前运行的智能体。
【多智能体接力】 可在同一个群聊中绑定多个机器人(例如一个 Claude、一个 Gemini),用名字提及它们即可让它们相互接收并回应该输出。
【语音与多模态】 在支持语音的平台(Telegram、飞书、钉钉)可启用 [speech] 配置,provider 支持 openai | azure | google,stt 默认模型 whisper-1,tts 默认 tts-1、voice 为 alloy。语音消息会被转写后转发给智能体,并可选择把回复朗读出来。图片/截图可直接在聊天中附带,cc-connect 会转发给支持多模态的智能体。
【定时任务】 每个项目可配置 [project.*.cron],包含 timeout(单次任务最长运行时间,如 30m)与 fresh_session(每次运行开启新会话)。也可在聊天中用 /cron 指定 cron 表达式与任务内容,例如每工作日 9 点生成站会总结、每小时检查 urgent 标签的新 issue。
【管理员与数据结构】 admin_from 可配置逗号分隔的用户名或 ID,管理员可使用 /shell、/dir 等特权命令,非管理员不可。数据目录结构为 ~/.cc-connect/config.toml 与 ~/.cc-connect/data/projects/<项目>.state.json(持久化目录覆盖与会话状态)。
【常见使用模式】 移动优先的 AI 开发:在开发机安装并连接 Telegram,从手机发送任务、查看流式回复并继续对话。团队共享 AI 机器人:每个项目一个实例,共享在团队频道中,成员无需终端权限即可提问、触发代码审查或运行分析。定时报告:用 /cron 定期生成提交与 issue 的周报并格式化为 markdown。多项目路由:单进程运行多个项目,每个机器人负责不同仓库或事务。
【故障排查】 机器人无响应:确认 cc-connect 进程在运行(ps aux | grep cc-connect)、检查平台令牌/凭据、Telegram 检查 bot token 有效性、飞书检查控制台中的 WebSocket 连接。找不到智能体:用 which claude / which gemini / which codex 验证是否在 PATH 中,必要时在配置中设置 bin 显式路径。会话继承损坏状态:使用 /continue(fork 会话)或 /session new 新建。个人微信不可用:需安装 beta 版本并执行 cc-connect weixin setup 扫码。上下文过长:可启用 auto_compress = true 并设置 compress_threshold(如 80000 tokens)。配置未找到:默认路径为 ~/.cc-connect/config.toml,可用 --config 显式指定。查看版本:cc-connect --version。
【环境变量】 TELEGRAM_BOT_TOKEN、FEISHU_APP_ID、FEISHU_APP_SECRET、FEISHU_VERIFICATION_TOKEN、SLACK_BOT_TOKEN、SLACK_APP_TOKEN、DISCORD_BOT_TOKEN、DINGTALK_CLIENT_ID、DINGTALK_CLIENT_SECRET、WECOM_CORP_ID、WECOM_AGENT_ID、WECOM_SECRET、OPENAI_API_KEY。
【平台设置文档】 飞书/Lark:docs/feishu.md;钉钉:docs/dingtalk.md;Telegram:docs/telegram.md;Slack:docs/slack.md;Discord:docs/discord.md;企业微信:docs/wecom.md;个人微信(测试版):docs/weixin.md;QQ / QQ Bot:docs/qq.md。
【限制】 资料未提供本工具的收费信息、价格、性能指标或效果保证;LINE 平台需要公网 IP;个人微信功能仅在测试版提供;各智能体与平台的具体版本兼容性要求除 Go 1.22+ 外暂未提供。