你肯定遇到过以下场景:
- 人不在电脑前,却想让 AI 帮你继续写代码、查资料、跑任务;
- 想在微信、飞书、钉钉 里直接和本地 Agent 对话;
- 希望一个项目里同时调度多个 Agent,甚至让它们协作讨论。
cc-connect 就是为这个需求而生:把运行在你机器上的 AI Agent,桥接到你常用的聊天工具,让你随时随地通过手机或平板远程使用本地 AI 能力。
我们先看看效果图:

一、开源项目 cc-connect
在任何聊天工具里,远程操控你的本地 AI Agent。随时随地,随心所欲。
Github 地址:github.com/chenhg5/cc-...
1.1 cc-connect 是什么?
cc-connect 把运行在你机器上的 AI Agent 桥接到你日常使用的即时通讯工具。
代码审查、资料研究、自动化任务、数据分析 ------ 只要 AI Agent 能做的事,都能通过手机、平板或任何有聊天应用的设备来完成。

✨ 1.2 为什么选择 cc-connect?
八大核心优势:
🤖 通用 Agent 支持
9+ 大 AI Agent : Claude Code、Codex、Cursor Agent、Kimi CLI、Qoder CLI、Gemini CLI、OpenCode、iFlow CLI、Pi,还可通过 Agent Client Protocol (ACP) 接入更多 Agent。按需选用,或同时使用全部。
📱 平台灵活性
11 大聊天平台 : 飞书、钉钉、Slack、Telegram、Discord、企业微信、微博、LINE、QQ、QQ 官方机器人,以及 微信个人号(ilink)。大部分平台无需公网 IP。
🔄 多 Agent 编排
多机器人中继 : 在群聊中绑定多个机器人,让它们相互协作。问 Claude,再听Gemini 的见解 --- 同一个对话搞定。
🎮 完整的聊天控制
聊天即控制 : 切换模型 (/model)、切换推理强度 (/reasoning)、切换权限模式 (/mode)、管理会话,全部通过斜杠命令完成。
聊天切换工作目录 : 使用 /dir <路径> 切换下一次会话启动目录(/cd <路径> 为兼容别名),并支持 /dir <序号> / /dir - 快速在历史目录间跳转。
🧠 持久化记忆
Agent 记忆 : 在聊天中直接读写 Agent 指令文件 (/memory),无需回到终端。
⏰ 智能定时任务
定时任务 : 自然语言创建 cron 任务。"每天早上6点总结 GitHub trending" 即刻生效。
🎤 多模态支持
语音 & 图片 : 发语音或截图,cc-connect 自动处理 STT/TTS 和多模态转发。
📦 多项目架构
多项目管理 : 一个进程同时管理多个项目,各自独立的 Agent + 平台组合。
🚀 二、快速开始
2.1 🤖 通过 AI Agent 安装配置(推荐)
最简单的方式 --- 把这段话发给 Claude Code 或其他 AI 编码 Agent,它会帮你完成整个安装和配置过程:
text
请参考 https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md 帮我安装和配置 cc-connect

📦 2.2 手动安装
通过npm
安装之前,先确认已安装了 Node.js、npm,验证如下:

开始安装 cc-connect:(升级也使用该命令)
bash
npm install -g cc-connect

显示 "added 1 packages",表示安装成功。
2.3 飞书 (Feishu/Lark) 接入指南
介绍如何将cc-connect接入飞书,让你可以通过飞书机器人远程调用Claude代码。
前置条件
- 飞书账号(个人或企业职工)
- 一台可运行cc-connect的设备
- Claude Code 已完成安装并配置
💡优势:使用长连接模式,无需公网IP、无需域名、无需反向代理(ngrok/frp)
创建飞书应用
在飞书开放平台上创建一个"企业自建应用",并给它添加机器人能力,让它可以收发消息。
详见我之前为 Openclaw 配置飞书的文章:《手把手教你安装 OpenClaw 并接入飞书,让本地 AI 在飞书里听你指挥》:mp.weixin.qq.com/s/-_d5ESeMg...。
⚙️ 2.4 配置cc-connect
💡 使用 Web UI 配置
安装完成后,运行 cc-connect web 打开内置管理后台。

可以可视化创建项目、添加平台、管理服务商、直接和 Agent 聊天,无需手动编辑 TOML 文件。

