1. 从本地 Claude 会话到飞书群消息链路到底卡在哪Claude Code 在终端里跑起来之后很多人会碰到一个很实际的问题会话事件只留在本地终端团队其他人看不到进度自己离开工位也收不到关键提醒。你希望的是 Claude 每次完成一轮对话、或者需要人工确认时飞书群里能自动收到一条消息。这个需求听起来简单但真正动手时会发现中间隔着好几层Claude Code 本身不直接对接飞书需要一个桥接层把本地会话事件转发出去而桥接层又要解决模型供应商鉴权的问题。这就是 Claude CC Switch CC-Connect 飞书 这套组合要解决的事。CC Switch 负责切换 Claude Code 背后对接的模型供应商CC-Connect 负责把本地 Claude Code 的会话事件桥接到飞书飞书机器人 Webhook 负责最终的消息投递。三者串起来才是一条完整的消息通知链路。适合谁看已经在本地装了 Claude Code、想让会话事件自动推到飞书群的开发者或者团队里多人共用一套模型通道、需要统一 Key 管理的场景。前置条件不复杂Node.js 装好并勾选 Add to PATHClaude Code 用npm install -g anthropic-ai/claude-code装好CC-Connect 用npm install -g cc-connect装好CC Switch 从发布页下载对应平台版本即可。整条链路里最容易出问题的不是飞书 Webhook 本身而是鉴权层。Claude Code 默认走 Anthropic 官方通道但很多国内开发者需要换成统一 Key 通道来管理额度和供应商。TaoToken 在这里扮演的就是统一 Key/API 通道的角色你只需要在 CC Switch 里填一次 Base URL 和 KeyClaude Code 就能通过这个通道完成鉴权后续 CC-Connect 转发事件时也不会因为鉴权失败而断链。下面按步骤把每个环节的可复制配置给出来。2. TaoToken 统一 Key 通道的前置准备与 CC Switch 配置在动 CC-Connect 之前先把 Claude Code 的模型通道打通否则后面事件转发会一直报鉴权错误。这一步的核心是拿到 TaoToken 的 API Key然后在 CC Switch 里配置成 Claude Code 可用的供应商。先到 TaoToken 控制台创建 API Key。打开 https://taotoken.net/api-keys 登录后点创建复制生成的 Key形如sk-xxxxxxxx。这个 Key 就是后面所有配置里要填的凭证。注意 Key 只在创建时完整显示一次先存到安全的地方。Base URL 用https://taotoken.net/api这是 API 通道地址不要加多余路径。模型 ID 按你需要选Claude 系列填claude-sonnet-4-5这类官方模型名即可具体可用列表在 https://taotoken.net/doc 里能查到。接下来配置 CC Switch。打开 CC Switch 界面点添加按钮选择自定义配置。需要填三个关键字段字段填写内容说明API Keysk-xxxxxxxxTaoToken 控制台创建的 Key请求地址 / Base URLhttps://taotoken.net/api统一 API 通道模型名称 / Model IDclaude-sonnet-4-5按实际需要选填完后点界面上的检测连通按钮如果返回正常说明 Key 和地址都对。这一步过了Claude Code 就能通过 TaoToken 通道跑起来。如果你更习惯用配置文件的方式CC Switch 底层对应的是 Claude Code 的 settings 文件。在用户目录下找到.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.jsonmacOS/Linux 是~/.claude/settings.json写入如下片段{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-xxxxxxxx, ANTHROPIC_MODEL: claude-sonnet-4-5 } }这个 JSON 片段就是 CC Switch 图形界面背后实际写入的内容路径和字段名保持一致手改也不会和界面冲突。改完后在项目目录打开终端输入claude回车如果能正常进入对话说明通道已经通了。这里有个容易忽略的点CC Switch 切换供应商后Claude Code 需要重新启动才会读取新的环境变量。如果你在 Claude 会话运行中切换了供应商当前会话不会生效退出重进即可。另外 Key 不要提交到 Git 仓库settings.json 建议加到 .gitignore 里或者用系统环境变量注入。通道打通后Claude Code 的每一轮请求都会经过 TaoToken 统一通道额度、供应商切换都在这一层管理。接下来才是把会话事件桥接到飞书。3. CC-Connect 可复制配置与飞书机器人 Webhook 参数CC-Connect 的作用是把本地 Claude Code 的会话事件转发到飞书。它的工作方式是启动一个本地服务Claude Code 通过 hook 或事件回调把消息交给 CC-ConnectCC-Connect 再调用飞书机器人 Webhook 投递。先装好 CC-Connectnpm install -g cc-connect装完用cc-connect --version验证。然后启动服务cc-connect cc-connect webcc-connect web默认监听 9820 端口浏览器打开 http://localhost:9820/ 就能看到管理界面。注意运行 cc-connect 的终端不要关闭关了服务就断了。如果 web 界面打不开重新执行一次cc-connect再开 web 即可。在 web 界面里添加服务商时因为前面已经配过 CC Switch可以直接导入省去重复填 Key 的步骤。导入后确认 Base URL 是https://taotoken.net/apiKey 是同一个模型 ID 一致。接下来配置飞书机器人。在飞书群里添加自定义机器人拿到 Webhook 地址形如https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx这个地址就是 CC-Connect 投递消息的目标。在 CC-Connect 的配置里填入 Webhook 地址同时可以设置消息格式。CC-Connect 的配置文件通常在用户目录下的.cc-connect/config.json可复制片段如下{ provider: { baseUrl: https://taotoken.net/api, apiKey: sk-xxxxxxxx, model: claude-sonnet-4-5 }, feishu: { webhook: https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, msgType: text, atAll: false }, server: { port: 9820 } }三个关键字段对齐Base URL 是https://taotoken.net/apiKey 是 TaoToken 的sk-xxxxxxxxModel ID 是claude-sonnet-4-5。这三件套在 CC Switch、CC-Connect、Claude Code settings 里必须一致任何一处写错都会导致鉴权失败或模型找不到。飞书 Webhook 参数里msgType选text最省事也可以选post发富文本。atAll控制是否 所有人测试阶段建议 false避免打扰群成员。Webhook 地址不要泄露拿到的人都能往群里发消息。配置写完后重启 CC-Connect 服务让新配置生效。此时链路的三段——Claude Code 鉴权、CC-Connect 桥接、飞书 Webhook 投递——都已经就位可以进入验证环节。4. 端到端验证一条测试消息打通整条链路配置写完不代表链路通了必须用一条真实消息验证。验证思路是从 Claude Code 触发一个会话事件看飞书群能不能收到。第一步确认 CC-Connect 服务在跑。终端里执行cc-connect再开一个终端执行cc-connect web浏览器打开 http://localhost:9820/ 能看到界面。如果界面里显示服务商已连接、飞书 Webhook 已配置说明基础状态正常。第二步在项目目录启动 Claude Codecd your-project claude进入对话后随便发一条消息比如让它解释一段代码。Claude 回复完成后CC-Connect 应该捕获到这次会话事件并转发到飞书。切到飞书群看是否收到消息。如果没收到先在 CC-Connect web 界面点测试发送看飞书群有没有反应。这一步能区分是 CC-Connect 到飞书的问题还是 Claude Code 到 CC-Connect 的问题。第三步用 curl 直接测飞书 Webhook排除飞书侧的问题curl -X POST -H Content-Type: application/json \ -d {msg_type:text,content:{text:TaoToken 链路测试}} \ https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx返回{code:0,msg:success}说明 Webhook 本身没问题。如果返回错误码对照飞书文档检查 Webhook 地址和机器人是否被移出群。第四步验证 TaoToken 通道。在 Claude Code 里发一条消息如果模型能正常回复说明https://taotoken.net/api这条通道是通的。如果回复报错问题在鉴权层回到第 2 节检查 Key 和 Base URL。实测下来最常见的失败是 CC-Connect 服务没启动或者终端被关了。CC-Connect 依赖本地服务常驻关掉终端服务就停了飞书自然收不到消息。另一个常见问题是 Claude Code 的 settings.json 和 CC-Connect 的 config.json 里 Key 不一致一个用旧 Key 一个用新 Key导致其中一段鉴权失败。验证通过后你可以在飞书群里看到 Claude 会话事件的消息。整条链路是Claude Code 通过 TaoToken 通道完成模型鉴权CC-Connect 捕获会话事件调用飞书 Webhook 投递到群。三段各自独立任何一段断了都能单独排查。5. 常见报错排查401、local proxy failed、reading choices、OAuth链路跑起来后报错基本集中在几个固定位置。下面按真实报错对照排查。401 Unauthorized鉴权失败。先检查 TaoToken Key 是否有效到 https://taotoken.net/api-keys 确认 Key 没被删除或过期。再检查 Base URL 是否是https://taotoken.net/api多写或少写路径都会 401。最后确认 CC Switch、CC-Connect、Claude Code settings 三处的 Key 完全一致。三件套Base URL Key Model ID任何一处不匹配都会报这个错。local proxy failed / connection refusedCC-Connect 本地服务没起来。检查cc-connect进程是否在跑9820 端口是否被占用。如果端口冲突改 config.json 里的server.port。另外确认运行 cc-connect 的终端没被关闭服务是前台进程关终端就停。reading choices / unexpected response模型返回格式不对通常是 Model ID 写错或者通道返回了非预期内容。检查 Model ID 是否是 TaoToken 支持的模型名到 https://taotoken.net/doc 核对。如果 Model ID 写成了不存在的名字通道可能返回错误结构Claude Code 解析时就报 reading choices。OAuth / authentication errorClaude Code 尝试走官方 OAuth 流程说明 settings.json 里的ANTHROPIC_BASE_URL没生效。确认文件路径正确字段名大小写一致改完后重启 Claude Code。如果同时装了官方 Claude 和 CC Switch 配置可能环境变量被覆盖检查系统环境变量里有没有冲突的ANTHROPIC_*。飞书返回 code 非 0Webhook 地址错误或机器人被移出群或消息格式不符合飞书要求。用第 4 节的 curl 单独测 Webhook返回code:0说明飞书侧正常问题在 CC-Connect 的消息构造。检查 config.json 里msgType和实际发送内容是否匹配。CC Switch 检测连通失败Key 或 Base URL 错或者网络到https://taotoken.net/api不通。先在终端用 curl 测一下通道curl -X POST https://taotoken.net/api/v1/messages \ -H x-api-key: sk-xxxxxxxx \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-5,max_tokens:16,messages:[{role:user,content:hi}]}能返回内容说明通道正常问题在 CC Switch 配置。返回 401 说明 Key 错返回 404 说明 Base URL 或路径错。排查顺序建议从后往前先确认飞书 Webhook 能收到 curl 消息再确认 CC-Connect 服务在跑再确认 TaoToken 通道能返回模型结果最后确认 Claude Code 能正常对话。每一段单独验证比一次性猜哪里断了高效得多。6. 把链路固定下来日常使用与 Key 管理建议链路验证通过后日常使用还有几个细节值得固定下来。CC-Connect 服务建议做成开机自启或后台常驻避免每次手动开终端。Windows 可以用任务计划程序macOS/Linux 可以用 systemd 或 pm2。pm2 的方式比较简单pm2 start cc-connect --name cc-connect然后pm2 save保存进程列表。这样终端关了服务也不会断。TaoToken 的 Key 管理建议按用途分。如果团队多人共用可以给每个人建独立 Key方便追踪用量和单独吊销。Key 泄露时只吊销对应那个不影响其他人。控制台在 https://taotoken.net/console 能看到用量统计。模型 ID 如果需要在不同任务间切换比如日常对话用轻量模型、复杂任务用强模型可以在 CC Switch 里配多个供应商切换后重启 Claude Code 生效。CC-Connect 的 config.json 里 Model ID 也要同步改否则事件转发时用的还是旧模型。飞书消息格式如果想让通知更清晰可以把msgType改成post构造带标题和分段的富文本。CC-Connect 支持自定义消息模板具体字段参考 https://taotoken.net/doc 里的说明。测试阶段先用 text稳定后再换富文本。最后整条链路的稳定性取决于三段各自的健康度。建议定期检查 CC-Connect 服务状态、TaoToken Key 有效期、飞书机器人是否还在群里。任何一段变动都要重新跑一次第 4 节的验证消息确认端到端仍然通。把这条测试消息当成链路的健康检查改动配置后必跑一次能省掉很多事后排查的时间。