Claude Code でエラーが出たときの読み方と、聞き直し方｜あわてないための5つの手順

Claude Code に作業を頼んでいると、画面に英語のエラーがずらっと出ることがあります。「何か壊してしまったのでは」と不安になりますが、エラーは「どこで、何がうまくいかなかったか」を教えてくれる手がかりです。

この記事では、エラーが出たときに、あわてずに読んで、Claude Code に聞き直すための5つの手順を紹介します。

1. まず、最後の数行を読む

エラーの文章は長いことが多いですが、大事なことは最後の数行に書かれていることがよくあります。「Error」「not found」「permission denied」などの言葉と、ファイルの名前や行の番号を探してみましょう。

・not found …… ファイルや命令が見つからない

・permission denied …… 書き込みや実行が許されていない

・syntax error …… 書き方の間違い

全部を理解できなくてもかまいません。「どのファイルの、どのあたりで止まったか」がわかれば十分です。

2. エラーは、そのまま Claude Code に見せる

自分で言いかえるより、エラーの文章をそのまま見せるほうが、原因を見つけやすくなります。Claude Code が自分で実行したコマンドのエラーなら、たいていは Claude Code にも見えています。自分で別の画面で実行したときは、エラーをコピーして貼りましょう。

ただし、パスワードや APIキー、お客様の名前などが写っているときは、その部分を消してから貼ります。

3. 「何をして、どうなって、どうしたかったか」を添える

エラーだけを貼るより、次の3つを一言ずつ添えると、話が早くなります。

・何をしたか（例：「売上表を月ごとにまとめるように頼んだ」）

・どうなったか（例：「途中でエラーが出て、ファイルができなかった」）

・本当はどうしたかったか（例：「月ごとの合計の表がほしい」）

最後に「原因と直し方を説明してから、直してください」と頼むと、何をするのかがわかってから進められます。

4. 同じ直し方がくり返されたら、いったん止める

何度直しても同じエラーが出るときは、そのまま続けず、いったん止めましょう。そのうえで、次のように頼み方を変えます。

・「今までに試したことと、その結果を一覧にして」と、状況を整理してもらう

・「まず、小さなデータで試して」と、範囲をせまくする

・会話を新しく始めて、「目的」と「今の状況」をあらためて伝える

会話が長くなると、前の話にひっぱられて、同じところを回ってしまうことがあります。仕切り直すだけで、あっさり進むこともあります。

5. 直す前に、元に戻せるようにしておく

エラーを直す作業で、ほかのファイルまで書き換わってしまうことがあります。大事なファイルは、直す前にコピーをとっておきましょう。作業用のフォルダで、ファイルのコピーを使って作業していれば、なお安心です。

直ったあとは、少ないデータで動かして、結果が正しいかを自分の目で確かめます。AI の説明も間違うことがあるので、「直りました」の一言だけで終わりにしないのがコツです。

まとめ

最後の数行を読む、そのまま見せる、3つの情報を添える、くり返したら止める、元に戻せるようにしておく。この5つの手順を覚えておくと、エラーが出ても落ち着いて進められます。

わからないときは、聞いてください

ココナラで、Claude Code の使い方を、トークルームの文章と画像でお教えするサービスを出品しています。ビデオ通話はなく、5日間、その日のご質問にまとめてお答えします。「このエラーの意味がわからない」というご相談も受け付けています（パスワードなどは消したうえで、画面の写真やエラーの文章をお送りください）。