快速配置(推荐)
如果你已经安装好 cc-connect,可以直接用内置命令完成"新建机器人/关联机器人",并自动写回 config.toml,主要三个关键参数:
- 飞书App ID
- 飞书App Secret
- project
bash
# 推荐:统一入口
cc-connect feishu setup --project my-project
cc-connect feishu setup --project my-project --app cli_xxx:sec_xxx
# 强制模式(一般不需要)
cc-connect feishu new --project my-project
cc-connect feishu bind --project my-project --app cli_xxx:sec_xxx
三者区别:
| 命令 | 作用 | 什么时候用 |
|---|---|---|
setup |
统一入口:无股票走 new,有股票走 bind | 默认就用这个 |
new |
强制二维码建设(不接受 --app) |
明确要重走扫码新建 |
bind |
强制关联现有依赖(必须 app_id/app_secret) | 仅明确做授权关联 |
手动配置
1.按下 Win + R 键,输入 %userprofile% 并回车,新建 .cc-connect 文件夹。
2.在 .cc-connect 文件夹中,新建 config.toml,并进行以下配置,并保存。
toml
# 项目配置
[[projects]]
name = "my-windows-project"
[projects.agent]
agent = "claudecode" # 或者 "openai", "gemini"
[projects.agent.options]
# 注意:Windows 路径建议使用双反斜杠 \\ 或者正斜杠 /
workdir = "C:/Users/你的用户名/Documents/Projects"
mode = "default"
# 飞书配置 (如果不用可以删除或留空)
[[projects.platforms]]
type = "feishu"
[projects.platforms.options]
app_id = "cli_axxxxxxxxxxxx" # 你的飞书AppID
app_secret = "QhkMpxxxxxxxxxxxxxxxxxxxx" #你的飞书AppSecret
# domain = "https://open.feishu.cn" # 可选:覆盖运行时 API/WebSocket 域名
# enable_feishu_card = true # 可选:关闭后统一回退纯文本回复
# thread_isolation = true # 可选:按飞书 thread/root 隔离群聊会话
# progress_style = "legacy" # 可选:legacy | compact | card
# done_emoji = "none" # 可选:agent 完成回复后添加的表情回复(如 "Done");设为 "none" 可禁用
3.打开 PowerShell 或 CMD,输入以下命令检查配置是否生效:
bash
cc-connect daemon install --config ~/.cc-connect/config.toml
▶️ 运行
bash
cc-connect
或
bash
cc-connect daemon start

测试下发任务
你帮我写一个 hellow world 的 py 文件

任务完成,飞书回复:

ERR-CODE : 200340问题

错误码 200340 表示卡片回调事件未订阅。
需要到飞书开放平台订阅这个事件:
- 进入 open.feishu.cn/ → 你的应用。
- 开发配置 → 事件与回调 → 回调配置:
3. 事件订阅 → 添加事件:
- im.card.action.trigger(卡片点击事件)

- 需要将应用重新发布后才能生效。
2.5 ⚙️ 配置守护进程
所有流程都调试通过以后,就可以把 cc-connect 注册成 Windows 系统服务让它开机自启。
🎯 三、cc-connect 核心功能
💬 会话管理
bash
/new [名称] 创建新会话
/list 列出所有会话
/switch <id> 切换会话
/current 查看当前会话
/history [n] 查看历史消息
/dir [路径|reset] 查看、切换或重置工作目录
/allow 预先批准某个工具
/quiet 切换思考/工具进度消息显示
/stop 停止当前执行
项目配置也可以开启"长时间空闲后自动切到新会话":
lua
[[projects]]
reset_on_idle_mins = 60
🔐 权限模式
使用 /mode <名称> 切换模式 可用值: default / acceptEdits / plan / auto / bypassPermissions / dontAsk
bash
/mode 查看可用模式
/mode yolo # 自动批准所有工具
/mode default # 每次工具调用前询问

也可以通过配置文件进行更改:
ini
[projects.agent.options]
mode = "default"
# 也可以预先批准特定工具:
# allowed_tools = ["Read", "Grep", "Glob"]
🔄 Provider 管理
bash
/provider list 列出 Provider
/provider switch <名称> 运行时切换 API Provider
🤖 模型选择
bash
/model 列出可用模型(格式:alias - model)
/model switch <alias> 按别名切换模型

📂 工作目录
bash
/dir 查看当前工作目录与历史
/dir <路径> 切换到指定目录(相对或绝对路径)
/dir <序号> 按历史序号切换
/dir - 返回上一个目录
/cd <路径> `/dir <路径>` 的兼容别名
⏰ 定时任务
bash
/cron add 0 6 * * * 帮我总结 GitHub trending
📎 Agent 回传图片和文件
当 Agent 在本地生成了截图、图表、PDF、日志包等文件时,可以主动把附件发回当前聊天。
首版支持:
- 飞书
- Telegram
可以在 config.toml 里全局控制这项能力:
ini
attachment_send = "on" # 默认 "on";设为 "off" 会禁用图片/文件回传
参考来源: