知识花园

cc-connect 完整使用指南：把本地AI编程助手装进你的聊天软件

8分钟阅读

cc-connect 是一个开源的”桥梁”工具，它能将运行在你本地电脑（或服务器）上的AI编程助手（Agent），无缝接入到飞书、钉钉、微信、Telegram等日常聊天软件中。它解决了”AI能力被锁在IDE里”的痛点，让你在任何有网络的地方，都能通过手机或平板远程操控电脑上的AI执行代码审查、数据分析、自动化脚本等任务。

一、核心优势

  • 无需公网IP：绝大多数平台采用WebSocket长连接技术，无需公网IP即可实现穿透
  • 多Agent支持：原生支持Claude Code、Cursor Agent、Gemini CLI、OpenCode、Kimi CLI等7+主流编程助手
  • 多平台覆盖：兼容飞书、钉钉、企业微信、Telegram、Slack、Discord、QQ及个人微信（Beta）等12+聊天平台
  • 实时响应：支持流式输出、Markdown渲染和交互式卡片消息
  • 完全可控：所有数据都在本地处理，不会上传到第三方服务器

二、安装教程

环境要求

  • Node.js LTS版本（推荐v18+）或直接下载二进制文件
  • 本地已安装目标AI Agent（如Claude Code、Cursor CLI）
  • （可选）ffmpeg：用于语音消息处理

安装方式（三选一）

1. npm安装（推荐）

稳定版：

npm install -g cc-connect

Beta版（含个人微信等最新功能）：

npm install -g cc-connect@beta

2. 二进制文件安装

从 GitHub Releases 下载对应平台的二进制文件，放入系统PATH目录即可。

3. AI代劳安装

直接将以下内容发给你的Claude Code或Cursor：

请参考 https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md 帮我安装并配置 cc-connect

AI会自动完成安装和基础配置。

三、快速上手

示例1：接入飞书（最简单）

  1. 运行配置命令：
cc-connect feishu setup --project my-project

  1. 按照提示扫码，在飞书开放平台创建应用并授权

  2. 启动cc-connect：

cc-connect
  1. 打开飞书，找到你创建的机器人，发送消息即可开始对话

示例2：接入个人微信（Beta）

  1. 确保已安装最新Beta版：
npm install -g cc-connect@beta
  1. 运行配置命令：
cc-connect weixin setup

  1. 按照提示扫码完成微信授权

  2. 重启cc-connect：

cc-connect restart
  1. 打开微信，找到”CC-Connect”联系人，发送消息即可

四、核心功能详解

常用斜杠指令

直接在聊天窗口输入以下命令，无需切换终端：

命令功能
/model查看并切换AI模型
/dir /path/to/project 或 /cd切换Agent的工作目录
/mode查看当前权限模式
/mode yolo切换为全自动模式（自动批准所有工具调用）
/mode default切换回手动确认模式
/new开启新会话，清空上下文
/stop停止当前正在执行的任务
/cron管理定时任务
/memory读写Agent的长期记忆文件
/help显示所有可用命令

权限模式说明

cc-connect支持4种权限模式，可根据场景灵活切换：

模式行为适用场景
default每次工具调用需要你手动确认日常使用，安全第一
acceptEdits文件编辑自动通过，其他操作需确认代码编写场景
plan只做任务规划不执行，审批后再运行复杂任务先审核
bypassPermissions（yolo）全自动，所有操作自动通过可信环境下的调试

多项目配置

cc-connect支持同时运行多个项目，每个项目对应一个独立的工作目录和AI会话。在配置文件~/.cc-connect/config.toml中添加多个[[projects]]块即可：

[[projects]]
name = "frontend-project"
[projects.agent]
type = "claudecode"
[projects.agent.options]
work_dir = "/path/to/frontend"
 
[[projects]]
name = "backend-project"
[projects.agent]
type = "claudecode"
[projects.agent.options]
work_dir = "/path/to/backend"

每个项目会自动创建对应的聊天机器人，你可以在不同的聊天窗口中同时处理多个项目。

五、高级技巧

1. 开机自启

Linux/macOS

cc-connect daemon install

Windows

使用nssm工具将cc-connect注册为Windows服务：

# 安装nssm（如果没有）
choco install nssm
 
# 注册服务
nssm install cc-connect "C:\Users\YourName\AppData\Roaming\npm\cc-connect.cmd"
nssm set cc-connect Start SERVICE_AUTO_START
nssm start cc-connect

2. Web管理界面

cc-connect自带Web管理后台，启动服务后在浏览器中访问：

http://localhost:28080

在Web界面中可以：

  • 可视化编辑配置文件
  • 查看聊天记录和任务执行状态
  • 管理定时任务
  • 监控系统资源使用情况

3. 多Agent协作

在群聊中添加多个不同AI Agent的机器人，它们可以互相协作处理同一任务。例如：

  • 让Claude Code负责代码编写
  • 让Gemini负责数据分析和可视化
  • 让Kimi负责文档总结和撰写

cc-connect会自动在多个Agent之间转发消息，实现无缝协作。

4. 定时任务

使用/cron命令可以创建定时任务，让AI自动执行重复性工作：

/cron add "每天早上9点" "帮我检查昨天的代码提交记录并生成日报"
/cron list
/cron delete 1

六、常见问题

Q1: 启动后机器人没有响应

  • 检查网络连接是否正常
  • 确认AI Agent已正确安装并可以在终端中运行
  • 查看日志文件~/.cc-connect/logs/cc-connect.log获取详细错误信息
  • 尝试重启cc-connect服务

Q2: 个人微信接入失败

  • 确保已安装最新的Beta版本
  • 检查微信账号是否被限制登录
  • 尝试重新运行cc-connect weixin setup命令
  • 注意：个人微信接入目前处于Beta阶段，可能存在不稳定情况

Q3: 如何更新cc-connect

npm用户：

npm update -g cc-connect

二进制文件用户：

cc-connect update

Q4: 安全注意事项

  • 不要在聊天中发送敏感信息（如密码、API密钥等）
  • 日常使用建议保持default模式，避免AI自动执行高风险操作
  • 不要将机器人添加到公共群聊中，除非你信任所有群成员
  • 定期更新cc-connect到最新版本，修复安全漏洞
# 查看全部会话
/sessions

关系图谱