【結論】解決策 / 実行コマンド
Claude Codeは全体を一度に丸投げするより、調査、計画、実装、テスト、レビューを分離すると安定します。
Planモード、worktree、Auto mode、Goal、permissionsを組み合わせると、自律性と安全性を段階的に調整できます。
完了条件、対象範囲、禁止操作、最大試行回数をプロンプトへ明記してください。
# ターミナルで実行:隔離worktreeで開始
claude --worktree feature-auth
# 起動後のセッション内で実行:計画モードへ切り替え
/plan
# 起動後のセッション内で実行:必要な場合だけAuto modeへ切り替え
/auto具体的な手順・設定方法
既存テストとGit状態を保存して基準点を作ります。
変更予定ファイルとテスト計画を提示させ、承認後に編集します。
完了後は差分、テスト結果、未解決リスクを人間が確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
Goal: auth.test.tsの失敗2件を解消すること。
対象: src/auth.tsとtests/auth.test.tsだけ。
禁止: 依存追加、テスト削除、公開API変更。
停止条件: 修正とテストは最大3回。
最初に原因仮説と計画を提示してください。注意点・よくあるエラーと対処法
無制限の自己修復ループは、利用量増加と無関係な変更を招きます。
コミット、Push、デプロイは別承認に分けてください。
本番DBやクラウド設定を含む作業にはバックアップとロールバック手順が必要です。