企业官网建设流程全解析

1. 手机远程触发 Claude Code 的真实痛点

Claude Code 是个好东西，但它的使用姿势有个硬伤：你得坐在电脑前，打开终端，cd 到项目目录，然后才能开始对话。这个限制在大部分场景下没问题，但总有些时刻你会希望它能被远程触发。

比如你在地铁上刷到一篇技术文章，想让 Claude Code 帮你抓取内容整理成文档；比如开会时突然想到一个需求，想让它先去读需求文档出个初步方案；比如周末在外面，临时需要查一下某个项目的代码改动情况。这些场景下，掏出手机发条消息就能让 Agent 干活，比打开电脑再操作一遍要顺手得多。

我试过用 SSH 连回本地机器再跑 Claude Code，体验很割裂——手机终端操作不便，网络断了任务就中断，而且每次都要重新进入工作目录。后来发现开源工具 cc-connect 专门解决这个问题：它把 Claude Code、Codex、Gemini 等 Agent 接入飞书、钉钉、Telegram、Slack 等聊天平台，你在聊天窗口发消息，消息会被转发到本机或服务器上的 Agent 执行，结果再回传到聊天窗口。

这篇文章聚焦一个具体目标：用 cc-connect 把飞书消息接入 Claude Code，同时通过 TaoToken 统一 API 通道对接，让你在手机上发一条飞书消息就能触发 Claude Code 执行任务。我会给出可复制的配置文件骨架（config.toml / settings.json），附上验证动作，以及我踩过的坑和排查方法。适合已经在用 Claude Code、想降低触发成本、或者想搭建团队 AI 助手入口的人。

2. TaoToken 前置：统一 Key 与 API 通道

cc-connect 本身只负责消息转发和 Agent 调度，它不关心你的 Claude Code 用的是哪个 API 通道。但如果你想让 Claude Code 稳定跑起来，API 通道的配置是绕不开的。TaoToken 在这里的角色是提供一个统一的 Key 和 API 入口，让你不用在多个平台之间切换配置。

TaoToken 是什么？简单说，它是一个 AI 模型的统一接入平台，提供 API Key 管理和模型调用通道。你可以用它来调用 Claude、GPT 等模型，而不需要分别去各个平台申请 Key、配置环境变量。对于 cc-connect 这种需要长期后台运行的服务来说，统一通道的好处是配置一次、多处复用，减少因为 Key 过期或通道变更导致的服务中断。

适合谁用？如果你只是偶尔跑一下 Claude Code，直接用官方通道也行。但如果你要把 Claude Code 接入飞书机器人、让它 7x24 小时待命，或者你同时用多个 Agent（Claude Code、Codex、Gemini），那统一通道会省很多事。

具体操作上，你需要先拿到 TaoToken 的 API Key。访问官网注册后，进入控制台创建 API Key。这个 Key 后面会配置到 Claude Code 的环境变量里，cc-connect 不需要直接接触 Key，它只负责调用本机的 Claude Code 命令。

注意：TaoToken 的 API 地址是 https://taotoken.net/api，配置时不要加多余的路径后缀。API Key 创建后只显示一次，记得保存。

如果你还没创建 Key，可以先去控制台操作：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite

拿到 Key 之后，你需要把它配置到 Claude Code 的环境变量中。Claude Code 默认读取ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL两个环境变量。如果你用的是 TaoToken 的统一通道，配置方式如下：

# 在 ~/.zshrc 或 ~/.bashrc 中添加 export ANTHROPIC_API_KEY="你的TaoToken API Key" export ANTHROPIC_BASE_URL="https://taotoken.net/api"

配置完成后执行source ~/.zshrc使其生效。你可以用echo $ANTHROPIC_API_KEY确认是否配置成功。

这一步做完后，Claude Code 本身就能通过 TaoToken 通道调用了。接下来才是 cc-connect 的配置。

3. 可复制配置：cc-connect 对接飞书与 Claude Code

这一章是核心操作部分。我会按顺序给出飞书机器人创建、cc-connect 安装、config.toml 配置、settings.json 配置的完整步骤。

3.1 飞书机器人创建与权限配置

先打开飞书开放平台，登录后创建一个应用。创建完成后，你会拿到两个关键凭证：App ID 和 App Secret。这两个后面配置 cc-connect 时要用。

创建应用后，需要做三件事：

第一，添加机器人能力。在应用能力页面找到“机器人”，启用它。没有这一步，你的应用只是个普通应用，没法在飞书里对话。

第二，配置权限。个人测试阶段建议先给宽一点：消息与群组、多维表格、日历、机器人相关权限都勾上。等跑通后再收紧。

第三，配置事件与回调。这是最容易踩坑的地方。你需要订阅card.action.trigger事件，否则机器人能收到消息但不会回复。日志里会出现类似提示：

feishu: interactive card mode enabled, ensure card.action.trigger event is subscribed in Feishu console

配置完成后发布应用。发布后你就能在飞书里找到这个机器人了。

3.2 cc-connect 安装

cc-connect 提供多种安装方式。macOS / Linux 推荐用 Homebrew：

brew install cc-connect

也可以用 npm：

npm install -g cc-connect

安装完成后，启动服务：

brew services start cc-connect

停止和重启：

brew services stop cc-connect brew services restart cc-connect

