手把手教你用飞书远程指挥 Claude Code 干活[保姆级教程]

0 阅读7分钟

你肯定遇到过以下场景:

  • 人不在电脑前,却想让 AI 帮你继续写代码、查资料、跑任务;
  • 想在微信、飞书、钉钉 里直接和本地 Agent 对话;
  • 希望一个项目里同时调度多个 Agent,甚至让它们协作讨论。

cc-connect 就是为这个需求而生:把运行在你机器上的 AI Agent,桥接到你常用的聊天工具,让你随时随地通过手机或平板远程使用本地 AI 能力。

我们先看看效果图:

效果图.png

一、开源项目 cc-connect

在任何聊天工具里,远程操控你的本地 AI Agent。随时随地,随心所欲。

Github 地址:github.com/chenhg5/cc-…

1.1 cc-connect 是什么?

cc-connect 把运行在你机器上的 AI Agent 桥接到你日常使用的即时通讯工具。

代码审查、资料研究、自动化任务、数据分析 —— 只要 AI Agent 能做的事,都能通过手机、平板或任何有聊天应用的设备来完成。

封面3.png

✨ 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,它会帮你完成整个安装和配置过程:

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

11.png

📦 2.2 手动安装

通过npm

安装之前,先确认已安装了 Node.js、npm,验证如下:

11.png

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

npm install -g cc-connect

11.png

显示 "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 打开内置管理后台。

cc-connect-web-run.png

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

cc-connect-web.png

快速配置(推荐)

如果你已经安装好 cc-connect,可以直接用内置命令完成“新建机器人/关联机器人”,并自动写回 config.toml,主要三个关键参数:

  • 飞书App ID
  • 飞书App Secret
  • project
# 推荐:统一入口
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,并进行以下配置,并保存。

# 项目配置
[[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,输入以下命令检查配置是否生效:

cc-connect daemon install --config ~/.cc-connect/config.toml

▶️ 运行

cc-connect

cc-connect daemon start

cc-connect-run.png

测试下发任务

你帮我写一个 hellow world 的 py 文件

helloworld.png

任务完成,飞书回复:

helloworld2.png

ERR-CODE : 200340问题

卡片权限.png

错误码 200340 表示卡片回调事件未订阅。

需要到飞书开放平台订阅这个事件:

  1. 进入 open.feishu.cn/ → 你的应用。
  2. 开发配置 → 事件与回调 → 回调配置:

事件与回调.png 3. 事件订阅 → 添加事件:

  • im.card.action.trigger(卡片点击事件)

事件与回调2.png

  1. 需要将应用重新发布后才能生效。

2.5 ⚙️ 配置守护进程

所有流程都调试通过以后,就可以把 cc-connect 注册成 Windows 系统服务让它开机自启。

🎯 三、cc-connect 核心功能

💬 会话管理

/new [名称]            创建新会话
/list                  列出所有会话
/switch <id>           切换会话
/current               查看当前会话
/history [n]           查看历史消息
/dir [路径|reset]      查看、切换或重置工作目录
/allow                 预先批准某个工具
/quiet	               切换思考/工具进度消息显示
/stop	               停止当前执行

项目配置也可以开启“长时间空闲后自动切到新会话”:

[[projects]]
reset_on_idle_mins = 60

🔐 权限模式

使用 /mode <名称> 切换模式 可用值: default / acceptEdits / plan / auto / bypassPermissions / dontAsk

/mode             查看可用模式
/mode yolo        # 自动批准所有工具
/mode default     # 每次工具调用前询问

权限模式.png

也可以通过配置文件进行更改:

[projects.agent.options]
mode = "default"

# 也可以预先批准特定工具:
# allowed_tools = ["Read", "Grep", "Glob"]

🔄 Provider 管理

/provider list              列出 Provider
/provider switch <名称>     运行时切换 API Provider

🤖 模型选择

/model                      列出可用模型(格式:alias - model)
/model switch <alias>       按别名切换模型

model.png

📂 工作目录

/dir                         查看当前工作目录与历史
/dir <路径>                  切换到指定目录(相对或绝对路径)
/dir <序号>                  按历史序号切换
/dir -                       返回上一个目录
/cd <路径>                   `/dir <路径>` 的兼容别名

⏰ 定时任务

/cron add 0 6 * * * 帮我总结 GitHub trending

📎 Agent 回传图片和文件

当 Agent 在本地生成了截图、图表、PDF、日志包等文件时,可以主动把附件发回当前聊天。

首版支持:

  • 飞书
  • Telegram

可以在 config.toml 里全局控制这项能力:

attachment_send = "on"  # 默认 "on";设为 "off" 会禁用图片/文件回传

参考来源: