Claude Codeにエラー修正を頼むときの進め方

Claude Codeはエラーメッセージから原因候補を調べ、関連ファイルを変更し、利用可能なテストを実行できます。公式の一般的な流れはCommon workflowsにあります。自動修正は成功を保証しないため、再現、差分、テストを分けて確認します。

依頼に含める情報

直ったかどうかは、最初と同じ条件で確かめます。

1. 1再現を残す実行コマンド、期待結果、エラー全文を控える。
2. 2原因を絞って修正根拠を読み、一度に一つの原因候補を扱う。
3. 3同じ手順で再試行差分とテスト結果を確認。残る症状は次の調査へ。

再現できないときは「解決済み」にせず、試した条件と残る疑問を記録します。

エラー全文、再現コマンド、期待結果、実際の結果、直前の変更、変更してよい範囲をまとめます。

次のエラーを調査してください。まず関連ファイルと原因候補を示し、まだ編集しないでください。
再現コマンド: npm test -- auth
期待結果: 認証テストが成功する
実際の結果: ...

計画を確認したら、対象ファイルを限定して修正を依頼します。Plan Modeを使う場合はPlanの手順、権限の確認はPermission modesを参照します。

修正後の検証

git diffで変更理由と範囲を読み、同じ再現コマンドを実行します。テストが通っても、未カバーの入力、ログへの秘密情報、性能や互換性の影響を確認します。テストが実行できなかった場合は成功と書かず、未検証の理由を記録します。/diffとチェックポイントを使い、必要なら小さく戻せる状態を保ちます。

原因が複数ある場合は、一度に一つだけ修正します。再現しないまま「たぶん直った」とせず、失敗を再現できる最小ケース、修正前後のログ、関連テストを残します。エラーメッセージを外部サービスへ送るときはパス、メールアドレス、トークンを匿名化します。Claudeが提案した回避策が依存関係を更新する場合は、互換性とロックファイルの差分もレビューします。

修正できなかった場合も、試した仮説と残るエラーを記録すると次の調査に役立ちます。