多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

飞书 CLI 开源后,我用 Claude Code 打通公众号 Markdown 写作全流程

飞书 CLI 开源后,我用 Claude Code 打通公众号 Markdown 写作全流程 1. 飞书 CLI 开源后Claude Code 写公众号的完整链路长什么样飞书 CLI 开源这件事对做内容的人来说真正有价值的不是多了一个命令行工具而是 Claude Code 这类 AI 编程助手终于能直接操作飞书云文档了。以前你用 Claude Code 写完一篇文章还得手动复制粘贴到飞书、再导出 Markdown、再丢进排版工具中间全是手工活。现在这条链路可以串起来Claude Code 写稿 → 飞书云文档留存原件 → 导出 Markdown → 排版 → 发布公众号。这篇文章要交付的就是这条链路的可复制配置。我会给出 Claude Code 的接入配置片段、飞书 CLI 的调用命令、每一步的验证动作以及我自己踩过的报错。你跟着做应该能在半小时内把环境跑通之后每篇公众号文章都能走这套流程。先说清楚适合谁如果你已经在用 Claude Code 写代码或写内容想让 AI 直接帮你把稿子存进飞书云文档这篇就是给你写的。如果你还没装 Claude Code也没关系前置步骤我会写清楚。核心检索词就三个飞书 CLI、Claude Code、公众号 Markdown 写作。这三个词贯穿全文你搜到这篇说明方向对了。整条链路的关键在于Claude Code 负责写和调工具飞书 CLI 负责存转换工具负责导出排版工具负责美化公众号后台负责发布。每个环节各干各的人只在开头说一句话、结尾按一下发布。我试过把这套流程跑通之后一篇 1500 字的公众号文章从有想法到发出去10 分钟以内能搞定。下面从环境准备开始一步步来。2. TaoToken 前置给 Claude Code 配好模型接入Claude Code 本身是个客户端它需要接一个大模型才能干活。这里用 TaoToken 做模型接入层好处是一个 Key 能调多个模型切换方便而且 Claude Code 的配置改一处就行。先拿 Key。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制出来备用。这个 Key 就是后面配置里的ANTHROPIC_AUTH_TOKEN。然后确认你的 Claude Code 版本。终端里执行claude --version能输出版本号就行。如果提示 command not found说明 Claude Code 还没装先去装好再回来。接下来是配置。Claude Code 读取的是 settings 文件路径分两种macOS / Linux~/.claude/settings.jsonWindowsC:\Users\你的用户名\.claude\settings.json如果你之前没配过这个文件可能不存在手动创建即可。写入下面这段 JSON{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你刚才复制的Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }三个字段的含义ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址注意这里不加任何 UTM 参数就是干净的https://taotoken.net/apiANTHROPIC_AUTH_TOKEN填你刚创建的 KeyANTHROPIC_MODEL填你要用的模型 ID上面这个只是示例具体可用模型以你账号里能调到的为准。保存后验证配置是否生效。在终端里执行claude -p 回复一句配置成功如果返回了配置成功之类的内容说明模型接入通了。如果报 401往下看第 5 节的排查。这里有个坑要提前说settings.json 是严格 JSON不能有注释不能有多余逗号。我见过有人复制的时候把中文引号带进去了直接解析失败。保存前用编辑器的 JSON 校验看一眼。配好之后Claude Code 就能正常对话和调用工具了。接下来装飞书 CLI让 Claude Code 有手去操作飞书。3. 可复制配置飞书 CLI 安装与 Claude Code 技能接入这一节是全文最核心的可复制部分。飞书 CLI 装好、技能接好Claude Code 才知道怎么调飞书。3.1 安装飞书 CLI环境要求Node.js 和 npm。终端里执行node -v和npm -v都能输出版本号就行。没有的话去 Node.js 官网下 LTS 版本装上。安装飞书 CLInpm install -g larksuite/cli装完验证lark-cli --version能输出版本号就对了。如果提示权限错误macOS/Linux 前面加sudoWindows 用管理员权限打开 PowerShell。3.2 安装 Claude Code 技能技能文件是告诉 Claude Code飞书 CLI 能干什么、怎么调的说明书。没有它Claude Code 看到这个工具会不知道从哪下手。npx skills add larksuite/cli -y -g-g表示全局安装Claude Code 在任何目录都能调用。这条命令会把飞书操作的技能描述文件下载到本地。验证方式Windows 用户看C:\Users\你的用户名\.claude\skills目录macOS/Linux 看~/.claude/skills里面应该多出若干技能文件。有就说明装好了。3.3 创建飞书应用并登录飞书 CLI 需要你有一个飞书应用来拿 App ID 和 App Secret。这一步飞书 CLI 设计得比较省事lark-cli config init执行后会输出一个授权 URL用浏览器打开飞书会引导你创建应用。全程图形界面点几下就完成。如果你想让 Claude Code 帮你跑这条命令直接跟它说帮我执行 lark-cli config init --new完成后把授权链接发给我我去浏览器完成配置。Claude Code 会在后台运行把授权 URL 提取出来发给你。配置完应用后登录lark-cli auth login --recommend--recommend会自动选常用权限范围不用一条条勾。浏览器弹出授权页确认即可。验证登录状态lark-cli auth status输出你的用户名就说明搞定了。3.4 三件套对照表Claude Code 调飞书本质是三个东西对齐Base URL、Key、Model ID。下面这张表帮你对照配置项值写在哪Base URLhttps://taotoken.net/apisettings.json 的 ANTHROPIC_BASE_URLAPI Keysk-开头的一串settings.json 的 ANTHROPIC_AUTH_TOKENModel ID如 claude-sonnet-4-20250514settings.json 的 ANTHROPIC_MODEL飞书 CLI 这边则是 App ID App Secret 登录态通过lark-cli config init和lark-cli auth login完成不需要手写配置文件。两套配置都齐了Claude Code 就能一边用模型写稿一边调飞书 CLI 存文档。4. 验证请求从写稿到存飞书的成功结果配置齐了现在跑一遍完整验证。这一步的目的是确认 Claude Code 真的能调通飞书 CLI而不是只配了个样子。4.1 让 Claude Code 写稿并存飞书在 Claude Code 对话框里输入帮我写一篇 1500 字左右的公众号文章主题是AI 工具提升写作效率的 5 个方法。写完后把文章保存到飞书云文档中标题就用文章的标题。创建完成后把文档链接给我。Claude Code 的处理流程先写文章然后自动调用lark-cli docs create命令把文章内容作为 Markdown 传入飞书云文档创建成功后返回链接。整个过程你不需要操作等就行通常不超过 30 秒。4.2 手动验证命令如果你想先手动确认飞书 CLI 能创建文档可以自己跑一条lark-cli docs create --title 测试文档 --markdown # 这是正文\n\n测试内容执行后如果返回一个文档链接说明飞书 CLI 本身没问题。点开链接能看到内容就说明创建成功。4.3 指定保存位置如果你有固定的文件夹可以加--folder-token参数。文件夹 token 的获取方式打开飞书文件夹页面URL 最后那串字符就是。lark-cli docs create \ --title 文章标题 \ --markdown # 正文 \ --folder-token 你的文件夹token这样所有公众号文章都会整整齐齐放在同一个飞书文件夹下。注意Windows 的 cmd 不识别 bash 的换行符\要么用 PowerShell要么把命令写成一行。4.4 成功结果长什么样Claude Code 完成后会给你一条消息类似文章已写完并成功保存到飞书云文档https://xxx.feishu.cn/docx/xxxxxxxxxx点开链接飞书云文档里内容完整、标题正确、正文是结构清晰的 Markdown。这就是原件永久留在你的飞书空间里。到这一步链路的前半段就验证完了Claude Code 能写、能存、能返回链接。后半段是导出和排版属于工具操作不涉及模型调用但为了流程完整简单说一下用浏览器打开飞书文档通过 Cloud Document Converter 这类扩展导出 Markdown再粘贴到排版工具里选主题、复制 HTML最后粘到公众号编辑器发布。5. 本篇常见错排查401、local proxy failed、reading choices这一节列几个真实会遇到的报错对照着排查。5.1 401 Unauthorized现象Claude Code 执行时报 401或者返回authentication failed。原因通常是 Key 不对或 Base URL 写错。检查 settings.json 里ANTHROPIC_AUTH_TOKEN是不是完整的 Key有没有多余空格ANTHROPIC_BASE_URL是不是https://taotoken.net/api注意不要多加斜杠或路径。如果 Key 确认没问题还是 401去 https://taotoken.net/api-keys 重新生成一个 Key 换上。5.2 local proxy failed现象Claude Code 报 local proxy failed 或连接被拒绝。这个通常和本地网络环境有关。检查你的终端能不能正常访问外网curl https://taotoken.net/api看有没有响应。如果公司网络有防火墙限制换个网络环境再试。另外确认 settings.json 里没有残留的旧代理配置比如HTTP_PROXY、HTTPS_PROXY这类环境变量有的话清掉。5.3 reading choices 报错现象调用模型时返回 error reading choices 或类似解析错误。这多半是模型 ID 写错了。ANTHROPIC_MODEL填的模型必须是你账号里能调到的。去 TaoToken 控制台 https://taotoken.net/console 看一眼可用模型列表把 ID 复制准确。还有一种可能是返回内容被截断检查一下是不是 max_tokens 设太小。5.4 OAuth 相关报错现象飞书 CLI 登录时报 OAuth 错误或者lark-cli auth status显示未登录。先确认lark-cli config init那一步的应用创建完成了App ID 和 App Secret 都拿到了。然后重新跑lark-cli auth login --recommend浏览器授权页要确认到底不能中途关掉。如果还是不行检查系统时间是否准确OAuth 对时间偏差敏感。5.5 技能没生效现象Claude Code 不知道飞书 CLI 怎么用或者提示找不到技能。检查~/.claude/skills目录下有没有飞书相关的技能文件。没有的话重新跑npx skills add larksuite/cli -y -g。装完重启 Claude Code让它重新加载技能。5.6 三件套再确认如果上面都排查了还不行回到三件套Base URL、Key、Model ID。这三个只要有一个不对整条链路就断。对照第 3.4 节的表格逐项核对。排障过程中如果拿不准可以直接问 Claude Code帮我检查一下 settings.json 里的配置对不对它会读文件帮你核对。6. 语义一致 CTA把这条链路用起来链路跑通之后接下来就是日常使用。给你几个分流建议按你的实际需求走。如果你主要想验证模型效果、试试不同模型的写作质量去模型对话页面直接聊https://taotoken.net/model-chat 。不用配环境打开就能用适合先感受一下再决定要不要接进 Claude Code。如果你已经确定要长期用 Claude Code 写内容、跑 Agent 任务建议上 Coding Plan额度更划算适合高频调用https://taotoken.net/coding-plan 。如果你在配置过程中卡住了需要看更详细的接入文档去这里https://taotoken.net/doc 。里面有各客户端的配置示例Claude Code、Cline、Codex 都有。Key 管理和重新生成在控制台https://taotoken.net/console 。API Keys 页面https://taotoken.net/api-keys 。最后说个实用技巧这套流程里飞书云文档是原件仓库建议按月份建文件夹比如2026-03 公众号每篇文章存进去。以后要找旧文、让 AI 基于旧文二次创作直接搜飞书就行全文检索几秒出结果比在本地翻文件快得多。工具是手段链路跑顺了剩下的就是把内容写好。
返回列表