Claude Codeのおすすめ活用法：調査・計画・実装・検証を分ける

【結論】最も再現性が高いのは小さな検証ループ

Claude Codeの強みは大量変更を一度に行うことだけではありません。

効果が高い使い方は、まず読み取り専用で仕様と影響範囲を調査し、計画をレビューしてから限定的に実装し、テストと差分で検証する流れです。

「全ファイルをよしなに修正」ではなく、変更可能範囲、公開仕様、禁止事項、完了条件、最大試行回数を明示します。

git status --short
git switch -c chore/safe-refactor
claude

具体的な手順・設定方法

1. 最初の指示ではファイル変更を禁止し、関連コードとテストを調査させます。

2. 計画を人間が確認した後、対象ディレクトリだけ実装を許可します。

3. 完了後にテスト、git diff --check、git diff --statを実行し、結果をレビューします。

git diff --check
git diff --stat
npm test

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

修正と検証を一つの明確なプロンプトにまとめます。

src/services/paymentだけを対象に重複処理を整理してください。
公開API、エラー文言、依存パッケージは変更しないでください。
最初に調査結果と計画を提示し、承認後に実装してください。
実装後は対象テストを実行し、失敗時の修正は2回までにしてください。

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

• Gitの未コミット変更がある場合は、Agentの変更と混ざらないよう先に保存または退避します。

• テストがない箇所を大規模変更させる前に、現状を固定するcharacterization testを追加します。

• 長時間ループでは途中経過と停止条件を確認し、意図しない範囲へ広がったらEscまたはCtrl+Cで中断します。