Claude Codeの安全で再現可能な開発フロー

【結論】解決策 / 実行コマンド

Claude Codeの標準フローは、調査、計画、承認、最小実装、テスト、差分レビュー、コミットです。

最初から自律実行を最大化するより、各チェックポイントを明示した方が手戻りを減らせます。

# ターミナルで実行：作業ブランチを作成
 git switch -c fix/session-timeout
# ターミナルで実行：現在状態を確認
 git status --short
# ターミナルで実行：計画モードで開始
claude --permission-mode plan

具体的な手順・設定方法

1. 目的、対象範囲、完了条件、禁止事項を伝えます。

2. 計画を確認してから編集を許可します。

3. 関連テスト、型チェック、Lint、Git差分を確認してコミットします。

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

# 起動後のセッション内で入力
セッションタイムアウトの不具合を調査してください。
対象はsrc/sessionとtests/sessionだけです。
最初に原因仮説、確認方法、変更計画を提示してください。
承認後に最小差分で修正し、関連テストを実行してください。

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

AIの完了報告だけで作業を完了扱いにしないでください。

停止条件のない自己修復ループは避けてください。

機能追加、依存更新、設定変更を一つのコミットへ混在させないでください。