Claude自动跑接口测试：这套自然语言工作流火了|access|工作流|接口测试|自然语言|调用

01、流程构建

这套流程都由哪些工具组成呢？总共3个，分别是：

Apifox CLI：Apifox 提供的命令行工具，可在终端中直接调用 CLI 命令并生成测试报告。
Claude Code：Anthropic 推出的命令行 AI 助手，支持在终端中操作文件、执行命令及运行脚本。
Claude Skills：作为 Claude Code 的扩展能力，用于定义 Claude 执行特定任务的操作步骤，相当于一份结构化的执行说明。

在该工作流中，Claude Code 负责解析自然语言指令。当指令匹配到预设的 Claude Skills 时，系统将自动执行对应的 Apifox CLI 命令，并对执行结果进行解读与分析。

02、应用场景

这套流程的5个场景：

场景1：执行单个测试；
以登录功能为例：只需在 Claude Code 中输入“帮我跑一下登录功能的测试，用开发环境”，Claude 便会立即执行测试，并在运行结束后自动分析结果，给出清晰的总结反馈。

即使失败，它也会总结失败原因。

场景2：查看所有可用测试

同样，如果你想了解当前支持哪些测试，可以问 Claude：“有哪些测试可以执行？” 它会自动执行脚本，将所有可用的测试场景或测试套件展示出来。

场景3：执行某个业务模块的所有测试

当你需要一次性完成支付相关所有测试时，可输入：“用测试环境跑一下支付相关的所有测试”。Claude 将智能识别对应的测试文件，并以串行或并行方式快速执行。

场景4：对比不同环境的测试结果
以登录功能为例：只需输入“用开发环境和测试环境跑一下登录功能的测试”，Claude 便会分别在两个环境中执行测试，并自动分析结果的异同，帮助你快速定位环境差异带来的影响。

场景5：根据代码变更执行测试
当你完成代码更新后，可让 Claude 精准执行受影响的测试，无需跑全量用例。例如输入：“根据最近的代码变更，在开发环境跑一下受影响的接口测试”。Claude 会自动解析 Git 变更记录，定位受影响的功能范围，并执行对应的测试场景，有效节约时间和资源。

上述我们了解了该套流程的应用场景，那该流程如何安装使用呢？我们接下来继续学习~

03、安装应用

环境要求：

必装Node 环境，可打开终端验证：

node-v

npm -v

安装 Apifox CLI

通过 npm 安装：

npm install -gapifox-cli

apifox--version

看到版本号则说明安装成功。

可以到 Apifox 的「自动化测试 -> CI/CD」中，复制一个“测试场景”或者“测试套件”的 CLI 命令到终端执行，记得添加 Access Token。

当看到测试输出时就说明 Apifox CLI 能正常工作了。

特别提示：需要将 Apifox 客户端和 Apifox CLI 更新到最新版，才能使用最新的“测试套件”功能。

安装 Claude Code

通过 npm 安装：

npm install -g@anthropic-ai/claude-code

claude --version

首次运行需要登录：

claude

照提示完成授权，需要 Claude 账号（可以通过某鱼或一些中转站解决账号问题）。

Claude Skills 的构建

理解 Skills 的工作原理

使用 Claude Code 时，你无需手动指定要调用的 Skill，只需用一句话描述你的需求，Claude 便会自动匹配并执行合适的 Skill 来完成。

只要你输入的自然语言与某个 Skill 的描述相匹配，Claude 就会加载该 Skill，并按照其中定义的流程执行任务。

步骤 1：创建 Skill 目录
Skill 的目录结构遵循以下规范：所有配置文件统一存放于路径下，每个 Skill 拥有自己独立的子目录。下面，我们将在项目根目录中，为 Apifox 自动化测试搭建一个最小可用的 Skill 目录：

.claude/skills/

mkdir-p .claude/skills/apifox-tests

执行完成后，目录结构如下：

.claude/skills/apifox-tests/

后续我们会在这个目录中，逐步添加 Skill 的入口文件和执行脚本等内容。

步骤 2：创建 SKILL.md

每个 Skill 都需要一个 SKILL.md 文件，用来说明当这个 Skill 被匹配到时，Claude 应该如何一步步完成任务。

SKILL.md 以 --- 包裹的 YAML 元信息开始，其中 name 和 description 是必需字段。

description 尤其重要，它用于帮助 Claude 判断在什么场景下应该启用这个 Skill，所以这里要根据你的业务写触发条件。

