1. 项目定位与用途
cc-connect 的核心定位是作为本地 AI 编程代理与消息平台之间的桥梁。它允许用户将本地的 AI 编程助手（如 Claude Code、Cursor 等）接入到日常使用的聊天应用中，从而实现随时随地的 AI 辅助开发。主要用途包括：通过聊天界面发送代码审查请求、获取技术问题解答、触发自动化脚本执行、进行数据分析和生成报告等。项目使 AI 编程工具不再局限于本地终端，而是融入团队沟通和日常办公流程，提升开发效率和协作便利性。
项目档案命令行工具
cc-connect - 桥接本地 AI 代理到消息平台的 CLI 工具 | 支持 Claude Code、Cursor，无需公网 IP
cc-connect 是一个开源桥接工具，将本地 AI 编程代理（Claude Code、Cursor 等）连接到飞书、钉钉、Telegram 等消息平台。用户可通过聊天应用远程控制 AI 助手，进行代码审查、自动化等任务，多数场景无需公网 IP。本页提供项目介绍、安装教程、使用指南及技术架构。
AI 总结
cc-connect 是一个开源桥接工具，将本地 AI 编程代理（如 Claude Code、Cursor）连接到飞书、钉钉、Telegram 等消息平台，让你在任何聊天应用中控制 AI 助手，无需公网 IP。
中文项目介绍
cc-connect 是一个开源的桥接工具，旨在将运行在本地的 AI 编程代理（包括 Claude Code、Cursor、Gemini CLI、Codex 等）连接到多种主流消息平台（如飞书、钉钉、Slack、Telegram、Discord、LINE、企业微信等）。通过这种方式，用户可以在日常使用的聊天应用中直接与 AI 助手进行交互，实现代码审查、技术研究、任务自动化、数据分析等各种功能，彻底解决了开发者无法在移动设备或远程场景下便捷使用本地 AI 编程助手的问题。
该项目采用 Go 语言开发，以命令行工具（CLI）形式运行，采用守护进程模式管理。其核心架构模块化设计，包括配置管理、桥接引擎、守护进程以及各类代理和平台适配器。创新性地引入了 Bridge Protocol 桥接协议，允许通过 WebSocket 连接外部平台适配器，使得新增平台支持无需重新编译主程序。目前支持文本与斜杠命令、Markdown 渲染、流式分块回复、图片与文件传输等丰富功能，且多数平台集成无需公网 IP，保护隐私的同时提供极大便利。
详细信息与使用说明
2. 解决的问题
cc-connect 主要解决以下痛点：本地 AI 编程代理通常依赖终端或桌面客户端，用户无法在移动设备或远程位置访问；直接暴露本地服务到互联网存在安全风险且配置复杂；开发者习惯使用多种消息平台进行沟通，但 AI 助手无法原生集成。cc-connect 通过桥接方案，让 AI 代理‘入驻’聊天应用，用户无需公网 IP 即可在任意设备上与 AI 交互，同时保持本地运行的数据隐私。这显著降低了使用门槛，使 AI 编程 assistance 真正成为开发工作流的无缝组成部分。
3. 适用场景
cc-connect 适用于多种开发与协作场景：在代码审查场景中，团队成员可在飞书或钉钉群组中 @AI 助手请求代码评审；在研究与学习场景下，通过 Telegram 或 Discord 频道向 AI 提问技术问题；在自动化任务场景，使用斜杠命令触发本地 AI 执行数据分析、脚本生成等任务；在移动办公场景，在个人微信（beta）或企业微信中随时继续中断的编码会话。此外，支持定时任务（cron）的边界控制，适合需要定期运行 AI 分析的工作流。无论是独立开发者快速获取帮助，还是团队集成 AI 到沟通平台，cc-connect 都能提供灵活、私密的本地 AI 接入方案。
4. 安装方式
根据仓库信息，cc-connect 提供多种安装方式：最便捷的是通过 npm 全局安装稳定版，命令为 `npm install -g cc-connect`；如需试用 beta 功能（如个人微信支持），可安装预发布版本 `npm install -g cc-connect@beta`。此外，用户可从 GitHub Releases 页面下载适合操作系统的预编译二进制文件直接运行。对于开发者或需要自定义构建的场景，项目基于 Go 语言，可通过 `go build` 从源码编译。注意，beta 功能可能不稳定，细节可能在正式发布前变更。安装后，首次运行需通过 `cc-connect config` 命令配置所需连接的消息平台。
5. 使用方式
使用 cc-connect 的基本流程如下：首先运行 `cc-connect` 命令启动守护进程，该进程会在后台管理会话和连接。然后使用 `cc-connect config` 进入配置模式，按向导添加要桥接的消息平台（如飞书、钉钉等），需提供平台机器人或应用的凭证。配置完成后，在对应消息平台中向机器人发送消息或斜杠命令即可与本地 AI 代理交互。支持高级用法：使用 `--continue` 选项恢复中断会话（beta 改进版避免继承不完整终端状态）；通过 `cc-connect cron` 子命令设置定时任务，支持每次运行 fresh session 和超时控制。所有交互均通过已配置的聊天应用进行，无需额外客户端。
6. 实现特点与扩展性
cc-connect 在实现上具有几个关键特点：采用守护进程架构，确保稳定运行和会话持久化；核心引擎处理消息路由、会话管理和流式响应，支持 Markdown、文件传输等富媒体；引入创新的 Bridge Protocol 桥接协议，定义通过 WebSocket 连接外部平台适配器的规范，使得新增消息平台支持无需修改主程序或重新编译，只需实现协议即可动态扩展。项目模块化清晰，分离了代理适配层（对接各类 AI 工具）和平台适配层（对接消息服务），通过构建标签选择性编译。此外，提供上下文自动压缩（auto-compress）防止长会话溢出，以及 cron 任务边界控制提升可靠性。这些设计使 cc-connect 兼具易用性、扩展性和生产级稳定性。
思维导图
cc-connect
核心模块
config
core
daemon
代理适配器
claudecode
cursor
codex
gemini
opencode
pi
qoder
iflow
平台适配器
feishu
dingtalk
telegram
slack
discord
line
wecom
weixin
命令行工具
main.go
config 命令
cron 命令
send 命令
文档
README
平台文档
桥接协议
常见问题
cc-connect 是什么？它解决了什么问题？
cc-connect 是一个开源桥接工具，将本地 AI 编程代理连接到消息平台，解决开发者无法在移动设备或远程使用本地 AI 助手的问题，让你通过聊天应用随时与 AI 交互。
cc-connect 支持哪些 AI 代理和消息平台？
支持的 AI 代理包括 Claude Code、Cursor、Gemini CLI、Codex、OpenCode 等；支持的消息平台有飞书、钉钉、Slack、Telegram、Discord、LINE、企业微信，以及 beta 版的个人微信。
使用 cc-connect 需要公网 IP 吗？
多数平台不需要公网 IP，因为桥接在本地运行，消息平台通过官方 API 或机器人方式连接，但具体取决于平台配置。
如何安装和配置 cc-connect？
可通过 npm 安装（`npm install -g cc-connect`）或下载二进制文件；安装后运行 `cc-connect` 启动守护进程，再用 `cc-connect config` 配置平台连接。
什么是 Bridge Protocol？它有什么优势？
Bridge Protocol 是 cc-connect 定义的 WebSocket 协议，允许外部适配器连接，实现平台扩展无需重新编译主程序，提高了可扩展性。