cc-connect

在聊天软件里远程指挥本地 AI 写代码

开源 free 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 15956

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类自动化工作流

开发团队chenhg5

所属国家

官网地址

GitHubhttps://github.com/chenhg5/cc-connect

定价模式free

价格说明开源免费，需自行部署

访问状态

是否开源是

开源协议

主要语言Go

技术栈/模型

GitHub 星标★ 15956

30天Star增速

HF 下载量

上线时间2026-02-28 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-16

浏览次数0

项目介绍

cc-connect 是一个用 Go 编写的桥接工具，把本地运行的 AI 编程代理（Claude Code、Cursor、Gemini CLI、Codex）接入飞书/Lark、钉钉、Slack、Telegram、Discord、LINE、企业微信等即时通讯平台。它解决的核心问题是：开发者想在手机上或聊天窗口里随时调用本地 AI 编程助手，但本地服务通常没有公网 IP，也没法直接暴露给外部平台。cc-connect 通过长连接或轮询方式把消息转发到本地代理，多数平台无需公网 IP 即可使用。核心能力包括多平台适配、多代理后端切换、消息与代码上下文转发、会话保持，以及把 AI 编程结果直接推回聊天窗口。适合个人开发者远程指挥编码任务，也适合小团队把 AI 助手嵌入日常沟通工具中，降低使用门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：进阶约 15 分钟部署方式：命令行工具 7 步

环境要求

至少安装一个 AI 编程代理 CLI（Claude Code、Cursor、Gemini CLI、Codex 等）
Node.js/npm 环境，或 macOS/Linux 上的 Homebrew，或直接下载 GitHub Releases 二进制
在目标 IM 平台（飞书/Lark、钉钉、Slack、Telegram、Discord、企业微信等）拥有账号并完成应用/机器人配置
若使用 run_as_user 做用户隔离，需要 Linux/macOS 上可免密 sudo 的目标 Unix 用户

安装与启动步骤

1安装 AI 代理 CLI

README 要求先装好要桥接的代理 CLI，至少一个；README 未给出各代理的具体安装命令，请按对应官方文档安装
2用 npm 安装

全局安装 cc-connect 命令行工具，适合已装 Node.js/npm 的环境
```
npm install -g cc-connect
```
3或用 Homebrew 安装

macOS/Linux 用户可用 Homebrew 安装，与 npm 方式二选一即可
```
brew install cc-connect
```
4或下载二进制

也可从 GitHub Releases 页面下载对应平台二进制，README 未给出具体下载命令
5按平台文档配置

对照 docs 目录下对应平台文档（如 docs/feishu.md、docs/dingtalk.md、docs/telegram.md）填写平台凭据与项目配置
6用户隔离预检

仅在配置了 run_as_user 时需要，运行三项 go/no-go 预检与隔离探测，任一失败会拒绝启动
```
cc-connect doctor user-isolation
```
7启动 cc-connect

在安装目录运行程序启动桥接服务，随后即可在聊天窗口调用本地 AI 编程代理
```
./cc-connect
```

关键配置

配置项	必填	说明	示例
`name`	是	项目名称标识，在 [[projects]] 中声明	`claude-sandboxed`
`run_as_user`	否	Linux/macOS 下以指定 Unix 用户启动代理，实现 OS 级文件隔离	`partseeker-coder`
`run_as_env`	否	以列表形式指定需传递到目标用户环境的环境变量名	`["PGSSLROOTCERT"]`

如何确认成功

运行 ./cc-connect 能正常启动且未退出；配置了用户隔离时 cc-connect doctor user-isolation 预检全部通过。

常见问题

Q：需要公网 IP 吗？

A：多数平台不需要。README 表格显示飞书、钉钉、WPS 协作、Telegram、Slack、Discord、QQ、Matrix、个人微信等均走长连接或轮询；仅企业微信 Webhook 模式需要公网 IP。

Q：必须安装 AI 代理 CLI 吗？

A：需要，README 明确要求至少安装一个代理（Claude Code、Cursor、Gemini CLI、Codex 等）作为被桥接的后端。

Q：不想手动安装配置怎么办？

A：把 README 中给出的 INSTALL.md 链接发给 Claude Code 等 AI 编程代理，让它按该文档自动完成安装与配置。

Q：用户隔离配置后启动失败？

A：先用 cc-connect doctor user-isolation 排查。目标用户需免密 sudo、对 work_dir 可读写、有自己的 ~/.claude/settings.json；OAuth 登录时需软链 .credentials.json。

注意事项

README 节选中未给出各 AI 代理 CLI 的具体安装命令，请以对应官方文档为准。
多个平台的连接方式与配置项互不相同，请对照 docs 目录下对应平台的文档配置。
使用 run_as_user 时若预检门槛失败或探测到跨用户文件泄漏，cc-connect 会拒绝启动。
README 只说明可从 GitHub Releases 下载二进制，未提供下载命令与文件名。

核心亮点

支持飞书、钉钉、Slack、Telegram、Discord、LINE、企业微信等主流平台，覆盖面广
多数平台无需公网 IP，本地代理可直接被聊天消息驱动，部署门槛低
同时兼容 Claude Code、Cursor、Gemini CLI、Codex 多种后端，可自由切换

不足之处

各平台接入配置差异较大，首次搭建需要逐个平台申请机器人权限
项目较新，长期维护与多平台 API 变更跟进情况待观察

适用场景

通勤路上用手机在飞书里给本地 Claude Code 下发编码任务
团队在 Slack 频道中直接调用 AI 代理生成代码片段并回传
个人开发者用 Telegram 远程查看和继续本地 Cursor 的编程会话

替代项目

OpenHands、Aider

上一篇：xiaozhi-esphome

下一篇：没有了！