メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

エラーが出たら

画面が真っ白になったり、英語の知らせが出たりしても、壊れたわけではありません。何をしたら、何が起きたかと、出ている知らせをそのまま Claude に渡せば、たいてい直せます。

平日の夜、会社から帰った佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、売れ残り帳に1つ直しを頼みました。直ったかを確かめようと、印を1つ付けたとたん、画面の一部が消えました。

問い

佐藤さんの疑問

壊してしまったんだろうか。こういうとき、何をすればいいんだろう。

皮にひびが入り、中のあんが少しのぞいたまんじゅうの挿絵。

作っていると、画面が真っ白になったり、ボタンを押しても何も起きなかったり、英語の長い知らせが出たりすることがあります。

初めてだと、壊してしまったと思うかもしれません。でも、これは作っていれば、よく起きることです。この回では、そのときの動き方を見ていきます。

佐藤さんに起きたこと

佐藤さんが頼んだのは、あすの目安を、お菓子ごとの父のいつもの数から数える直しでした。「あすは雨」の印は、付けると目安の数が1割減る決まりです。

直したあと、「あすは雨」に印を付けてみると、あすの目安の欄が、全部空っぽになってしまいました。

この出来事は、説明のための架空の例です。

エラーメッセージ:うまく動かなかったという知らせ

作品が、うまく動かなかったときに出す知らせを、エラーメッセージと呼びます。エラー(error)は、英語で「誤り」という意味です。

エラーメッセージは、たいてい英語で、読んでも意味が分からないことが多いものです。読めなくてかまいません。大事なのは、そのまま Claude に渡すことです。自分で要約したり、一部だけ写したりすると、手がかりが抜け落ちます。

ログとコンソール:知らせが書き残される場所

エラーメッセージは、画面に出るとは限りません。次の2つの場所に、書き残されていることがあります。

  • ログ:仕組みが動いた記録を、時刻の順に書き残したもの。開発サーバー(手元で動かす仮のサーバー)も、ログを書き残しています。日誌のようなものです
  • コンソール:ブラウザ(ウェブページを見るためのアプリ)の奥にある、作品が出した知らせが並ぶ場所。ふだんは隠れています

コンソールについて、ウェブの作り方を解説している MDN というサイトには、こう書かれています。

DOCUMENTATION

“The JavaScript console allows you to run lines of JavaScript against the page currently loaded in the browser and reports errors encountered as the browser tries to execute your code.”

JavaScript のコンソールでは、いま開いているページに対して JavaScript を動かすことができ、ブラウザがコードを動かそうとしてつまずいたときのエラーを知らせます。

MDN Web DocsWhat are browser developer tools?

JavaScript は、第1部の第7回で見た、ウェブページに動きをつける言葉です。

ログもコンソールも、自分で開いて読む必要は、いまはありません。Claude Code の公式の説明によると、Claude は開発サーバーのログを見たり、エラーが出ていないかを調べたりできます。あなたは、「見て」と頼めば大丈夫です。

知らせが書き残される、2つの場所

エラーが画面に出ないとき

パソコンの中(開発サーバー) ログ 動いた記録を、時刻の順に ブラウザの奥 コンソール 作品が出した知らせ Claude に「見て」と頼む 自分で読めなくてよい パソコンの中(開発サーバー) ログ 動いた記録を、時刻の順に ブラウザの奥 コンソール 作品が出した知らせ Claude に「見て」と頼む 自分で読めなくてよい
図1知らせがどちらにあっても、することは1つです。

Claude への渡し方

困ったことが起きたら、次の3つを渡します。

  1. 何をしたか:どの画面で、何を押したか
  2. 何が起きたか:本当はどうなるはずで、実際はどうなったか
  3. 出ている知らせ:エラーメッセージがあれば、そのまま。画面の写真(スクリーンショット)もあれば添える

公式のコツにも、Claude に要るものが手元にあるなら、説明する代わりに、そのまま渡すように書かれています。エラーの画面の写真を貼ることも、例に挙がっています。

画面の写真は、次のように撮ります。

  • Mac:Shift キーと Cmd キーと 4 キーを一緒に押し、写したいところを、マウスで囲む
  • Windows:Windows キーと Shift キーと S キーを一緒に押し、写したいところを、マウスで囲む

撮った写真は、入力欄(頼みごとを打ち込む欄)の横の「+」を押して付けるか、入力欄まで引っぱってきて落とします。

佐藤さんは、こう頼みました。

エラーが出たときの頼み方の例
「3. あすの目安」の「あすは雨」に印を付けたら、あすの目安の数が、全部空っぽになりました。本当は、1割減った数が出るはずです。印を外すと、元の数に戻ります。画面の写真を添えます。開発サーバーのログとコンソールに、エラーが出ていないか見て、原因を、ふつうの言葉で説明してから直してください。

この依頼文は、説明のための架空の例です。

「原因を説明してから直して」と頼むのは、何が起きていたかを、自分でも分かっておくためです。同じことが起きたとき、どう頼めばよいかが分かります。

エラーメッセージは読めなくてかまいません。何をしたら、何が起きたかと、出ている知らせをそのまま、Claude に渡します。

注意

ただし、知らせを人に見せる前に、中身を確かめる

エラーメッセージやログには、パソコンの中のファイルの場所や、自分の名前、ときにはAPI キー(サービスを使うための秘密の鍵。第6部で扱います)が書かれていることがあります。

Claude に渡すのはかまいません。でも、Discord(ハッカソンの参加者が集まる、チャットの場所)など、人に見える場所に貼るときは、その前に中身を確かめてください。Claude Code の公式の説明にも、ログを公開の場に貼る前に、中身を見直すように書かれています。

次回の問い

佐藤さんの次の疑問です。何度頼んでも直らないときは、どうすればよいのでしょうか。

参考

Best practices for Claude Code(Claude Code)
エラーの画面は、説明するより写真を貼る、などの頼み方のコツ。英語。
code.claude.com · code.claude.com
What are browser developer tools?(MDN Web Docs)
コンソールを含む、ブラウザの奥の道具の説明。
MDN · developer.mozilla.org

このレッスンは役に立ちましたか?