Claude自動(dòng)跑接口測(cè)試：這套自然語言工作流火了

01、流程構(gòu)建

這套流程都由哪些工具組成呢？總共3個(gè)，分別是：

• Apifox CLI：Apifox 提供的命令行工具，可在終端中直接調(diào)用 CLI 命令并生成測(cè)試報(bào)告。
• Claude Code：Anthropic 推出的命令行 AI 助手，支持在終端中操作文件、執(zhí)行命令及運(yùn)行腳本。
• Claude Skills：作為 Claude Code 的擴(kuò)展能力，用于定義 Claude 執(zhí)行特定任務(wù)的操作步驟，相當(dāng)于一份結(jié)構(gòu)化的執(zhí)行說明。

在該工作流中，Claude Code 負(fù)責(zé)解析自然語言指令。當(dāng)指令匹配到預(yù)設(shè)的 Claude Skills 時(shí)，系統(tǒng)將自動(dòng)執(zhí)行對(duì)應(yīng)的 Apifox CLI 命令，并對(duì)執(zhí)行結(jié)果進(jìn)行解讀與分析。

02、應(yīng)用場景

這套流程的5個(gè)場景：

場景1：執(zhí)行單個(gè)測(cè)試；
以登錄功能為例：只需在 Claude Code 中輸入“幫我跑一下登錄功能的測(cè)試，用開發(fā)環(huán)境”，Claude 便會(huì)立即執(zhí)行測(cè)試，并在運(yùn)行結(jié)束后自動(dòng)分析結(jié)果，給出清晰的總結(jié)反饋。

即使失敗，它也會(huì)總結(jié)失敗原因。

場景2：查看所有可用測(cè)試

同樣，如果你想了解當(dāng)前支持哪些測(cè)試，可以問 Claude：“有哪些測(cè)試可以執(zhí)行？” 它會(huì)自動(dòng)執(zhí)行腳本，將所有可用的測(cè)試場景或測(cè)試套件展示出來。

場景3：執(zhí)行某個(gè)業(yè)務(wù)模塊的所有測(cè)試

當(dāng)你需要一次性完成支付相關(guān)所有測(cè)試時(shí)，可輸入：“用測(cè)試環(huán)境跑一下支付相關(guān)的所有測(cè)試”。Claude 將智能識(shí)別對(duì)應(yīng)的測(cè)試文件，并以串行或并行方式快速執(zhí)行。

場景4：對(duì)比不同環(huán)境的測(cè)試結(jié)果
以登錄功能為例：只需輸入“用開發(fā)環(huán)境和測(cè)試環(huán)境跑一下登錄功能的測(cè)試”，Claude 便會(huì)分別在兩個(gè)環(huán)境中執(zhí)行測(cè)試，并自動(dòng)分析結(jié)果的異同，幫助你快速定位環(huán)境差異帶來的影響。

場景5：根據(jù)代碼變更執(zhí)行測(cè)試
當(dāng)你完成代碼更新后，可讓 Claude 精準(zhǔn)執(zhí)行受影響的測(cè)試，無需跑全量用例。例如輸入：“根據(jù)最近的代碼變更，在開發(fā)環(huán)境跑一下受影響的接口測(cè)試”。Claude 會(huì)自動(dòng)解析 Git 變更記錄，定位受影響的功能范圍，并執(zhí)行對(duì)應(yīng)的測(cè)試場景，有效節(jié)約時(shí)間和資源。

上述我們了解了該套流程的應(yīng)用場景，那該流程如何安裝使用呢？我們接下來繼續(xù)學(xué)習(xí)~

03、安裝應(yīng)用

環(huán)境要求：

必裝Node 環(huán)境，可打開終端驗(yàn)證：

node-v

npm -v

安裝 Apifox CLI

通過 npm 安裝：

npm install -gapifox-cli

apifox--version

看到版本號(hào)則說明安裝成功。

可以到 Apifox 的「自動(dòng)化測(cè)試 -> CI/CD」中，復(fù)制一個(gè)“測(cè)試場景”或者“測(cè)試套件”的 CLI 命令到終端執(zhí)行，記得添加 Access Token。

當(dāng)看到測(cè)試輸出時(shí)就說明 Apifox CLI 能正常工作了。

特別提示： 需要將 Apifox 客戶端和 Apifox CLI 更新到最新版，才能使用最新的“測(cè)試套件”功能。

安裝 Claude Code

通過 npm 安裝：

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

claude --version

首次運(yùn)行需要登錄：

claude

照提示完成授權(quán)，需要 Claude 賬號(hào) （可以通過某魚或一些中轉(zhuǎn)站解決賬號(hào)問題）。

Claude Skills 的構(gòu)建

理解 Skills 的工作原理

使用 Claude Code 時(shí)，你無需手動(dòng)指定要調(diào)用的 Skill，只需用一句話描述你的需求，Claude 便會(huì)自動(dòng)匹配并執(zhí)行合適的 Skill 來完成。