在 YAML 之后的 Markdown 内容中，则用于描述这个 Skill 被启用后，Claude 具体应该怎么做，包括判断逻辑、执行步骤、引用的脚本、以及需要遵循的约束规则。

步骤 3：补充 Skill 所需的支持文件

前面我们已经创建了 SKILL.md，用于定义触发条件和整体执行流程。

接下来其余文件都只是对 SKILL.md 的补充，当流程中需要其它信息，比如运行环境、执行命令或测试定义时，再按需引入对应的文件即可。

最终，这个 Skill 的目录结构如下：

.claude/skills/apifox-tests/

├── SKILL.md # Skill 入口，定义触发条件和整体流程

├──env/ # 运行环境配置（如 dev / test / prod），用于区分不同测试环境

│ ├── dev.env # 开发环境

│ ├── test.env # 测试环境

│ └── prod.env # 生产环境

├── scripts/ # 执行脚本（被 SKILL.md 调用）

│ ├── list-tests.js # 列出 tests 目录下的所有测试

│ └── run-cli.js # 负责组装并执行 Apifox CLI 命令

└── tests/ # 测试定义（每个文件对应一个测试场景或测试套件）

├── 支付流程.md

└── 退款流程.md

如上所说，支持条件包括：环境配置执行脚本以及测试定义等，接下来我们针对这3个的作用和说明再详细说明：

环境配置：

env/ 目录用于存放不同运行环境对应的变量配置，例如 Apifox 的访问令牌（Access Token）和环境 ID。

将环境 ID 抽离为变量，可以让我们在不改任何命令或脚本的情况下，快速切换测试运行环境（如开发 / 测试 / 生产）。

例如，在 env/ 目录下创建 dev.env 文件：

APIFOX_ACCESS_TOKEN=APS-你的访问令牌

APIFOX_ENV_ID=你的环境ID

如果需要支持多个环境，可以按照同样的方式创建：

test.env
prod.env

每个文件只需要维护对应环境的变量即可。

特别说明：env/ 目录的 .env 文件包含访问令牌，是敏感信息，不能提交到 Git。

执行脚本（scripts）

scripts/ 目录用于存放可直接执行的脚本，负责把「测试定义」转换为实际可运行的 Apifox CLI 命令，并完成环境变量注入与执行。

本文采用 Node.js 编写 Skill，主要基于两大考量：

环境一致性：Apifox CLI 基于 Node.js，复用同一环境可避免引入 Python 等其他运行时，降低配置复杂度。
成本优化：将核心逻辑（命令解析、变量注入、执行）封装于脚本，避免 Claude 在对话中重复组装 CLI 命令，从而减轻上下文负担、节约 tokens。

如果你对脚本不熟悉，也可以选择不使用，而是在 SKILL.md 中直接让 Claude 组装并执行 CLI 命令，只是上下文成本会更高一些。

在 scripts/目录下新建 run-cli.js，它的核心功能包括：

命令提取：从 Markdown 测试文件中获取 Apifox CLI 命令；
环境加载：根据用户指定的环境（如 dev / test）读取对应的 .env 文件；
测试执行：注入环境变量并运行测试。

同样在 scripts/ 下创建 list-tests.js，用于：

递归扫描 tests/ 目录
查找所有 Markdown 测试文件
提取首行描述信息
输出当前所有可用的 Apifox 自动化测试列表

测试定义（tests）

tests/ 目录用于存放测试文件，采用 Markdown 编写。

设计原则如下：

一一对应：每个 Markdown 文件仅代表一个 Apifox 测试场景或测试套件。
内容复用：可直接沿用 Apifox 自动化测试中已有的目录结构、场景/套件名称及描述信息，避免重复定义。

每个 Markdown 文件只需包含两部分内容：一段简短的测试说明，以及一条可直接执行的 Apifox CLI 命令。

Apifox CLI 命令里的 Access Token 和 -e 参数后面的环境 ID，分别用 $APIFOX_ACCESS_TOKEN 和 $APIFOX_ENV_ID 代替，并统一在 .env 文件中配置，这样既可以避免 token 泄露，也能灵活切换运行环境。一个登录鉴权-认证流程.md文件的内容示例：

> 验证登录、刷新 token、登出等核心接口是否可用。

```bash

apifox run --access-token $APIFOX_ACCESS_TOKEN -t 5564xxx -e $APIFOX_ENV_ID -n 1 -r html,cli

以上步骤完成后，一个可用的 Skill 便构建好了。你可以参考最终生成的目录结构，检查是否与你的配置一致：