Claude自動跑接口測試：這套自然語言工作流火了

01、流程構建

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

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

在該工作流中，Claude Code 負責解析自然語言指令。當指令匹配到預設的 Claude Skills 時，系統(tǒng)將自動執(zhí)行對應的 Apifox CLI 命令，并對執(zhí)行結果進行解讀與分析。

02、應用場景

這套流程的5個場景：

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

即使失敗，它也會總結失敗原因。

場景2：查看所有可用測試

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

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

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

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

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

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

03、安裝應用

環(huán)境要求：

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

node-v

npm -v

安裝 Apifox CLI

通過 npm 安裝：

npm install -gapifox-cli

apifox--version

看到版本號則說明安裝成功。

可以到 Apifox 的「自動化測試 -> CI/CD」中，復制一個“測試場景”或者“測試套件”的 CLI 命令到終端執(zhí)行，記得添加 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 便會自動匹配并執(zhí)行合適的 Skill 來完成。

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

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

.claude/skills/

mkdir-p .claude/skills/apifox-tests

執(zhí)行完成后，目錄結構如下：

.claude/skills/apifox-tests/

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

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

每個 Skill 都需要一個 SKILL.md 文件，用來說明當這個 Skill 被匹配到時，Claude 應該如何一步步完成任務。

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

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

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

步驟 3：補充 Skill 所需的支持文件

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

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

最終，這個 Skill 的目錄結構如下：

.claude/skills/apifox-tests/

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

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

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

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

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

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

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

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

└── tests/ # 測試定義（每個文件對應一個測試場景或測試套件）

├── 支付流程.md

└── 退款流程.md

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

環(huán)境配置：

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

將環(huán)境 ID 抽離為變量，可以讓我們在不改任何命令或腳本的情況下，快速切換測試運行環(huán)境 （如開發(fā) / 測試 / 生產）。

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

APIFOX_ACCESS_TOKEN=APS-你的訪問令牌

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

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

• test.env
• prod.env

每個文件只需要維護對應環(huán)境的變量即可。

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

執(zhí)行腳本（scripts）

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

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

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

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

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

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

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

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

測試定義（tests）

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

設計原則如下：

• 一一對應：每個 Markdown 文件僅代表一個 Apifox 測試場景或測試套件。
• 內容復用：可直接沿用 Apifox 自動化測試中已有的目錄結構、場景/套件名稱及描述信息，避免重復定義。

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

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

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

```bash

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

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

在 Claude Code 中使用案例：

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

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

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

Claude 能夠理解您的測試意圖，精準定位并執(zhí)行對應的測試文件。在測試執(zhí)行過程中，Apifox CLI 的運行日志將實時呈現(xiàn)；測試完成后，Claude 會自動分析結果并輸出詳盡的總結報告。

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

??轉崗軟件測試/野路子技能提升

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

??可以到我的個人號：atstudy-js

即可加入領取 ??????

轉行、入門、提升、需要的各種干貨資料

內含AI測試、 車載測試、AI大模型開發(fā)、BI數據分析、銀行測試、游戲測試、AIGC

04、總結

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

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