作者注:把 Apidog 场景运行命令写进 CLAUDE.md,让 Claude Code 按现成场景跑 API 自动化测试,以退出码判定结果,并以 Seedance 视频接口为例设计计费与审核相关断言。
如果你已经在用 Claude Code 写接口代码,大概率遇到过这种情况:改完一个字段,还得切到 Apidog 手动点一次场景运行,再回来告诉 Claude Code 结果。本文介绍的做法是 把 Apidog CLI 的场景运行命令写进 CLAUDE.md,让 Claude Code 自己跑测试、自己读退出码,从而把 Claude Code API自动化测试 变成一个闭环。
这不是又一篇 Claude Code 入门科普。文中 Apidog 的操作步骤来自 Apidog 官方发布的厂商教程,Seedance 的计费与审核规则来自 API易 文档原文,二者都会在正文中明确标注来源,方便你自行核对。
核心价值:读完本文,你将知道如何在 CLAUDE.md 里固定运行命令、为什么要以退出码而不是模型的口头结论判定通过与否、令牌应该放在哪里,以及针对异步视频接口应该写哪几条真正有意义的断言。

Claude Code API自动化测试 Apidog 核心要点
在动手之前,先把整套方案拆成几个关键决策点。下表汇总了厂商教程和 API易 文档中与本方案相关的核心约束,每一条都直接影响测试能否稳定复现。
| 要点 | 说明 | 价值 |
|---|---|---|
| 运行命令写进 CLAUDE.md | Claude Code 会读取仓库根目录的 CLAUDE.md,命令形状为 apidog run -t 场景ID -e 环境ID -r cli |
每次会话都按同一条命令跑,不靠记忆 |
| 以退出码判定结果 | 退出码 0 表示断言全部通过,非 0 表示存在失败 | 避免模型“说过了”但实际没过 |
| ID 从 CI/CD 页复制 | 场景 ID、环境 ID 在 Apidog 该场景的 CI/CD 页获取 | 防止模型现编 ID 导致场景找不到 |
| 令牌不进文件 | 本机用 apidog login 登录,不在 CLAUDE.md 中写 --access-token |
避免令牌随仓库提交泄露 |
| 两类端点分开 | 驱动 Claude Code 的文本模型与被测视频接口不是同一个端点 | 配置清晰,计费可追溯 |
Claude Code 读取 CLAUDE.md 的工作方式
根据 Apidog 厂商教程,工具本体是 npm 包 apidog-cli,Claude Code 启动时会读取仓库根目录的 CLAUDE.md 作为项目说明。也就是说,你在这个文件里写下的运行命令、判定规则和禁止事项,会成为 Claude Code 每次会话的上下文。如果不确定本次会话到底加载了哪些说明文件,可以在 Claude Code 中执行 /memory 查看。
这一点决定了方案的稳定性。与其每次在对话里重复“请帮我跑一下 Apidog 场景”,不如把命令一次性固化。Claude Code 改完代码后,会依据 CLAUDE.md 的说明调用 apidog run,并根据终端输出决定是继续修复还是结束任务。
Apidog CLI 退出码与报告格式详解
厂商教程强调 -r cli 这个报告格式必须保留,因为 Claude Code 依靠终端输出来判断下一步动作。如果你还想要一份可以在浏览器打开的报告,可以在 -r 参数中追加 html,生成的文件位于 ./apidog-reports 目录。注意是“追加”而不是“替换”,去掉 cli 报告会让 Claude Code 失去读取结果的依据。
退出码是整套方案的裁判。教程给出的核对顺序值得照搬:先确认终端里真的出现了 apidog run 这条命令;再看退出码,当退出码与模型的口头结论不一致时,以退出码为准;如果提示场景找不到,回到 CLAUDE.md 检查 ID 是否正确。

