Claude Codeでテストを生成・実行・検証する方法

【結論】テストは生成より先に仕様と実行Commandを確認する

Claude CodeはUnit、Integration、E2E Testを作成できますが、既存Framework、命名規則、Fixture、Coverage方針を先に読み取らせます。

生成後は実際にTestを実行し、Production codeをTestに合わせて不当に変更していないか確認します。

# ターミナルで実行：安全なBranchを作成
git switch -c test/add-auth-cases
# ターミナルで実行：Claude Codeを起動
claude
# 起動後のセッション内で実行：Plan modeへ切替
/plan

具体的な手順・設定方法

1. 対象Functionと既存Testを指定し、正常系、境界値、異常系、権限、Concurrencyを整理します。
2. Planを承認してTestだけを追加し、最初の実行結果を保存します。
3. 失敗が仕様BugかTest Bugかを根拠付きで分類し、必要ならProduction修正を別Commitに分けます。

実践プロンプト / 活用テクニック

実践Promptです。

# 起動後のセッション内で実行
@src/auth/token.ts と @tests/auth/token.test.ts を確認してください。
公開仕様から不足している境界値と異常系を列挙し、既存動作を変えずにTestを追加してください。
最後に対象Testだけを実行してください。

対象を限定すると不要な変更を防げます。

注意点・よくあるエラーと対処法

Coverage率だけを目標にすると意味の薄いTestが増えるため、Fault detectionと仕様Traceabilityを重視します。

Secret、実顧客Data、本番EndpointをFixtureに使わず、Dummy dataとMockを使用します。

Flaky testを単にRetryで隠さず、Time、Random、Network、Shared stateの原因を特定します。