只要你輸入的自然語言與某個(gè) Skill 的描述相匹配，Claude 就會(huì)加載該 Skill，并按照其中定義的流程執(zhí)行任務(wù)。

步驟 1：創(chuàng)建 Skill 目錄
Skill 的目錄結(jié)構(gòu)遵循以下規(guī)范：所有配置文件統(tǒng)一存放于路徑下，每個(gè) Skill 擁有自己獨(dú)立的子目錄。下面，我們將在項(xiàng)目根目錄中，為 Apifox 自動(dòng)化測(cè)試搭建一個(gè)最小可用的 Skill 目錄：

.claude/skills/

mkdir-p .claude/skills/apifox-tests

執(zhí)行完成后，目錄結(jié)構(gòu)如下：

.claude/skills/apifox-tests/

后續(xù)我們會(huì)在這個(gè)目錄中，逐步添加 Skill 的入口文件和執(zhí)行腳本等內(nèi)容。

步驟 2：創(chuàng)建 SKILL.md

每個(gè) Skill 都需要一個(gè) SKILL.md 文件，用來說明當(dāng)這個(gè) Skill 被匹配到時(shí)，Claude 應(yīng)該如何一步步完成任務(wù)。

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

description 尤其重要，它用于幫助 Claude 判斷在什么場景下應(yīng)該啟用這個(gè) Skill，所以這里要根據(jù)你的業(yè)務(wù)寫觸發(fā)條件。

在 YAML 之后的 Markdown 內(nèi)容中，則用于描述這個(gè) Skill 被啟用后，Claude 具體應(yīng)該怎么做，包括判斷邏輯、執(zhí)行步驟、引用的腳本、以及需要遵循的約束規(guī)則。

步驟 3：補(bǔ)充 Skill 所需的支持文件

前面我們已經(jīng)創(chuàng)建了 SKILL.md，用于定義觸發(fā)條件和整體執(zhí)行流程。

接下來其余文件都只是對(duì) SKILL.md 的補(bǔ)充，當(dāng)流程中需要其它信息，比如運(yùn)行環(huán)境、執(zhí)行命令或測(cè)試定義時(shí)，再按需引入對(duì)應(yīng)的文件即可。

最終，這個(gè) Skill 的目錄結(jié)構(gòu)如下：

.claude/skills/apifox-tests/

├── SKILL.md # Skill 入口，定義觸發(fā)條件和整體流程

├──env/ # 運(yùn)行環(huán)境配置（如 dev / test / prod），用于區(qū)分不同測(cè)試環(huán)境

│ ├── dev.env # 開發(fā)環(huán)境

│ ├── test.env # 測(cè)試環(huán)境

│ └── prod.env # 生產(chǎn)環(huán)境

├── scripts/ # 執(zhí)行腳本（被 SKILL.md 調(diào)用）

│ ├── list-tests.js # 列出 tests 目錄下的所有測(cè)試

│ └── run-cli.js # 負(fù)責(zé)組裝并執(zhí)行 Apifox CLI 命令

└── tests/ # 測(cè)試定義（每個(gè)文件對(duì)應(yīng)一個(gè)測(cè)試場景或測(cè)試套件）

├── 支付流程.md

└── 退款流程.md

如上所說，支持條件包括：環(huán)境配置執(zhí)行腳本以及測(cè)試定義等，接下來我們針對(duì)這3個(gè)的作用和說明再詳細(xì)說明：

環(huán)境配置：

env/ 目錄用于存放不同運(yùn)行環(huán)境對(duì)應(yīng)的變量配置，例如 Apifox 的訪問令牌 （Access Token） 和環(huán)境 ID。

將環(huán)境 ID 抽離為變量，可以讓我們?cè)诓桓娜魏蚊罨蚰_本的情況下，快速切換測(cè)試運(yùn)行環(huán)境 （如開發(fā) / 測(cè)試 / 生產(chǎn)）。

例如，在 env/ 目錄下創(chuàng)建 dev.env 文件：

APIFOX_ACCESS_TOKEN=APS-你的訪問令牌

APIFOX_ENV_ID=你的環(huán)境ID

如果需要支持多個(gè)環(huán)境，可以按照同樣的方式創(chuàng)建：

• test.env
• prod.env

每個(gè)文件只需要維護(hù)對(duì)應(yīng)環(huán)境的變量即可。

特別說明：env/ 目錄的 .env 文件包含訪問令牌，是敏感信息，不能提交到 Git。

執(zhí)行腳本（scripts）

scripts/ 目錄用于存放可直接執(zhí)行的腳本，負(fù)責(zé)把「測(cè)試定義」轉(zhuǎn)換為實(shí)際可運(yùn)行的 Apifox CLI 命令，并完成環(huán)境變量注入與執(zhí)行。

本文采用 Node.js 編寫 Skill，主要基于兩大考量：

