1. 为什么要把 Claude Code 接进飞书Claude Code 的能力不用多吹写代码、查日志、做 review 都挺能打但它有个硬伤只能在终端里跑。这意味着你必须坐在电脑前打开终端才能让它干活。出门在外收到线上告警想让它帮忙看两眼日志就得先找电脑、开终端、切目录一套流程下来十分钟没了。飞书是很多人日常已经开着的工具手机、平板、电脑都能用。把 Claude Code 通过 cc-connect 桥接进飞书之后你只需要在群里 一下机器人就能让它读代码、改文件、跑命令。cc-connect 是一个开源的 Agent 桥接工具负责把飞书的消息通过 WebSocket 长连接转发给 Claude Code再把结果回传到飞书。它不需要公网 IP内网环境也能跑。这篇要解决的问题很具体用 TaoToken 的统一 Key 和 API 通道把 cc-connect 和 Claude Code 串起来让飞书机器人真正能收发消息。适合已经在用 Claude Code、想把它搬到飞书上随时调用的人也适合想给团队搭一个共享 AI 编程助手的场景。下面直接给可复制的配置骨架和验证步骤。2. TaoToken 前置准备统一 Key 与 API 通道cc-connect 本身不提供模型能力它只是把消息转给 Claude Code而 Claude Code 需要访问模型 API。这里用 TaoToken 做统一入口好处是一个 Key 管所有模型调用不用在多个平台之间来回切换配置。你需要先拿到两样东西一个 API Key以及确认 Claude Code 走的是 TaoToken 的 API 地址。API 地址是https://taotoken.net/api注意这个地址不带任何查询参数直接填在配置里就行。拿 Key 的路径登录 TaoToken 控制台进入 API Keys 页面创建一个新的 Key。创建时建议给它起个能认出来的名字比如feishu-cc-connect方便以后排查是哪个应用在用。Key 只在创建时完整显示一次复制下来存好。如果你还没决定用哪个模型可以先到模型对话页面试一下调用是否正常确认 Key 有效再往下走。对于长期在飞书里跑编码任务的场景Coding Plan 会更划算一些适合高频调用。注意API Key 属于敏感凭证不要直接提交到 Git 仓库。cc-connect 的配置里可以用环境变量引用后面配置部分会写到。3. 可复制配置config.toml 与 settings.json 骨架这一节是核心直接给能用的配置。cc-connect 的配置文件默认在~/.cc-connect/config.tomlClaude Code 的模型接入配置在~/.claude/settings.json。两个文件配合好链路才能通。先建目录和 config.tomlmkdir -p ~/.cc-connect cat ~/.cc-connect/config.toml EOF [[projects]] name my-claude [projects.agent] type claudecode [projects.agent.options] work_dir /path/to/your/project api_key ${TAOTOKEN_API_KEY} base_url https://taotoken.net/api [[projects.platforms]] type feishu [projects.platforms.options] app_id cli_xxxxx app_secret xxxxx EOF几个关键点说明一下。work_dir换成你实际的项目目录Claude Code 会在这个目录下读写文件。api_key用${TAOTOKEN_API_KEY}引用环境变量这样配置文件里不出现明文。base_url固定填 TaoToken 的 API 地址。然后是 Claude Code 的 settings.json确保它走同一个通道{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: ${TAOTOKEN_API_KEY} } }把环境变量导出到 shellexport TAOTOKEN_API_KEY你的Key如果你用的是 Docker 方式跑 cc-connect环境变量要在docker run时通过-e TAOTOKEN_API_KEYxxx传进去否则容器里读不到。飞书那边的app_id和app_secret需要去飞书开放平台创建企业自建应用后获取。创建应用、开启机器人能力、订阅接收消息事件、把回调方式设为 WebSocket 长连接这几步在开放平台后台都有对应开关。WebSocket 模式的好处是不需要公网地址内网直接跑。4. 启动 cc-connect 并验证飞书回调配置写好后启动服务cc-connect正常启动会看到类似这样的日志INFO: Connecting to Feishu WebSocket... INFO: Feishu bot connected INFO: Agent claudecode ready三行日志分别代表正在连飞书、飞书连接成功、Claude Code 就绪。如果卡在第一行说明飞书凭证或网络有问题卡在第三行说明 Claude Code 或 API 通道有问题。验证动作分两步。第一步在飞书里把机器人拉进一个群 它发一句帮我看看当前目录有什么文件如果机器人回复了文件列表说明消息收发链路通了。第二步验证它真的能操作项目发一句帮我在项目根目录建一个 test_cc.md内容写 hello然后去服务器上看work_dir下有没有生成这个文件。文件生成了说明 Claude Code 的写权限和 API 通道都正常。如果第一步就没回复先看 cc-connect 的日志有没有报错。常见的是飞书事件没订阅全或者应用没发布。飞书开放平台里应用需要发布并通过审核自建应用一般自己审批即可机器人才能正常收发消息。5. 本篇常见错误排查配置过程中容易踩的坑集中在这几个地方对照排查能省不少时间。报错Feishu app_id or app_secret invalid检查 config.toml 里的app_id和app_secret有没有复制错注意前后不要有空格。飞书后台的凭证页面可以重新查看 secret。报错401 Unauthorized或invalid api key说明 TaoToken 的 Key 没生效。先确认环境变量TAOTOKEN_API_KEY在当前 shell 里能echo出来再确认 settings.json 里的ANTHROPIC_BASE_URL是https://taotoken.net/api没有多余斜杠或路径。机器人不回复但日志显示已连接多半是飞书事件订阅没配全。需要在开放平台订阅im.message.receive_v1这类接收消息事件并且把机器人添加到群里。只创建应用不加群 它是没反应的。Claude Code 报找不到工作目录work_dir填的是绝对路径且该路径要存在、当前用户有读写权限。相对路径在服务化启动时容易解析错统一用绝对路径。Docker 里跑读不到环境变量docker run时用-e传或者用--env-file指定文件。容器内的~和宿主机不是一回事配置文件路径要挂载进去。WebSocket 连不上确认服务器能出网访问飞书的长连接地址。公司内网如果有出网限制需要放行对应域名。这一步不需要公网 IP但需要能主动出网。6. 把链路用起来从验证到日常链路跑通之后日常使用就是直接在飞书里 机器人。cc-connect 支持多项目一个进程可以管多个[[projects]]每个项目绑定不同的飞书群。比如前端项目一个群、后端项目一个群互不干扰。权限控制上cc-connect 提供几种模式新手建议先用需要确认的模式等熟悉了再放开自动执行。这样 AI 改文件、跑命令之前会先问你避免误操作。如果你打算长期在飞书里高频调用 Claude Code 做编码任务建议把 Key 换成 Coding Plan调用成本更可控。接入过程中如果遇到 Key 或通道问题直接去 API Keys 页面重新生成一个对比测试能快速定位是配置问题还是凭证问题。模型调用是否正常可以在模型对话页面单独验证一次排除是 cc-connect 的问题还是 API 通道的问题。完整的接入参数和字段说明接入文档里有更细的对照表配置时对着查不容易漏项。
5分钟把Claude Code搬进飞书：TaoToken统一Key接入cc-connect配置与验证
1. 为什么要把 Claude Code 接进飞书Claude Code 的能力不用多吹写代码、查日志、做 review 都挺能打但它有个硬伤只能在终端里跑。这意味着你必须坐在电脑前打开终端才能让它干活。出门在外收到线上告警想让它帮忙看两眼日志就得先找电脑、开终端、切目录一套流程下来十分钟没了。飞书是很多人日常已经开着的工具手机、平板、电脑都能用。把 Claude Code 通过 cc-connect 桥接进飞书之后你只需要在群里 一下机器人就能让它读代码、改文件、跑命令。cc-connect 是一个开源的 Agent 桥接工具负责把飞书的消息通过 WebSocket 长连接转发给 Claude Code再把结果回传到飞书。它不需要公网 IP内网环境也能跑。这篇要解决的问题很具体用 TaoToken 的统一 Key 和 API 通道把 cc-connect 和 Claude Code 串起来让飞书机器人真正能收发消息。适合已经在用 Claude Code、想把它搬到飞书上随时调用的人也适合想给团队搭一个共享 AI 编程助手的场景。下面直接给可复制的配置骨架和验证步骤。2. TaoToken 前置准备统一 Key 与 API 通道cc-connect 本身不提供模型能力它只是把消息转给 Claude Code而 Claude Code 需要访问模型 API。这里用 TaoToken 做统一入口好处是一个 Key 管所有模型调用不用在多个平台之间来回切换配置。你需要先拿到两样东西一个 API Key以及确认 Claude Code 走的是 TaoToken 的 API 地址。API 地址是https://taotoken.net/api注意这个地址不带任何查询参数直接填在配置里就行。拿 Key 的路径登录 TaoToken 控制台进入 API Keys 页面创建一个新的 Key。创建时建议给它起个能认出来的名字比如feishu-cc-connect方便以后排查是哪个应用在用。Key 只在创建时完整显示一次复制下来存好。如果你还没决定用哪个模型可以先到模型对话页面试一下调用是否正常确认 Key 有效再往下走。对于长期在飞书里跑编码任务的场景Coding Plan 会更划算一些适合高频调用。注意API Key 属于敏感凭证不要直接提交到 Git 仓库。cc-connect 的配置里可以用环境变量引用后面配置部分会写到。3. 可复制配置config.toml 与 settings.json 骨架这一节是核心直接给能用的配置。cc-connect 的配置文件默认在~/.cc-connect/config.tomlClaude Code 的模型接入配置在~/.claude/settings.json。两个文件配合好链路才能通。先建目录和 config.tomlmkdir -p ~/.cc-connect cat ~/.cc-connect/config.toml EOF [[projects]] name my-claude [projects.agent] type claudecode [projects.agent.options] work_dir /path/to/your/project api_key ${TAOTOKEN_API_KEY} base_url https://taotoken.net/api [[projects.platforms]] type feishu [projects.platforms.options] app_id cli_xxxxx app_secret xxxxx EOF几个关键点说明一下。work_dir换成你实际的项目目录Claude Code 会在这个目录下读写文件。api_key用${TAOTOKEN_API_KEY}引用环境变量这样配置文件里不出现明文。base_url固定填 TaoToken 的 API 地址。然后是 Claude Code 的 settings.json确保它走同一个通道{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: ${TAOTOKEN_API_KEY} } }把环境变量导出到 shellexport TAOTOKEN_API_KEY你的Key如果你用的是 Docker 方式跑 cc-connect环境变量要在docker run时通过-e TAOTOKEN_API_KEYxxx传进去否则容器里读不到。飞书那边的app_id和app_secret需要去飞书开放平台创建企业自建应用后获取。创建应用、开启机器人能力、订阅接收消息事件、把回调方式设为 WebSocket 长连接这几步在开放平台后台都有对应开关。WebSocket 模式的好处是不需要公网地址内网直接跑。4. 启动 cc-connect 并验证飞书回调配置写好后启动服务cc-connect正常启动会看到类似这样的日志INFO: Connecting to Feishu WebSocket... INFO: Feishu bot connected INFO: Agent claudecode ready三行日志分别代表正在连飞书、飞书连接成功、Claude Code 就绪。如果卡在第一行说明飞书凭证或网络有问题卡在第三行说明 Claude Code 或 API 通道有问题。验证动作分两步。第一步在飞书里把机器人拉进一个群 它发一句帮我看看当前目录有什么文件如果机器人回复了文件列表说明消息收发链路通了。第二步验证它真的能操作项目发一句帮我在项目根目录建一个 test_cc.md内容写 hello然后去服务器上看work_dir下有没有生成这个文件。文件生成了说明 Claude Code 的写权限和 API 通道都正常。如果第一步就没回复先看 cc-connect 的日志有没有报错。常见的是飞书事件没订阅全或者应用没发布。飞书开放平台里应用需要发布并通过审核自建应用一般自己审批即可机器人才能正常收发消息。5. 本篇常见错误排查配置过程中容易踩的坑集中在这几个地方对照排查能省不少时间。报错Feishu app_id or app_secret invalid检查 config.toml 里的app_id和app_secret有没有复制错注意前后不要有空格。飞书后台的凭证页面可以重新查看 secret。报错401 Unauthorized或invalid api key说明 TaoToken 的 Key 没生效。先确认环境变量TAOTOKEN_API_KEY在当前 shell 里能echo出来再确认 settings.json 里的ANTHROPIC_BASE_URL是https://taotoken.net/api没有多余斜杠或路径。机器人不回复但日志显示已连接多半是飞书事件订阅没配全。需要在开放平台订阅im.message.receive_v1这类接收消息事件并且把机器人添加到群里。只创建应用不加群 它是没反应的。Claude Code 报找不到工作目录work_dir填的是绝对路径且该路径要存在、当前用户有读写权限。相对路径在服务化启动时容易解析错统一用绝对路径。Docker 里跑读不到环境变量docker run时用-e传或者用--env-file指定文件。容器内的~和宿主机不是一回事配置文件路径要挂载进去。WebSocket 连不上确认服务器能出网访问飞书的长连接地址。公司内网如果有出网限制需要放行对应域名。这一步不需要公网 IP但需要能主动出网。6. 把链路用起来从验证到日常链路跑通之后日常使用就是直接在飞书里 机器人。cc-connect 支持多项目一个进程可以管多个[[projects]]每个项目绑定不同的飞书群。比如前端项目一个群、后端项目一个群互不干扰。权限控制上cc-connect 提供几种模式新手建议先用需要确认的模式等熟悉了再放开自动执行。这样 AI 改文件、跑命令之前会先问你避免误操作。如果你打算长期在飞书里高频调用 Claude Code 做编码任务建议把 Key 换成 Coding Plan调用成本更可控。接入过程中如果遇到 Key 或通道问题直接去 API Keys 页面重新生成一个对比测试能快速定位是配置问题还是凭证问题。模型调用是否正常可以在模型对话页面单独验证一次排除是 cc-connect 的问题还是 API 通道的问题。完整的接入参数和字段说明接入文档里有更细的对照表配置时对着查不容易漏项。