用 Claude Code 和 Playwright 做 QA 測試

QA 測試：Claude Code 能做什麼

• 為重要的流程寫端對端測試：註冊、結帳、主要畫面。
• 執行測試套件、讀懂失敗原因，然後修正測試或程式碼，並說明修的是哪一個。
• 操作真正的瀏覽器親手檢查變更，回報 bug 時附上重現步驟和截圖。
• 找出不穩定的測試，隔離起來並開 issue，而不是一直重試到通過為止。

QA 測試：用得上的 Claude Code 功能

QA 測試：如何設定 Claude Code

1. 連接工具

   加入 Playwright MCP 伺服器，讓 Claude Code 能在瀏覽器裡開啟你的 App。儲存庫裡的測試套件，照平常的方式安裝 Playwright；Claude 會像執行其他指令一樣執行它。

   # 用來做探索性檢查的真正瀏覽器
   claude mcp add playwright npx @playwright/mcp@latest
   
   # 測試套件，如果你還沒有的話
   npm init playwright@latest

2. 把規則寫進 CLAUDE.md

   Claude Code 在每個工作階段開始時都會讀取 CLAUDE.md，claude -p 的執行也一樣。把這項工作的規則寫在那裡；規則很長的話，放進 .claude/skills/ 下的 skill。參見 CLAUDE.md 指南。

   ## QA 規則
   - 在本機或 staging 環境測試，絕不在正式環境測試。
   - 使用 .env.example 裡的測試帳號，絕不使用真實帳號。
   - 測試失敗就是一項發現：改動測試或程式碼之前，
     先說清楚是測試錯了還是程式碼錯了。
   - 每份 bug 回報：重現步驟、預期結果、實際結果、截圖，
     以及你測試的那個 commit。
   - 不要為了讓測試套件通過而刪除或略過測試。

3. 不開互動介面也能執行

   claude -p 執行一個任務後就結束，所以 cron、CI 或其他工具都能啟動它。用 --allowedTools 或 --permission-mode 決定哪些事不必詢問就能做；--output-format json 會連同成本一起回傳結果。

   # 從 CI 或 cron 執行測試套件並修正失敗
   claude -p "執行 npx playwright test，並依 CLAUDE.md 修正失敗的測試" \
     --allowedTools "Bash,Read,Edit"

4. 排入排程

   用 /schedule 設成雲端排程任務（Pro、Max、Ultra、Team 和 Enterprise 方案）、設成桌面排程任務，或在工作階段開著時用 /loop。參見如何讓 Claude Code 主動工作。

來源：Claude Code 文件

限制與安全

• 它只能測試它連得到的東西：用測試資料的本機或 staging 環境，不是正式環境。
• 測試套件通過，只代表有人寫了測試的流程沒問題。請它列出還沒涵蓋的部分。
• 瀏覽器測試很慢，也更耗你方案的用量。完整測試套件依排程跑，每次變更只跑冒煙測試。
• 自 Claude Code v2.1.302 起，claude -p 以 Manual 模式啟動：需要核准的動作，除非有規則允許，否則一律拒絕。只允許這項工作需要的工具。

QA 測試，用 Claude Code 還是 Codex？

規則可以共用。在 AGENTS.md 寫一次，再把 @AGENTS.md 放進 CLAUDE.md，兩個 agent 就會讀同一份檔案。

另一個 agent 的逐步做法：Codex QA 測試。

QA 測試：讓它成為某個人的固定工作

指令只在有人記得時才會執行。Crewmark 把你自己的 Claude Code 變成 AI 員工，有職位、量化目標、工作時間和心跳，工作就會依排程完成，並出現在看板上。

1. 從職位開始

   AI 軟體工程師：在職位說明裡寫上這些規則。

2. 把工作放上它的看板

   把這項工作加成週期性 issue。員工依心跳醒來，做完後以評論回報。

3. 相關內容

   GitHub issue 說明它回報的 bug 之後會怎麼處理。

常見問題