結論
最初にやること：OSのターミナルでclaude -p "対象: src/api/user.tsを実行します。
日本語の自然さよりも、Claude Codeが実行結果を判定できる構造を作ることが重要です。
対象ファイル、変更理由、触れてはいけない範囲、最後に通すテストを一つの指示へまとめます。
実行場所：OSのターミナルで実行します。
# ターミナルで実行：非対話モードで単発処理を実行
claude -p "対象: src/api/user.ts
# Claude Codeの対話画面へ入力：作業条件または依頼内容を指定
目的: id未指定時に400を返す
# Claude Codeの対話画面へ入力：作業条件または依頼内容を指定
制約: 公開型とDBスキーマは変更しない
# Claude Codeの対話画面へ入力：作業条件または依頼内容を指定
検証: npm test -- user-api を実行する"具体的な手順
大きな変更では探索と実装を分離します。
- 最初に関連ファイルだけを調査
- 変更計画を提示
- 人間が計画を承認
- 編集後にテストと差分を確認
対話モードではPlanモードを使うと、実装前に方針をレビューできます。
実行場所：OSのターミナルで実行します。
# ターミナルで実行：Claude Codeを指定条件で起動
claude --permission-mode plan
# Claude Codeの対話画面へ入力：作業条件または依頼内容を指定
src/auth配下だけを調査してください
# Claude Codeの対話画面へ入力：作業条件または依頼内容を指定
原因候補と変更計画を示し
# Claude Codeの対話画面へ入力：作業条件または依頼内容を指定
承認するまで編集しないでください実践プロンプト
曖昧語を受入条件へ置き換えた実践例です。
入力場所：Claude Codeの対話画面へ貼り付けます。
ログイン画面を使いやすくしてください
条件:
- Enterで送信できる
- 送信中はボタンを無効化する
- 失敗時は日本語メッセージを表示する
- 既存のAPI仕様は変更しない
- 関連テストを追加する注意点
一発で全部直してやよしなには探索範囲と完了条件が不明で、不要な変更を増やします。
実行権限を与える指示と、Claude Codeのpermissionsは別物なので、危険なコマンドはプロンプトだけでなく設定側でも拒否します。