• 環(huán)境一致性：Apifox CLI 基于 Node.js，復(fù)用同一環(huán)境可避免引入 Python 等其他運(yùn)行時(shí)，降低配置復(fù)雜度。
• 成本優(yōu)化：將核心邏輯（命令解析、變量注入、執(zhí)行）封裝于腳本，避免 Claude 在對(duì)話中重復(fù)組裝 CLI 命令，從而減輕上下文負(fù)擔(dān)、節(jié)約 tokens。

如果你對(duì)腳本不熟悉，也可以選擇不使用，而是在 SKILL.md 中直接讓 Claude 組裝并執(zhí)行 CLI 命令，只是上下文成本會(huì)更高一些。

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

• 命令提取：從 Markdown 測(cè)試文件中獲取 Apifox CLI 命令；
• 環(huán)境加載：根據(jù)用戶指定的環(huán)境（如 dev / test）讀取對(duì)應(yīng)的 .env 文件；
• 測(cè)試執(zhí)行：注入環(huán)境變量并運(yùn)行測(cè)試。

同樣在 scripts/ 下創(chuàng)建 list-tests.js，用于：

• 遞歸掃描 tests/ 目錄
• 查找所有 Markdown 測(cè)試文件
• 提取首行描述信息
• 輸出當(dāng)前所有可用的 Apifox 自動(dòng)化測(cè)試列表

測(cè)試定義（tests）

tests/ 目錄用于存放測(cè)試文件，采用 Markdown 編寫。

設(shè)計(jì)原則如下：

• 一一對(duì)應(yīng)：每個(gè) Markdown 文件僅代表一個(gè) Apifox 測(cè)試場景或測(cè)試套件。
• 內(nèi)容復(fù)用：可直接沿用 Apifox 自動(dòng)化測(cè)試中已有的目錄結(jié)構(gòu)、場景/套件名稱及描述信息，避免重復(fù)定義。

每個(gè) Markdown 文件只需包含兩部分內(nèi)容：一段簡短的測(cè)試說明，以及一條可直接執(zhí)行的 Apifox CLI 命令。

Apifox CLI 命令里的 Access Token 和 -e 參數(shù)后面的環(huán)境 ID，分別用 $APIFOX_ACCESS_TOKEN 和 $APIFOX_ENV_ID 代替，并統(tǒng)一在 .env 文件中配置，這樣既可以避免 token 泄露，也能靈活切換運(yùn)行環(huán)境。一個(gè)登錄鑒權(quán)-認(rèn)證流程.md文件的內(nèi)容示例：

> 驗(yàn)證登錄、刷新 token、登出等核心接口是否可用。

```bash

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

以上步驟完成后，一個(gè)可用的 Skill 便構(gòu)建好了。你可以參考最終生成的目錄結(jié)構(gòu)，檢查是否與你的配置一致：

在 Claude Code 中使用案例：

配置完成后，在終端控制臺(tái)運(yùn)行 claude 命令進(jìn)入項(xiàng)目目錄。Claude 會(huì)自動(dòng)掃描 .claude/skills/ 目錄，發(fā)現(xiàn) apifox-tests Skill。

你也可以先用 /skills 命令查看已加載的 Skill。

接下來，您可以嘗試用一句自然語言發(fā)出指令，例如：“幫我跑一下退款流程的測(cè)試，使用測(cè)試環(huán)境。”

Claude 能夠理解您的測(cè)試意圖，精準(zhǔn)定位并執(zhí)行對(duì)應(yīng)的測(cè)試文件。在測(cè)試執(zhí)行過程中，Apifox CLI 的運(yùn)行日志將實(shí)時(shí)呈現(xiàn)；測(cè)試完成后，Claude 會(huì)自動(dòng)分析結(jié)果并輸出詳盡的總結(jié)報(bào)告。

整個(gè)流程可以概括為：您用自然語言描述需求，Claude 理解您的意圖后調(diào)用腳本，腳本隨即執(zhí)行 Apifox CLI 命令，最后 Claude 分析測(cè)試結(jié)果并反饋給您。

??轉(zhuǎn)崗軟件測(cè)試/野路子技能提升

??想了解更多漲薪技能提升方法

??可以到我的個(gè)人號(hào)：atstudy-js

即可加入領(lǐng)取 ??????

轉(zhuǎn)行、入門、提升、需要的各種干貨資料

內(nèi)含AI測(cè)試、 車載測(cè)試、AI大模型開發(fā)、BI數(shù)據(jù)分析、銀行測(cè)試、游戲測(cè)試、AIGC

04、總結(jié)

讓測(cè)試回歸意圖，讓工具理解需求——這是本文想要傳遞的核心思路。Claude 不再是簡單的命令執(zhí)行者，而是理解你、協(xié)助你的智能伙伴。

如果你也希望告別繁瑣的指令拼裝，讓接口測(cè)試變得更智能、更高效，不妨從這套方案開始嘗試。