企业官网建设流程全解析

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 PATH，Claude 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 和 Key，Claude 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 界面，点添加按钮，选择自定义配置。需要填三个关键字段：

填完后点界面上的检测连通按钮，如果返回正常，说明 Key 和地址都对。这一步过了，Claude Code 就能通过 TaoToken 通道跑起来。

如果你更习惯用配置文件的方式，CC Switch 底层对应的是 Claude Code 的 settings 文件。在用户目录下找到.claude/settings.json（Windows 是C:\Users\你的用户名\.claude\settings.json，macOS/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-Connect，CC-Connect 再调用飞书机器人 Webhook 投递。

先装好 CC-Connect：npm install -g cc-connect，装完用cc-connect --version验证。然后启动服务：

cc-connect cc-connect web

cc-connect web默认监听 9820 端口，浏览器打开 http://localhost:9820/ 就能看到管理界面。注意运行 cc-connect 的终端不要关闭，关了服务就断了。如果 web 界面打不开，重新执行一次cc-connect再开 web 即可。

在 web 界面里添加服务商时，因为前面已经配过 CC Switch，可以直接导入，省去重复填 Key 的步骤。导入后确认 Base URL 是https://taotoken.net/api，Key 是同一个，模型 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/api，Key 是 TaoToken 的sk-xxxxxxxx，Model 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 Code：

cd 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 refused：CC-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 error：Claude Code 尝试走官方 OAuth 流程，说明 settings.json 里的ANTHROPIC_BASE_URL没生效。确认文件路径正确，字段名大小写一致，改完后重启 Claude Code。如果同时装了官方 Claude 和 CC Switch 配置，可能环境变量被覆盖，检查系统环境变量里有没有冲突的ANTHROPIC_*。

飞书返回 code 非 0：Webhook 地址错误，或机器人被移出群，或消息格式不符合飞书要求。用第 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 节的验证消息，确认端到端仍然通。把这条测试消息当成链路的健康检查，改动配置后必跑一次，能省掉很多事后排查的时间。