1. 为什么要在 douyin 下载工具里用 Claude Code /loop如果你正在写一个 douyin 视频下载工具大概率经历过这种循环改一行解析逻辑手动跑一次脚本盯着终端等 Playwright 打开页面、等媒体流 URL 被捕获、等 ffmpeg 合并落盘然后目视检查输出目录里到底有没有生成 mp4。一次两到三分钟一天改二十次就是一个小时纯等待。Claude Code 从 v2.1.71 开始内置了/loop命令它做的事情很朴素在当前终端会话存活期间按你指定的间隔自动重复执行一段自然语言指令。你可以把它理解成给 AI 助手挂了一个定时器但这个定时器执行的不是死板的 shell 命令而是能读懂脚本输出、能判断字段、能根据结果决定要不要通知你的智能任务。这篇文章聚焦的场景很具体用/loop加速 douyin 视频下载工具的开发迭代。适合两类人——一类是已经在用 Claude Code 写代码、想让重复验证自动化的开发者另一类是刚接触 openclaw Skill 体系、想找一个真实案例把/loop跑通的人。全文会给出可复制的/loop配置片段、douyin 下载脚本的骨架结构、运行验证步骤以及如何通过 TaoToken 统一 Key 和 API 通道把模型能力接进来做到端到端跑通。需要先明确一点/loop不是万能的守护进程。它的作用域仅限当前会话终端一关就失效任务最多存活 3 天。所以它最适合的位置是开发期的临时验证器而不是生产环境的监控系统。理解这个边界后面的用法才不会跑偏。2. TaoToken 前置准备统一 Key 与 API 通道在写/loop指令之前得先让 Claude Code 能稳定调用模型。这里我用 TaoToken 作为统一的 API 通道好处是一个 Key 管所有模型调用不用在多个平台之间来回切换配置。TaoToken 的定位是模型 API 聚合接入层官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点固定为 https://taotoken.net/api 。它不替代编辑器也不碰你的本地代码只负责把请求转发到对应的模型服务。2.1 拿到 API Key登录后进入控制台在 API Keys 页面创建一个新 Key。建议按用途命名比如claude-code-dev方便后面区分开发和生产。创建后立刻复制保存页面刷新后就看不到完整 Key 了。控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite2.2 配置 Claude Code 的接入参数Claude Code 读取环境变量来定位 API 端点。在 Windows PowerShell 里可以这样设置macOS/Linux 用export$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_API_KEY sk-你的TaoToken密钥如果你用的是 Claude Code 的 settings 文件方式可以在~/.claude/settings.json里写{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥 }, model: claude-sonnet-4-20250514 }这里三个要素必须齐全Base URL 指向https://taotoken.net/apiKey 用刚创建的Model ID 填你实际要用的模型标识。少任何一个Claude Code 启动时都会报鉴权或路由错误。2.3 验证通道是否通配置完先别急着写/loop用一条最简单的请求确认通道可用curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: 回复 ok}] }返回体里出现正常的content字段就说明通道没问题。如果返回 401先检查 Key 有没有复制完整如果返回连接超时检查 Base URL 有没有多写或少写/api。这一步做完Claude Code 就有了稳定的模型调用能力接下来/loop的每一次触发才有意义。如果你还想在网页端直接对比不同模型的输出效果可以用模型对话页面快速试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite3. 可复制的 /loop 配置与 douyin 下载脚本骨架这一节是全文的核心操作区。我会先给出 douyin 下载 Skill 的目录结构再给出两条可以直接抄的/loop指令最后说明每条指令里每个参数为什么这么写。3.1 douyin 下载 Skill 的目录结构假设你的 openclaw Skill 放在C:\Users\your-username\.openclaw\skills\douyin-kukutools-weixin\结构如下skills/douyin-kukutools-weixin/ ├── SKILL.md └── scripts/ ├── download-douyin-kukutool.ps1 # PowerShell 入口 ├── download-douyin-kukutool.mjs # Node.js 核心逻辑 ├── config-manager.ps1 # 环境路径管理 ├── check-dependencies.ps1 # 依赖检查 ├── stage-douyin-download.ps1 # 文件落盘 └── install-checker.ps1 # 安装后自检核心流程在.mjs里解析分享文本提取 douyin URL用 Playwright 无头浏览器打开页面监听 request/response 事件捕获视频和音频 URL有音视频分离就用 ffmpeg 合并没有音频流就直接下载视频流。主路径失败时降级到直接 API 下载。3.2 /loop 指令一依赖可用性持续检查check-dependencies.ps1会输出四个依赖的状态 JSON包含 NodeJS、Chrome、FFmpeg、Playwright 的 Installed 字段和 Path。但它只在开发初期手动跑过一次后续改路径解析逻辑时没有自动验证机制。用这条/loop每 5 分钟自动跑一次/loop 5m 执行 powershell -NoProfile -ExecutionPolicy Bypass -File C:\Users\your-username\.openclaw\skills\douyin-kukutools-weixin\scripts\check-dependencies.ps1。 分析输出的 JSON - NodeJS.Installed 是否为 trueVersion 是否包含 v24 - Chrome.Installed 是否为 truePath 指向的文件是否确实存在 - FFmpeg.Installed 是否为 true - Playwright.Installed 是否为 true 任意一个 Installed 为 false 或路径对应的文件不存在 → 立刻通知具体是哪个依赖挂了。 全部正常 → 静默不输出。这条指令的关键设计在于脚本本身只检查路径是否注册但不会验证路径指向的文件是否真实存在。所以在 loop 指令里额外加了Path 指向的文件是否确实存在这一条用 AI 的判断能力弥补脚本检查的盲区。如果你改config-manager.ps1时把 Chrome 路径写坏了5 分钟内就会收到通知不用等到跑完整下载测试才发现 Playwright 启动不了。3.3 /loop 指令二端到端下载流程验证第二条指令用一条固定的 douyin 链接作为测试输入定时跑全流程/loop 5m 执行以下端到端测试 powershell -NoProfile -ExecutionPolicy Bypass -File C:\Users\your-username\.openclaw\skills\douyin-kukutools-weixin\scripts\download-douyin-kukutool.ps1 -ShareText https://v.douyin.com/xxxx/ douyin测试链接 检查输出 1. 退出码是否为 0 2. JSON 中 ok 是否为 true 3. path 字段是否非空且指向的 mp4 文件是否存在且大小 1KB 4. 如果 fallbackMode 为 direct-play标记为 触发降级路径 → 通知我但不视为失败 任意条件不满足 → 输出完整的 stderr 和 JSON 片段。 连续 3 次全部通过且未触发降级 → 回复 端到端测试通过 并自动停止。 触发降级的通过也算通过但额外报告降级次数。这里有几个参数值得展开。间隔5m匹配代码修改节奏改完一轮代码刚好等到下一次验证。检查条件全部是机器可判定的——退出码、字段存在、文件大小不依赖人工主观判断。停止条件写了两层连续 3 次通过就停避免开发完了还在空转同时触发降级的通过也算通过这个设计让非致命问题不会中断验证但降级趋势会被记录。3.4 脚本骨架里的关键片段download-douyin-kukutool.mjs的 main 函数大致长这样重点是输出结构要能被/loop解析async function main(shareText) { const url extractDouyinUrl(shareText); if (!url) { console.log(JSON.stringify({ ok: false, error: URL 提取失败 })); process.exit(1); } try { const media await captureMediaWithPlaywright(url); const outPath await mergeWithFfmpeg(media); console.log(JSON.stringify({ ok: true, path: outPath, fallbackMode: null })); } catch (err) { const fallbackPath await directApiDownload(url); console.log(JSON.stringify({ ok: true, path: fallbackPath, fallbackMode: direct-play })); } }输出 JSON 里ok、path、fallbackMode三个字段就是/loop判断的依据。字段名一旦定下来loop 指令里的检查条件就跟着固定不要中途改名。4. 运行验证从启动 loop 到看到成功结果配置写好了接下来是实际跑一遍确认整条链路能通。4.1 启动 Claude Code 并确认接入在终端进入你的项目目录启动 Claude Code。启动后先问一句当前使用的 API 端点是什么确认它读到的是https://taotoken.net/api。如果显示的是默认端点说明环境变量没生效回到第 2 节检查 settings 文件路径或 PowerShell 会话是否重开。4.2 先手动跑一次脚本在挂/loop之前先手动执行一次下载脚本确认基线是通的powershell -NoProfile -ExecutionPolicy Bypass -File C:\Users\your-username\.openclaw\skills\douyin-kukutools-weixin\scripts\download-douyin-kukutool.ps1 -ShareText https://v.douyin.com/xxxx/ douyin测试链接观察输出 JSON。理想结果是ok: truepath指向一个真实存在的 mp4 文件fallbackMode为 null。如果这里就失败了先解决脚本本身的问题别急着上 loop——loop 只会把失败重复放大。4.3 挂上 /loop 并观察手动跑通后在 Claude Code 会话里输入第 3 节的依赖检查指令。你会看到它立即执行一次然后进入等待。5 分钟后自动触发第二次。此时你可以去改config-manager.ps1里的某个路径故意写错等下一次触发时看它是否准确报出是哪个依赖挂了。确认告警有效后按 Esc 取消这条 loop再挂上端到端验证那条。这次不要改代码让它连续跑 3 次。第 3 次通过后它应该回复端到端测试通过并自动停止。4.4 用 /loop list 确认状态任何时候输入/loop list可以查看当前活跃的定时任务。开发结束后养成习惯先看一眼确认没有残留任务在空转。如果发现忘了停的按 Esc 手动取消。4.5 成功结果的判断标准一次完整的成功验证应该满足依赖检查连续多次静默无告警端到端测试连续 3 次ok: true且fallbackMode为 null输出目录里确实生成了可播放的 mp4 文件。三者齐了才算这条链路真正跑通。5. 本篇常见报错排查实际跑的时候报错基本集中在这几类。我按真实遇到的顺序列出来对照着查。5.1 401 鉴权失败报错长这样{error:{type:authentication_error,message:invalid x-api-key}}。原因通常是 Key 复制时带了空格或者环境变量名写错。Claude Code 读的是ANTHROPIC_API_KEY不是ANTHROPIC_KEY也不是TAOTOKEN_KEY。检查 settings.json 里的字段名以及 PowerShell 里$env:ANTHROPIC_API_KEY是否真的被赋值。可以echo $env:ANTHROPIC_API_KEY打印出来看前几位。5.2 local proxy failed / 连接被拒报错类似API Error: Connection error或local proxy failed。这类多半是 Base URL 写错。正确值是https://taotoken.net/api注意结尾没有斜杠中间是/api不是/v1。有些教程会让你填/v1/messages那是完整请求路径不是 Base URL。填错了 Claude Code 会拼出双份路径导致 404 或连接失败。5.3 reading choices 相关报错报错里出现Cannot read properties of undefined (reading choices)。这是响应体结构和客户端预期不匹配。常见于 Model ID 填了一个不存在的模型服务端返回了错误结构客户端却按正常结构去取choices字段。回到 settings.json 确认 Model ID 拼写用第 2 节 curl 命令单独验证该模型能否正常返回。5.4 OAuth 相关报错报错提示OAuth token expired或要求重新登录。Claude Code 在某些配置下会尝试走 OAuth 流程但用 API Key 接入时不应该触发。如果出现检查是不是同时存在旧的登录态缓存。清理~/.claude/下的凭据缓存文件只保留 settings.json 里的 API Key 配置。5.5 /loop 不触发或立即停止如果/loop输入后没有任何反应先确认 Claude Code 版本是否 ≥ v2.1.71。低版本没有这个命令。如果它执行一次就停了检查指令里是不是写了连续 N 次通过后停止但当前状态已经满足——比如依赖检查那条如果一开始就全部正常它会静默看起来像没跑其实是在正常工作。5.6 脚本路径含空格导致执行失败Windows 路径里如果有空格PowerShell 的-File参数必须用引号包住整个路径。第 3 节的指令里已经加了引号如果你改路径时漏了引号会报无法将参数绑定到参数 File。6. 把 /loop 用顺手的几个经验/loop真正省下的不是写代码的时间是改完代码后手动执行命令、目视检查输出、等待超时这些碎片操作的等待时间。但它有明确的边界新链接格式适配、Playwright 的 DOM 选择器调试、微信端回传验证这些仍然需要人工确认。loop 是回归测试工具不能替代探索性测试。Token 消耗要心里有数。每次触发都是一轮完整的 Agent 对话包含系统 prompt 和工具定义。5 分钟间隔一天 288 次按每次约 800 token 算月消耗在 690 万量级改成 15 分钟间隔能降到 230 万左右。所以开发期用短间隔时务必带停止条件别让它空转。如果你打算长期做编码和 Agent 相关的开发可以考虑 Coding Plan 把调用额度固定下来https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档在这里遇到配置问题可以对照查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite最后提醒一句每次开始新 loop 前用/loop list确认没有残留任务这个习惯能帮你省下不少意外消耗。