結論
最初にやること:OSのターミナルでclaudeを実行します。
Claude Codeの価値は大量生成そのものではなく、リポジトリを調査し、変更し、テストし、差分を説明する一連の作業を同じセッションで進められる点です。
特にバグ再現、限定的なリファクタリング、テスト追加、依存関係更新、PRレビューで効果を出しやすいです。
最初から無制限に編集させず、計画と受け入れ条件を置いて段階的に権限を渡します。
実行場所:コメントに従い、ターミナルとClaude Codeの対話画面を使い分けます。
# ターミナルで実行:Claude Codeを起動
claude
# Claude Code起動後の対話画面で実行:Planモードで変更計画を作成
/plan 修正対象を調査して実装計画を作成
# Claude Code起動後の対話画面で実行:Claude Code内で変更差分を確認
/diff
# Claude Code起動後の対話画面で実行:対話コマンドを実行
/verify
具体的な手順
作業前に新しいGitブランチを作り、未コミット変更がない状態にします。
再現コマンド、対象範囲、変更禁止箇所、完了条件を一つのプロンプトへまとめます。
計画を承認した後に編集させ、
/diffと/verifyでコードと実動作を確認します。
長い作業は/contextでコンテキスト内訳を確認し、必要なときだけ/compactを実行します。
同じ失敗を繰り返したら停止し、ログ、仮説、次の一手を報告させて人間が方向を修正します。
実践プロンプト
再現から検証までを明確にしたプロンプトが実務向きです。
入力場所:Claude Codeの対話画面へ貼り付けます。
不具合を再現して最小修正を行う
再現: pnpm test auth --runInBand
対象: src/auth と tests/auth
禁止: DBスキーマ変更、依存追加
完了条件:
- 失敗テストが成功
- 既存テストを壊さない
- 変更理由を3行で報告
注意点
曖昧な「全部改善して」は変更範囲を広げるため、ディレクトリと完了条件を指定します。
承認を省略する設定は破壊的コマンドのリスクを上げるため、信頼できる隔離環境以外では使用しません。
生成結果は必ずGit差分とテストで確認し、機密情報やライセンス条件も人間がレビューします。