1. 为什么要把 Claude Code CLI 接到飞书机器人上Claude Code CLI 本身是个终端里的编码助手能读文件、跑命令、改代码。但很多人日常沟通和协作都在飞书里如果能让飞书机器人把消息转给 Claude Code CLI 处理再把结果发回飞书群或私聊就等于给自己配了一个随身 AI 助理——在飞书里发一句帮我看看这个报错后台的 Claude Code 就能读项目、定位问题、给出修改建议。这个链路的核心其实就两段飞书侧负责收消息、发回调Claude Code CLI 侧负责把请求发到模型服务。真正容易卡住的地方是 Claude Code CLI 默认走的是 Anthropic 官方 endpoint国内直连经常超时或者握手失败。所以我们要做的关键动作是把 Claude Code CLI 的请求地址改到一个稳定可达的统一通道上也就是本文要讲的 TaoToken。TaoToken 在这里扮演的角色很明确它是一个兼容 Anthropic 接口规范的统一入口你只要把 Base URL 和 API Key 换掉Claude Code CLI 的调用方式完全不用改。对于飞书机器人这种需要长时间稳定在线的场景这一点很重要——机器人不能因为你本地网络抖动就整天掉线。适合读这篇的人有三类一是已经在用 Claude Code CLI、想把它接进飞书工作流的开发者二是做飞书自建应用、想加一个 AI 能力的同学三是单纯想把 Claude Code 的 endpoint 换成国内可稳定访问通道的人。下面我会从环境变量和 settings 配置切入给出可复制的片段、飞书回调地址的填法以及一条消息往返的完整验证动作。先说清楚整体数据流后面配置才不会乱飞书用户发消息 → 飞书开放平台推送事件到你的回调服务 → 回调服务调用 Claude Code CLI或调用其封装的接口→ Claude Code CLI 按 settings 里的 Base URL 请求 TaoToken → TaoToken 转发到模型 → 结果原路返回 → 回调服务调飞书发消息接口 → 用户看到回复。你要改的 endpoint就在第三步里 Claude Code CLI 读取的那份配置。飞书侧要填的是第二步里那个回调地址。两件事分开做最后合起来验证。2. 接入前的准备TaoToken 通道与 Claude Code CLI 环境在动飞书之前先把 Claude Code CLI 到 TaoToken 这一段单独跑通。这样出问题时你能快速判断是模型通道的问题还是飞书回调的问题不用两头猜。第一步拿到 TaoToken 的 API Key。打开 https://taotoken.net/api-keys 登录后创建一个 Key复制保存。这个 Key 后面要写进 Claude Code 的配置里注意别提交到 Git 仓库。第二步确认 Claude Code CLI 已安装。如果还没装用 npm 全局安装npm install -g anthropic-ai/claude-code国内网络如果拉包慢可以先切一下 npm 镜像源这一步和模型通道无关只是让安装顺利npm config set registry https://registry.npmmirror.com第三步理解 Claude Code 读取配置的优先级。它主要看两个地方一是环境变量二是用户目录下的 settings 文件。环境变量优先级更高适合临时测试settings 文件适合长期固定飞书机器人这种常驻服务建议写进 settings避免每次重启都要重新 export。关键的两个变量是变量名作用填什么ANTHROPIC_BASE_URL请求地址https://taotoken.net/apiANTHROPIC_API_KEY鉴权 Key你在 TaoToken 创建的 Key注意 Base URL 这里写 https://taotoken.net/api 不要带多余的路径后缀Claude Code 会自己拼接 /v1/messages 这类端点。很多人报 404就是因为手抖多写了一段。第四步飞书侧的准备。你需要有一个飞书自建应用拿到 App ID 和 App Secret并在事件订阅里配置回调地址。回调地址指向你自己部署的服务这个服务负责接收飞书事件、调用 Claude Code、再把结果发回去。如果你只是想先验证链路可以先用飞书的长连接模式接收事件省去公网回调地址的麻烦等跑通再换成 HTTP 回调。这里有个容易忽略的点飞书机器人要能发消息需要申请对应的权限比如 im:message、im:message:send_as_bot。权限没开回调收到了消息但发不出去日志里会看到权限相关的报错。把这两段准备好就可以进入具体配置了。我建议的顺序是先配 Claude Code 的 settings用一条命令行请求验证 TaoToken 通不通通了之后再配飞书回调做端到端验证。这样每一步都有明确的成功标志。3. 可复制配置settings 片段与飞书回调地址填写这一节给你可以直接抄的配置。先处理 Claude Code 侧再处理飞书侧。Claude Code 的用户级 settings 文件一般放在~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json。如果目录不存在就手动建一个。写入下面这段 JSON{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }三个字段的作用分别是Base URL 指向 TaoToken 统一通道API Key 做鉴权Model ID 指定默认模型。Model ID 要和你 TaoToken 账号里可用的模型对上写错了会返回模型不存在的错误。如果你不确定有哪些模型可用可以先登录 https://taotoken.net/console 查看可用列表或者直接在 https://taotoken.net/models 里对话测试一下。如果你更习惯用环境变量也可以临时这样跑export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 export ANTHROPIC_MODELclaude-sonnet-4-20250514但飞书机器人是常驻进程环境变量在重启后会丢所以长期方案还是写 settings 文件。如果你用 systemd 或 pm2 托管机器人进程也可以把这三个变量写进进程的环境配置里效果一样。接下来是飞书侧。进入飞书开放平台找到你的自建应用在事件与回调里配置请求地址。假设你的回调服务部署在https://your-domain.com/feishu/event就填这个地址。飞书会先发一个 challenge 验证请求你的服务要能正确返回 challenge 值否则保存不了。回调地址的填写有几个细节第一必须是 HTTPS飞书不接受 HTTP。本地调试可以用内网穿透工具临时映射一个 HTTPS 地址但注意别把生产环境的地址和调试地址搞混。第二验证 URL 时飞书会发一个带challenge字段的 POST 请求你的服务要原样返回{ challenge: 飞书发来的challenge值 }第三事件订阅里要勾选接收消息相关事件比如im.message.receive_v1。不勾选用户发消息你的服务根本收不到。第四如果你用长连接模式就不需要填回调地址SDK 会主动连飞书。这种方式适合内网部署但需要引入飞书的 SDK 并保持进程常驻。配置完成后飞书侧和 Claude Code 侧就各自独立通了。下一步做端到端验证。4. 验证请求一条消息往返确认链路打通验证分两步走先验证 Claude Code 到 TaoToken再验证飞书到 Claude Code 的完整往返。先做单点验证。在终端里直接跑一条非交互请求claude -p 用一句话说明什么是HTTP状态码401如果配置正确你会看到模型返回的内容。这一步成功说明 Base URL、API Key、Model ID 三件套都对TaoToken 通道是通的。如果这里就失败先别碰飞书回到第 5 节排查。单点通了之后做飞书端到端验证。在你的回调服务里收到飞书消息事件后把消息文本传给 Claude Code。最简单的做法是回调服务里执行claude -p 用户的问题内容然后把标准输出通过飞书的发消息接口发回给用户。飞书发消息接口大致是这样调的curl -X POST https://open.feishu.cn/open-apis/im/v1/messages?receive_id_typeopen_id \ -H Authorization: Bearer 你的tenant_access_token \ -H Content-Type: application/json \ -d { receive_id: 用户的open_id, msg_type: text, content: {\text\:\Claude返回的内容\} }tenant_access_token 需要用 App ID 和 App Secret 换取这个飞书文档里有标准流程这里不展开。验证动作在飞书里给机器人发一句帮我看下 401 是什么意思观察三件事——飞书是否收到回调看你服务日志、Claude Code 是否被调用看进程日志、飞书是否收到回复。三个都出现链路就通了。如果只通了前两步、第三步没回复多半是飞书发消息权限或 token 的问题。如果第一步就没触发是回调地址或事件订阅的问题。分段定位比一股脑改配置高效得多。实测下来最容易出问题的是 Model ID 写错和回调地址没通过 challenge 验证这两处。前者表现为 Claude Code 报模型错误后者表现为飞书保存回调地址时直接失败。5. 常见报错排查401、local proxy failed 与 reading choices这一节把几个高频报错拆开讲每个都给你定位思路。401 鉴权失败。报错通常长这样401 Unauthorized或authentication_error。原因基本是 API Key 不对。检查三件事Key 有没有复制完整前后有没有空格、Key 是不是在 TaoToken 后台被删了或过期了、settings 里字段名有没有写错必须是 ANTHROPIC_API_KEY。还有一种情况是环境变量和 settings 同时存在且值不一样环境变量覆盖了 settings你以为改的是文件其实没生效。排查时先echo $ANTHROPIC_API_KEY看当前生效的值。local proxy failed。这个报错说明 Claude Code 尝试走本地代理但连不上。常见于你之前配过 HTTP_PROXY 或 HTTPS_PROXY 环境变量但代理服务没开。解决办法是清掉这些变量unset HTTP_PROXY unset HTTPS_PROXY然后重启 Claude Code。注意这里说的是清掉本地代理设置让请求直连 TaoToken不是让你去配别的网络工具。reading choices 相关报错。这类错误通常出现在返回体解析阶段比如error reading choices或返回结构不符合预期。原因可能是 Base URL 写错了路径请求打到了非预期端点返回了 HTML 而不是 JSON。检查 ANTHROPIC_BASE_URL 是不是https://taotoken.net/api有没有多写/v1或少写/api。另外 Model ID 如果填了一个不存在的模型有些通道会返回非标准错误体也会触发解析失败。OAuth 相关报错。如果你之前用 Claude Code 登录过官方账号本地可能残留 OAuth 凭证和 API Key 模式冲突。表现是提示需要重新登录或 token 无效。解决办法是清理本地凭证缓存改用 API Key 模式。具体路径在~/.claude/下把旧的凭证文件移走再重启。飞书侧回调验证失败。飞书保存回调地址时报错先确认服务能返回 challenge再确认是 HTTPS。如果服务在本地用内网穿透映射时注意路径要和飞书填的一致。排查时记住一个原则先隔离再定位。Claude Code 单点能通问题就在飞书侧单点不通问题就在通道配置。别在两端同时改那样你永远不知道是哪一步修好的。6. 长期运行建议与接入入口飞书机器人是要长期在线的所以配置稳定性和进程管理比一次性跑通更重要。第一把 settings 文件纳入版本管理时API Key 用环境变量注入别硬编码进 JSON 提交。可以用占位符加启动脚本替换的方式。第二给回调服务加日志记录每次请求的耗时和结果。Claude Code 调用模型有延迟飞书事件有重试机制如果处理太慢飞书会重推导致重复回复。建议收到事件后先快速返回 200再异步处理。第三模型选择上日常问答用响应快的模型复杂编码任务再切到能力更强的模型。Claude Code 支持通过参数指定模型你可以在回调服务里根据消息内容做路由。第四定期检查 TaoToken 后台的用量和 Key 状态避免 Key 过期导致机器人突然不回复。如果你还没开始配建议按这个顺序走先去 https://taotoken.net/api-keys 创建 Key然后参考 https://taotoken.net/doc 里的接入说明确认 Base URL 和模型 ID 的写法配好 settings 后用claude -p验证单点最后再接飞书回调。想先感受一下模型返回效果可以直接在 https://taotoken.net/models 里对话测试。如果这个机器人是要长期跑编码和 Agent 任务的可以看看 https://taotoken.net/coding-plan 按用量规划更省心。链路打通之后你会发现飞书里多了一个随时能问代码、查报错、写文档的助手而这一切的起点就是把 Claude Code CLI 的 endpoint 稳稳地指向 TaoToken。
