作者注:把 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 文檔中心