Claude Code API自动化测试 快速上手
本节按“准备环境 → 写 CLAUDE.md → 配权限 → 跑第一次”的顺序展开。由于是在线教程形式,所有命令都以行内代码给出,你可以逐条复制到终端执行。
第一步:配置 Claude Code 的模型接入地址
驱动 Claude Code 本身就要消耗 token,后面调用被测视频接口还要再花一笔,所以先把两类接入地址分清楚。通过 API易 接入时,Claude Code 走 Anthropic 原生协议,地址是 https://api.apiyi.com,不要在后面再加 /v1,否则会拼成 /v1/v1/messages 而请求失败。只有 OpenAI 兼容协议的客户端,地址才是 https://api.apiyi.com/v1。
具体做法是在启动 Claude Code 的 shell 中设置环境变量:ANTHROPIC_BASE_URL 设为 Anthropic 原生地址,ANTHROPIC_AUTH_TOKEN 设为你在平台创建的令牌。Claude 系列模型的令牌建议放在 ClaudeCode 分组,与后面视频接口使用的令牌分开管理。
🚀 快速开始:官方推荐的做法是在 API易 apiyi.com 控制台为 Claude Code 与被测接口分别创建令牌。新用户有免费测试额度,足够把第一条场景跑通后再决定长期用哪个模型。
第二步:在 CLAUDE.md 中写入测试说明
根据厂商教程,CLAUDE.md 中与测试相关的内容建议包含以下几条,每条用一句话写清楚即可:
- 运行命令:回归测试使用
apidog run -t <场景ID> -e <环境ID> -r cli,其中两个 ID 直接填写从 Apidog CI/CD 页复制的真实值。 - 判定规则:以命令退出码判断结果,0 为全部通过,非 0 为存在失败,不以自然语言总结作为结论。
- 禁止事项:不要自行编造或修改场景 ID、环境 ID;不要在命令中添加
--access-token。 - 报告要求:保留
-r cli,如需浏览器报告可追加html,产物位于./apidog-reports。 - 区域说明:如果项目部署在 Apidog 欧洲区,命令需另加
--api-base-url api.eu.apidog.com,这是 Apidog 自身的区域地址,与模型接入地址无关。
第三步:登录与权限配置
令牌管理是最容易出事的环节。厂商教程的建议是在本机执行一次 apidog login 完成登录,明确不要把令牌写进 CLAUDE.md,也不要在这个文件里出现 --access-token。CLAUDE.md 通常会随仓库提交,一旦写入令牌就等同于公开。
Claude Code 默认在执行 Bash 命令前会先询问。如果你希望它自动运行测试,可以在 .claude/settings.json 的权限 allow 列表中加入 Bash(apidog run *),只放行这一类命令。教程同时提醒,--dangerously-skip-permissions 只适合 CI 这种一次性环境,不适合每天常开的本机。
| 配置项 | 推荐做法 | 不推荐做法 | 来源 |
|---|---|---|---|
| Apidog 登录 | 本机 apidog login |
在 CLAUDE.md 写 --access-token |
厂商教程 |
| 命令放行 | allow Bash(apidog run *) |
本机常开 --dangerously-skip-permissions |
厂商教程 |
| 场景 ID | 从 CI/CD 页复制 | 让模型推测或生成 | 厂商教程 |
| Claude Code 地址 | ANTHROPIC_BASE_URL 不带 /v1 |
带 /v1 导致路径重复 |
API易 文档 |
| 令牌分组 | Claude 用 ClaudeCode,视频用 SeeDance2 |
一个令牌混用所有分组 | API易 文档 |
第四步:跑通第一次并核对
配置完成后,让 Claude Code 执行一次回归测试。按照厂商教程的核对顺序,你需要亲眼确认三件事:终端出现了完整的 apidog run 命令;命令返回了明确的退出码;如有失败,终端输出中能看到具体是哪条断言没过。三件事都满足,这条闭环才算真正建立。
💡 技术建议:第一次跑通时,可以故意把某个断言的期望值改错,确认退出码会变成非 0、Claude Code 会据此继续排查。这一步能验证“以退出码为准”的规则确实生效了。
Claude Code API自动化测试 实战:Seedance 视频接口断言设计
文本接口的测试比较直观,异步视频接口才真正考验断言设计。本节以 API易 已上架的 Seedance 系列为例,说明 Apidog 场景里应该断言什么、不应该断言什么。
Seedance 型号、分组与价格
根据 API易 文档,Seedance 可用的模型 ID 为 doubao-seedance-2-5-260628、doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128 和 doubao-seedance-2-0-mini-260615。调用这些型号的令牌必须属于 SeeDance2 分组,否则会返回“该模型无可用渠道”。被测视频接口与驱动 Claude Code 的文本模型是两个不同端点,不是把 model 字段改一下就能通用,Apidog 场景里要按 Seedance 文档单独配置提交与查询请求。
下表为价格总表(更新于 2026-11-16)中的按量标价,单位为美元 / 100 万 tokens。型号与价格以平台型号列表为准。
| 模型 | 输入 | 输出 | 缓存读 | 可用平台 |
|---|---|---|---|---|
doubao-seedance-2-5-260628 |
70 | 70 | 无 | API易 apiyi.com |
doubao-seedance-2-0-260128 |
46 | 46 | 无 | API易 |
doubao-seedance-2-0-fast-260128 |
37 | 37 | 无 | API易 |
doubao-seedance-2-0-mini-260615 |
23 | 23 | 无 | API易 |
文档中还给出了 720p、5 秒视频的折算例子:2.5 约 1.3721 美元,2.0 标准版约 0.9074 美元。需要强调的是,这只是把每百万 token 单价换算成单条视频的示例,和总表并不是两套价格。
五条推荐断言
下面这五条断言都基于文档原文,可以直接落进 Apidog 场景:
- 任务有 ID:提交请求成功后,响应中必须包含任务 ID,后续轮询依赖它,没有 ID 即判定失败。
- 时长显式传入:文档原文写明 2.5 的 duration 缺省值为 -1,测试请求要显式传入时长,否则不同轮次的费用无法比较。
- 参数错误不计费:文档原文写明 HTTP 400 参数错误不计费,可构造一个缺少必填字段的请求,断言状态码为 400 并在日志中确认无扣费。
- 审核拦截不计费:文档原文写明以
PUBLIC_为前缀的错误是上游内容审核拦截,同样不计费。断言只负责识别这类错误码,并把它与参数错误区分为两种失败。 - 两条日志相加才是总价:文档原文写明一条视频在日志中有两条扣费记录,提交时预扣,完成后多退少补,总花费是两条之和。
关于预扣金额,文档原文给出的是 2.0 系约 0.09 美元/秒、2.5 约 0.135 美元/秒,完成后按实际 token 结算。所以成本断言不能只看第一条日志,那只是预扣值。

