引言:什么是 cc-connect?
cc-connect 是一个开源的、轻量级的 AI Agent 连接器(Connector)。
简单来说,它的核心作用就是充当一座**'桥梁'**,把你本地运行的强大 AI Agent(比如 Claude Code 等)与你日常使用的通讯软件(如飞书、钉钉、微信个人号、Telegram 等)无缝打通。
- 没有它时: 你的本地 Agent 只能被困在电脑的命令行终端(Terminal)里,你必须坐在电脑前敲击键盘才能和它交互。
- 有了它后(核心价值): 你相当于给本地的 AI Agent 开通了一个'线上客服窗口'。你可以随时随地在手机飞书上给 Agent 下达指令;Agent 在你电脑本地完成任务(比如分析本地文件、写代码、甚至操作网页截图)后,cc-connect 会负责把执行结果(不仅是文字,还包括真正的图片和附件)直接推送到你的飞书聊天框里。
这就是为什么我们需要配置 cc-connect:为了让强大的本地 AI 能力,变成你触手可及的跨平台全能助手!
前提条件 (Prerequisites)
在开始之前,请确保你的 Windows 电脑满足:
- 已安装 Node.js(推荐 LTS 版本,自带 npm)。
- 拥有飞书账号(个人或企业均可,用于创建机器人)。
- 已安装 AI Agent 环境(如 Claude Code 等)。
极简安装 (推荐最新 Beta 版)
在 Windows 下,最省心的方式就是直接用 npm 全局安装。为了支持最新的图片/文件回传能力,请务必安装 Beta 版。
请以管理员身份运行 PowerShell 或 CMD,执行:
npm install -g cc-connect@beta
获取飞书凭证 (准备工作)
我们需要先去飞书后台建个机器人,拿到'钥匙'。
- 登录 飞书开放平台。
- 点击「创建企业自建应用」(个人也可创建),起名如
cc-connect。 - 在左侧导航栏点击「凭据与基础信息」,复制你的
App ID(cli_xxx...) 和App Secret。 - 左侧导航栏点击「应用能力」 -> 「机器人」,点击「启用机器人」。
一键配置与飞书授权 (核心步骤)
无需手动去一层层建文件夹写配置,cc-connect 提供了极简的命令帮你一键搞定。
1. 自动写入配置
在你的 PowerShell 中执行以下命令(将其中的 cli_xxx 和 sec_xxx 替换为你刚才复制的凭证):
cc-connect feishu setup --project my-project --app cli_xxx:sec_xxx
(这个命令会自动在 C:\Users\<你的用户名>\.cc-connect\config.toml 中生成专为飞书定制的配置,并且默认开启了 attachment_send = "on" 附件回传功能。)
2. 配置飞书权限 (非常重要)
回到飞书开放平台网页端,完成机器人权限和长连接设置:
- 申请权限:点击左侧「权限管理」,搜索并勾选以下 6 个权限:


