Claude CodeでTestコードを安全に生成・実行する方法

【結論】Test生成と実行を監査可能にする

対象の仕様とTest runnerを確認し、Unit、Integration、E2Eを混同せずに実行します。

# ターミナルでTest scriptを確認
npm pkg get scripts.test
# ターミナルで一回だけTestを実行
CI=1 npm test -- --runInBand

具体的な手順・設定方法

1. 既存のTest conventionとFixtureを調査します。
2. 正常系、境界値、異常系、権限のCaseを列挙します。
3. 外部依存はUnit testではMockし、Integration testでは隔離環境を使います。
4. 失敗原因がTestか実装かを判定してから修正します。

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

次の指示は、そのままClaude Codeの対話画面へ貼り付けて使えます。

> @src/services/userService.tsの既存仕様を根拠にテストを追加してください。
> 実通信と本番DB接続は禁止し、既存のMock規約に従ってください。
> Testを一度だけ実行し、失敗した場合は原因を分類して報告してください。

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

Testを通すためにAssertionを弱めたりSkipを追加しないでください。

Watch modeや無期限RetryはAgentが待機し続ける原因になるため、Timeoutと回数上限を設定してください。

実行前には必ずgit statusで変更状態を確認し、作業後は差分、テスト結果、残る課題を人間がレビューしてください。