【結論】再現性の高い指示を作る
Claude Codeを使うコツは、目的、観測事実、対象、制約、完了条件、検証方法を一つのTaskにまとめることです。
対象Fileを限定するだけでなく、必要なら追加Contextを読む前に理由を報告させると、見落としと無駄な探索を減らせます。
複雑な作業はPlan、実装、Test、Reviewへ分け、各段階の出力を人間が確認します。
# ターミナルで実行：作業前の状態を確認
git status --short
# ターミナルで実行：Planモードで開始
claude --permission-mode plan
# 起動後のセッション内で実行：権限を確認
/permissions
# ターミナルで実行：変更後の差分を検査
git diff --check具体的な手順・設定方法
Error messageと再現Commandを最初に提示します。
変更対象と変更禁止範囲を明示します。
受入条件をTest可能な文にします。
一つのTaskが終わるまで話題を混ぜず、終わったら圧縮または新Sessionへ移ります。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
目的：ログイン失敗時の500を401へ修正する。
観測事実：npm test -- authで一件失敗する。
制約：DB Schema、依存関係、公開APIは変更しない。
完了条件：既存Testと追加Regression testが通る。
まず原因と変更計画だけを提示してください。注意点・よくあるエラーと対処法
Chain of Thoughtを要求するのではなく、結論、根拠、計画、検証結果を求めます。
「全部直して」「最新化して」のような境界のない指示は手戻りを増やします。
大量RenameやMigrationはDry Run、件数確認、Backup、段階Commitを入れます。