哪些内容不应该写成测试
审核拦截是合规边界,不是要“打穿”的用例。文档明确建议审核失败后不要用同一条提示词反复重试,因此场景里也不应设计循环重试或试探审核规则的步骤。同样,含真人脸的参考图会被上游拒绝,需要先入库再通过 asset:// 引用,这是合规前置条件,应当写进测试数据准备说明,而不是一条测试用例。
📊 数据说明:上述 Seedance 计费与审核规则均摘自 API易 文档原文,可在 apiyi.com 文档中心的 Seedance 页面核对最新描述后再固化进断言。
Claude Code 驱动模型的选择与成本
Claude Code 跑测试本身也在消耗 token,选哪个模型会直接影响日常成本。下表为价格总表中三个 Claude 型号的标价,单位同样为美元 / 100 万 tokens,均支持 chat 与 messages 端点。
| 模型 | 输入 | 输出 | 缓存读 | 分组 |
|---|---|---|---|---|
claude-opus-5-5 |
4 | 20 | 0.2 | ClaudeCode、Claude_Reverse、Claude_Enterprise、Default、SVIP |
claude-sonnet-5-5 |
2 | 10 | 0.1 | 同上 |
claude-haiku-5-5 |
0-10 万 tokens 为 0.1,超过为 0.5 | 0.5 | 0.01 | ClaudeCode、Claude_Enterprise、Default、SVIP |
注意 Haiku 这一行没有 Claude_Reverse 分组,如果你的令牌只在该分组下,切换到 Haiku 会无可用渠道。一个常见的思路是:日常让 Claude Code 跑回归、读退出码这类结构化任务时用较轻的型号,遇到复杂失败需要深入排查再切换到更强的型号。
💰 成本优化:由于驱动模型和被测接口两边都在计费,建议在 API易 控制台按令牌维度查看用量日志,分别统计 Claude Code 的消耗与 Seedance 的消耗,判断测试成本主要花在哪一侧。
常见问题 FAQ
Q1:什么是 Claude Code API自动化测试 的 Apidog 方案?
就是把 Apidog CLI 的场景运行命令写进仓库根目录的 CLAUDE.md,让 Claude Code 在改完代码后自行执行 `apidog run`,并依据退出码判断测试是否通过,从而免去手动点击运行。
Q2:为什么要以退出码为准,而不是 Claude Code 的结论?
模型的自然语言总结可能出现偏差,退出码则是测试工具给出的确定结果。厂商教程明确写道,二者不一致时以退出码为准:0 为全部通过,非 0 为存在失败。
Q3:Claude Code 接入地址要不要加 /v1?
不要。Claude Code 走 Anthropic 原生协议,地址是 `https://api.apiyi.com`,加 `/v1` 会拼成 `/v1/v1/messages`。只有 OpenAI 兼容客户端才使用带 `/v1` 的地址。
Q4:Apidog 令牌应该放在哪里?
本机用 `apidog login` 登录即可。厂商教程明确要求不要在 CLAUDE.md 中写 `–access-token`,也不要把令牌写进这个文件,以免随代码仓库一起泄露。
Q5:如何开始调用 Seedance 做视频接口测试?
在 API易 apiyi.com 注册后创建属于 `SeeDance2` 分组的令牌,按 Seedance 文档配置提交与查询请求,并在 Apidog 场景中加入任务 ID、显式时长、错误码分类和两条扣费日志等断言。新用户的免费测试额度可用于跑通首条场景。
Q6:Claude Code 提示场景找不到怎么办?
先确认终端中实际执行的命令,再回到 CLAUDE.md 检查场景 ID 与环境 ID,务必从 Apidog 该场景的 CI/CD 页重新复制,不要让模型推测。欧洲区项目还要确认是否加了 `–api-base-url api.eu.apidog.com`。
Q7:这套方案有哪些限制?
一是双重计费,Claude Code 与被测接口各自消耗 token;二是权限放行要克制,本机只放行 `Bash(apidog run *)`;三是审核拦截与真人脸参考图属于合规边界,只能识别和前置处理,不能设计成绕过类用例。
Claude Code API自动化测试 核心要点 Key Takeaways
- 命令固化:把
apidog run -t -e -r cli写进 CLAUDE.md,每次会话按同一命令执行。 - 退出码裁判:0 为通过,非 0 为失败,与口头结论冲突时以退出码为准。
- 令牌隔离:本机
apidog login登录,令牌与--access-token都不进 CLAUDE.md。 - 权限最小化:只放行
Bash(apidog run *),跳过权限的参数仅用于 CI。 - 地址分清:Claude Code 用不带
/v1的原生地址,OpenAI 兼容才带/v1。 - 视频断言:任务 ID、显式时长、400 与
PUBLIC_分类、两条日志合计总价。 - 上手方式:在 API易 分别创建
ClaudeCode与SeeDance2分组令牌,用免费额度跑通首条场景。
总结
Claude Code API自动化测试 结合 Apidog 的关键在于三点:
- 让命令和规则落在文件里:CLAUDE.md 承载运行命令、判定规则和禁止事项,令牌则交给
apidog login。 - 让退出码说了算:保留
-r cli输出,按厂商教程的顺序核对命令、退出码和 ID。 - 让断言贴合真实计费:异步视频接口要断言任务状态、区分参数错误与审核拦截、合计两条扣费日志,并显式传入时长。
建议先用一条最简单的文本接口场景把闭环跑通,再逐步加入 Seedance 这类异步接口的断言。推荐通过 API易 apiyi.com 用同一个账号管理 Claude Code 与被测模型的令牌和用量,两侧成本一目了然,便于持续优化测试开销。
📚 参考资料
- Apidog 厂商教程:在 Claude Code 中使用 Apidog CLI:作者署名 INEZA Felin-Michel,版本日期以站点显示为准
- 链接:
apidog.com/blog/apidog-cli-in-claude-code -
说明:CLAUDE.md 写法、退出码规则、权限配置与核对顺序的来源
-
Apidog CLI 官方介绍:CLI 面向 Agent 与 CI 的定位及区域参数
- 链接:
docs.apidog.com/en/introduction-to-apidog-cli-605134m0 -
说明:包含欧洲区
--api-base-url说明 -
API易 Seedance 2 文档:模型 ID、分组、计费与审核规则
- 链接:
docs.apiyi.com/api-capabilities/seedance2/overview -
说明:本文视频断言设计的依据
-
API易 模型价格总表:各型号按量标价与分组
- 链接:
docs.apiyi.com/models -
说明:型号与价格以此页最新内容为准
-
API易 协议说明:Anthropic 原生与 OpenAI 兼容地址区别
- 链接:
docs.apiyi.com/llms.txt - 说明:解释为何 Claude Code 地址不能带
/v1
作者:APIYI 技术团队
技术交流:欢迎在 API易 网站首页联系我们,更多资料可访问 docs.apiyi.com 文档中心