Claude Codeの正しい操作方法と安全な依頼の型

【結論】目的・範囲・完了条件を揃える操作方法

Claude Codeを正しく操作するには、目的、対象、制約、完了条件、検証Commandを一つの依頼へ揃えます。

曖昧な丸投げより、AIが次に何をするか確認できる小さな反復が安定します。

# ターミナルで変更前の状態を確認
git status --short
# Claude Codeを起動
claude

具体的な手順・設定方法

1. 対象Fileを指定して現状理解だけを依頼します。

2. Planを確認し、変更禁止範囲を明示します。

3. 編集後にTest、Type check、Lint、Diffを順番に確認します。

# ターミナルでTestを実行
npm test
# ターミナルで差分を確認
git diff --check

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

Error logは必要部分だけを渡し、再現Commandを示します。

長いTaskはIssue単位へ分割し、SessionのContextが散らからないようにします。

目的はAPI ClientのRetry処理を修正することです。
対象は@src/api/client.tsと対応Testだけです。
公開Interfaceは変更せず、最大3回、指数Backoff、4xxはRetryしない条件を守ってください。
修正後に対象Testを実行し、結果を報告してください。

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

『他のFileを見ないで』と強く制限すると、必要な型定義や設定を見落とす場合があります。

必要な追加Contextがあれば、編集前にPathと理由を報告させます。

AIの成功報告だけを信頼せず、実際のExit codeとDiffを人間が確認してください。