結論
最初にやること：OSのターミナルでclaude -p "変更されたTypeScriptファイルだけを調査し、を実行します。
Claude Codeで効果が出やすいのは、入力と完了条件が明確で、Git差分やテスト結果で成否を確認できる作業です。
代表例は依存関係更新、失敗テストの修正、変更履歴生成、ログの一次切り分け、仕様書とコードの同期です。
まず一件を非対話モードで試し、実行時間、差分量、再試行回数、費用を記録してから横展開します。
実行場所：OSのターミナルで実行します。
# ターミナルで実行：非対話モードで単発処理を実行
claude -p "変更されたTypeScriptファイルだけを調査し、
# Claude Codeの対話画面へ入力：作業条件または依頼内容を指定
不足している単体テストを追加して対象テストを実行して" --allowedTools "Read,Edit,Bash" --max-turns 10 --max-budget-usd 2.00 --output-format json > automation-result.json具体的な手順
文章生成だけでは成果判定が曖昧になるため、Lint、型検査、テスト、生成物の件数など機械判定できる条件を付けます。
毎回同じ作業ならClaude Codeに考えさせ続けず、最終的に通常のスクリプトやHookへ固定化します。
- 入力ファイルと対象ディレクトリを限定
- 成功条件をコマンドまたはJSON Schemaで定義
- 書き込み先を専用ブランチやworktreeへ隔離
- 失敗時は終了コードとログを保存
- 差分レビュー後にのみマージ
記述先：指定された設定ファイルへ保存します。
# 事例の評価項目
task: dependency-update
scope: package.json, lockfile
verify:
- npm audit --omit=dev
- npm test
limits:
maxFilesChanged: 20
maxBudgetUsd: 2.00実践プロンプト
実運用では対象、制約、完了条件、検証方法を一つの指示にまとめ、結果を機械的に確認できる形へします。
実行場所：OSのターミナルで実行します。
package.jsonのマイナー更新候補だけを調査してください。
更新前に影響範囲を説明し、互換性が確認できたものだけを別ブランチで更新してください。
npm testとnpm run buildを実行し、失敗した場合は原因と未解決項目をJSONで返してください。
メジャー更新と公開処理は行わないでください。注意点
「全プロジェクトを改善」のような無制限タスクは、意図しない設計変更と費用増加を招くため避けてください。
成功率を判断するときはデモ一回ではなく、同じ入力集合で人手作業との時間、欠陥数、費用を比較してください。
生成したテストが実装に合わせて誤った期待値へ変更されていないか、人間が失敗理由とアサーションを確認してください。