Claude Codeエージェントの安全な使い方

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

Claude Codeは計画、ファイル読取り、編集、コマンド実行、検証を繰り返すエージェント型ツールです。

人間が要件だけを渡して完全放置するのではなく、対象範囲、完了条件、停止条件、権限、テストを明示して監督します。

大きな調査はサブエージェント、並列作業はAgent Teams、継続条件は/goalなど用途に応じて分けます。

# ターミナルで実行：作業ブランチを作成
 git switch -c fix/auth-timeout
# ターミナルで実行：計画モードで開始
claude --permission-mode plan
# 起動後のセッション内で実行：診断
/doctor

具体的な手順・設定方法

1. 最初に現象、再現手順、対象ディレクトリ、変更禁止範囲を伝えます。

2. 計画を確認してから編集を許可し、各コマンドの対象と副作用を確認します。

3. 完了後にGit差分、テスト、型チェック、Lintを人間が確認します。

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

# 起動後のセッション内で入力
ログインタイムアウトを修正してください。
対象はsrc/authとtests/authだけです。
最初に原因候補と計画を提示し、承認後に最小差分で修正してください。
テストが3回失敗したら停止し、原因と未解決点を報告してください。

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

「成功するまで無限に修正」のような停止条件のない指示は避けてください。

依存関係の一括更新は破壊的変更を含むため、更新候補の一覧と影響確認を先に行います。

完了報告だけでなく、実行ログと実ファイルの差分を確認してください。