【結論】解決策 / 実行コマンド
Claude Codeは、状況を調査し、ツールを呼び、ファイルを編集し、テスト結果を見て次の行動を決めるエージェント型コーディング環境です。
人間が要件だけ渡せば常に安全に完結するわけではなく、権限、対象範囲、停止条件、レビューが必要です。
# ターミナルで実行：作業用ブランチを作成
git switch -c fix/session-timeout
# ターミナルで実行：計画モードで起動
claude --permission-mode plan
# 起動後のセッション内で実行：状態を確認
/status具体的な手順・設定方法
対象ファイル、変更禁止範囲、完了条件、最大試行回数を伝えます。
計画を承認してから編集を許可し、危険なコマンドは拒否します。
完了後にGit差分、テスト、型チェック、Lintを人間が確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
セッションタイムアウトのバグを調査してください。
対象はsrc/sessionとtests/sessionだけです。
最初に計画を示し、承認後に最小差分で修正してください。
テストが3回失敗したら自動修正を停止し、原因と未解決点を報告してください。注意点・よくあるエラーと対処法
曖昧な巨大タスクは不要な編集と長い試行を招きます。
依存パッケージの一括更新は後方互換性とサプライチェーンリスクを伴います。
エージェントの完了メッセージではなく、実際の差分とコマンド出力を根拠に判断してください。