Claude Codeがエラーを出したときの対処法

Claude Codeは万能ではありません。間違ったコードを生成したり、意図と違う修正をしたり、途中でエラーになることがあります。この記事では、実際に遭遇する典型的なエラーパターンと対処法を解説します。

よくあるエラーパターンと対処法

1. 生成されたコードがビルドエラーになる

原因: Claude Codeがプロジェクトの依存関係やバージョンを正しく把握していない

対処法:

claude "ビルドエラーが出ています。エラーログを読んで修正してください"

エラーメッセージをそのままClaude Codeに渡すのが最も効率的です。「直して」だけではなく、エラーログをコピペしてください。

2. 意図と違うファイルを編集してしまう

原因: コンテキストが曖昧で、Claude Codeが対象ファイルを取り違えた

対処法:

• /undo で直前の変更を取り消す
• 次回は claude "src/components/Header.tsx のロゴサイズを変更して" のようにファイルパスを明示する
• CLAUDE.mdに「変更対象外のファイル」を記載しておく

3. コンテキストウィンドウ超過（会話が長すぎる）

症状: レスポンスが不完全になる、以前の指示を忘れる

対処法:

/clear

会話履歴をリセットし、必要な指示だけを再度伝えます。CLAUDE.mdに記載した情報は自動的に再読み込みされます。

4. 「そのファイルは見つかりません」と言われる

原因: Claude Codeを起動したディレクトリが間違っている

対処法:

• pwd でカレントディレクトリを確認
• プロジェクトのルートディレクトリで claude を起動し直す

5. APIキーのエラー

症状: Authentication error や Invalid API key

対処法:

• claude /config でAPIキーを再設定
• 環境変数 ANTHROPIC_API_KEY を確認
• APIキーの有効期限・利用制限を Anthropic Console で確認

エラー対処の3原則

1. エラーメッセージをそのまま渡す — 自分で解釈しない。AI にログを読ませる
2. 小さく切り分ける — 1つのプロンプトで1つの問題を解決する
3. /undo を恐れない — 間違った修正は即座に取り消す

やってはいけないこと

• エラーを無視して次の指示を出す → 問題が積み重なって手戻りが大きくなる
• 「全部直して」と曖昧に指示する → Claude Codeが関係ない部分まで変更する可能性がある
• 手動でファイルを編集した後、その変更をClaude Codeに伝えない → コンテキストと実ファイルに差分が生じる