3.3 config.toml 配置文件骨架

cc-connect 的配置文件默认在~/.cc-connect/config.toml。下面是我实测可用的配置骨架，你可以直接复制修改：

# ============================================================ # cc-connect 配置文件 # 文档: https://github.com/chenhg5/cc-connect # ============================================================ [[projects]] name = "my-project" [projects.agent] type = "claudecode" [projects.agent.options] work_dir = "/Users/yourname/projects/your-project" mode = "default" [[projects.platforms]] type = "feishu" [projects.platforms.options] app_id = "cli_xxxxxxxxxxxx" app_secret = "xxxxxxxxxxxxxxxxxxxxxxxx" # allow_from = "*" # allow_chats = "" # debug = false

三个关键点：

type = "claudecode"表示背后接的是 Claude Code。work_dir必须是绝对路径，表示 Claude Code 在哪个目录下工作。type = "feishu"表示消息入口用飞书。

如果你有多个项目，可以配置多个[[projects]]块，每个项目绑定不同的 Agent 和平台。

3.4 settings.json 配置 Claude Code 通道

Claude Code 的配置文件在~/.claude/settings.json。如果你想让 cc-connect 调用的 Claude Code 走 TaoToken 通道，需要确保这个文件里的配置正确：

{ "env": { "ANTHROPIC_API_KEY": "你的TaoToken API Key", "ANTHROPIC_BASE_URL": "https://taotoken.net/api" } }

如果你已经在 shell 里配置了环境变量，这个文件可以省略。但如果你是用 brew services 启动 cc-connect，它可能不会读取你的 shell 环境变量，这时候 settings.json 就很有必要。

配置完成后重启 cc-connect：

brew services restart cc-connect

4. 验证请求：飞书消息触发 Claude Code 执行任务

配置完成后，打开飞书找到你创建的机器人，发一条消息测试。比如：

帮我进入 articles 项目，整理一下今天这篇文章的标题和摘要

如果一切正常，机器人会回复你，并且 Claude Code 会在你配置的work_dir目录下执行任务。

验证成功的标志有三个：飞书机器人有回复、Claude Code 在本地执行了命令、日志里没有报错。

你可以通过查看日志确认执行情况：

tail -f /opt/homebrew/var/log/cc-connect.log

如果日志里显示消息接收成功、Agent 调用成功、结果回传成功，说明整条链路已经打通。

再测试一个更具体的任务：

根据需求文档 analysis.md，先分析实现方案，不要直接改代码

这个任务会触发 Claude Code 读取文件、分析内容、给出方案。你可以在飞书里看到完整的回复。

如果你想验证 TaoToken 通道是否生效，可以在 Claude Code 里执行一个简单请求，然后查看 TaoToken 控制台的调用记录。如果能看到对应的 API 调用，说明通道配置正确。

5. 本篇常见错排查

这一章列出我踩过的坑和对应的排查方法。

机器人不回复。最常见的原因是card.action.trigger事件没订阅。去飞书开放平台的事件与回调页面，确认这个事件已经添加。另一个可能是权限没给全，检查消息与群组权限是否开启。

App ID / App Secret 填错。这个错误比较隐蔽，因为 cc-connect 启动时不会报错，只有消息发过来才会失败。检查 config.toml 里的app_id和app_secret是否和飞书开放平台的一致。

work_dir 不是绝对路径。cc-connect 要求work_dir必须是绝对路径，相对路径会导致 Agent 找不到工作目录。检查你的配置是否以/开头。

服务没重启。修改 config.toml 后必须重启 cc-connect 才能生效。执行brew services restart cc-connect。

日志里有报错但没看。遇到问题第一时间看日志，不要靠猜。日志路径是/opt/homebrew/var/log/cc-connect.log。

TaoToken 通道不通。如果 Claude Code 本身能跑但 cc-connect 调用失败，检查 settings.json 里的ANTHROPIC_BASE_URL是否配置为https://taotoken.net/api，以及 API Key 是否有效。

飞书应用没发布。配置完成后需要发布应用才能在飞书里找到机器人。发布后如果还看不到，检查应用可见范围是否包含你自己。

排查顺序建议：先看日志、再查权限、最后检查配置文件。大部分问题都能通过日志定位。

6. 接入文档与后续操作入口

整条链路跑通后，你可以根据实际需求选择下一步操作。

如果你需要管理 API Key 或查看调用记录，去 TaoToken 控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite

如果你需要创建新的 API Key 用于其他 Agent，去 API Keys 页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite

如果你在配置过程中遇到接入问题，参考接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

如果你只是想先验证模型是否可用，可以直接在模型对话页面测试：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite

如果你打算长期用 Claude Code 做编码或搭建 Agent 工作流，可以了解 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite

如果你用的是 Claude Code 的 Anthropic 兼容通道，参考这个页面：https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude-code-anthropic&utm_campaign=rewrite

最后说一个实际经验：cc-connect 解决的是入口问题，不是能力问题。它让 Claude Code 从终端工具变成可以被消息触发的 Agent，但任务怎么拆、权限怎么控、哪些事情能自动做、哪些必须人工确认，这些还是得自己设计。建议的节奏是先让它分析、再让它给方案、确认后再改、改完再 Review、最后人工确认。不要一上来就让它自动改业务代码或自动提交。