背景：エラーが出たとき、私たちはつい全文をコピペする
Claude Code（自然言語で指示するとコードやファイルを操作してくれるAIエージェント）を使っていると、必ず一度はぶつかる瞬間があります。赤い文字でエラーが出て、画面が一気に不穏になるあの瞬間です。非エンジニアの方ほど、ここで反射的にやってしまう行動があります。エラーメッセージを上から下まで全部選択して、そのままチャットに貼り付け、「これ直して」と送る。私自身も最初はそうしていましたし、ほとんどの人がそうします。
ところが、これが意外とうまくいきません。一発で直ることもありますが、的外れな修正を提案されたり、別の場所を壊されたり、同じところを何度も行ったり来たりすることがあります。たとえば「ボタンの色を変えたかっただけ」なのに、エラーを消そうとして画面の別の部分まで作り替えられてしまった、という経験をした方もいるはずです。海外のある技術ブログが「You really shouldn't copy-paste errors into Claude Code（エラーをClaude Codeにコピペするのは本当にやめた方がいい）」というタイトルで、この習慣に正面から疑問を投げかけました。挑発的なタイトルですが、言っていることは極めて実務的で、しかも非エンジニアにこそ効く話です。
ここで大事なのは、これがツールの不具合の話ではないということです。問題はAIの性能ではなく、私たちがエラーという「結果」だけを渡して、そこに至る「状況」を渡していないことにあります。 この一点を理解するだけで、AIとの仕事の進め方が驚くほど変わります。逆に言えば、ここを押さえないままどれだけ高性能なAIを使っても、同じつまずきを繰り返してしまうということでもあります。
元ネタが指摘したこと：渡しているのは答えではなく症状
元の記事の主張を一言でまとめると、エラーメッセージは病気でいう「症状」にすぎない、ということです。たとえば体調が悪くて病院に行ったとき、あなたが「熱が38度あります」とだけ言って黙り込んだら、医師はどう動くでしょうか。解熱剤を出すかもしれませんが、それが正解かどうかは分かりません。いつから熱が出たのか、ほかに咳や痛みはあるのか、最近何を食べたか、無理をしていなかったか。そうした周辺情報があって初めて、医師は原因にたどり着けます。逆に、症状だけを聞いて薬を出す医師がいたら、私たちは不安になるはずです。AIに対しても、本来は同じ感覚を持つべきなのです。
エラーメッセージのコピペは、この「熱が38度あります」だけを渡している状態と同じです。エラー文そのものは、あくまで最後に表に出てきた結果です。本当の原因は、その手前で起きたこと、つまりあなたが何をしようとして、どんな操作をして、どういう環境で動かしていたか、の中に隠れています。エラー文だけを見たAIは、症状に合いそうな対処を当てにいくしかなく、見当違いの場所をいじってしまうことがあるわけです。
元記事はさらに、AIにエラーを丸投げするのではなく、AI自身に「調べさせる」方が良い、とも言っています。つまり、答えを書かせる前に、ログ（プログラムの動作記録）を読ませたり、関連するファイルを見させたり、状況を確認させたりするステップを挟む。人間でいえば、いきなり処方箋を書くのではなく、まず問診と検査をする、という流れに近いです。コピペで答えを急がせるより、状況を渡して原因から考えさせる方が、結果的にずっと速くて正確だ、というのが核心です。
なぜコピペだけだとうまくいかないのか
理由は大きく三つあります。一つ目は、エラー文には「何が起きたか」は書いてあっても「何をしたかったか」が一切書かれていないことです。あなたの頭の中にしかない目的、たとえば「請求書の合計金額を自動で出したかった」という意図は、エラー文のどこにも現れません。AIは目的を知らないまま、目の前のエラーを消すことだけを目標にしてしまい、あなたの本当のゴールからずれた修正をすることがあります。エラーは消えたのに、出てきた合計金額が間違っている、という最悪のパターンすら起こり得ます。
二つ目は、文脈の範囲が分からないことです。同じ「ファイルが見つかりません」というエラーでも、原因は十通り以上あります。ファイル名のスペルミスかもしれないし、置き場所が違うのかもしれないし、そもそも前の手順が途中で止まっていたのかもしれません。拡張子が変わっていた、というだけのこともあります。状況の説明がなければ、AIはどの可能性が高いかを絞り込めず、確率の高そうな順に総当たりするしかなくなります。総当たりは時間がかかるうえ、関係ない箇所まで触られるリスクが上がります。
三つ目は、対話が一往復で終わってしまうことです。エラー文を貼って「直して」と言うと、AIは「とりあえずの答え」を返します。それが外れていると、また別のエラーが出て、また貼って、という不毛なラリーが始まります。症状だけを渡すと、AIは推測で動かざるを得ず、その推測が外れるたびに往復が増えていきます。 この往復は、回を重ねるほど前の文脈がぼやけ、AIが何を直そうとしていたのかも見失いやすくなります。状況を最初に渡しておけば、この往復そのものを減らせるのです。
非エンジニアにとっての本当の意味
この話は、実はプログラミングに限りません。AIに何かを頼むときの「伝え方の基本」そのものです。非エンジニアの方がAIを使うとき、つまずきの大半は専門知識の不足ではなく、状況をうまく言葉にできていないことから来ています。エラー対応はその縮図です。資料作成でも要約でも、同じ構図がそっくりそのまま当てはまります。
考えてみてください。あなたが部下や外注先に仕事を頼むとき、いきなり「このエラー、直しといて」と画面のスクショだけ投げる人は少ないはずです。普通は「先週作った見積りの自動計算、金額が合わないんだけど、たぶん税率のところ。これこうしたいんだよね」と、状況と希望をセットで伝えます。相手が優秀な人ほど、こういう伝え方をすると的確に動いてくれます。AIに対しても、まったく同じことをすればいいだけなのです。
ここで安心してほしいのは、専門用語を覚える必要はまったくないということです。必要なのは、自分が何をしていて、どうなってほしいのかを、普段の日本語で短く添えること。たったそれだけで、AIの動きは変わります。非エンジニアにとってこの記事の教訓は、技術を学べという話ではなく、頼み方を少し変えるだけで成果が大きく変わるという話です。 むしろ、状況を言葉にする力は、現場の仕事をいちばんよく分かっている非エンジニアの方が得意なことが多いのです。日々お客様や同僚に物事を説明している人ほど、この切り替えはすぐにできます。
業種別の活用例：あなたの現場ではこう効く
ここからは具体的に見ていきます。どれも、エラー文だけを渡す場合と、状況を添える場合で、何が変わるかを意識してください。
一つ目は、10人規模のEC運営会社で在庫管理の担当をしている方の例です。仕入れデータを取り込むツールをClaude Codeに作ってもらったところ、実行すると赤いエラーが出ました。ここでエラー文だけを貼るのではなく、こう添えます。「楽天からダウンロードしたCSVファイルを読み込ませて、商品ごとの在庫数を一覧にしたい。さっきまで動いていたけど、今日のファイルから急に止まった。ファイルの中身は普段と同じはず」。この一文があると、AIは「今日のファイル特有の問題」だと当たりをつけ、文字コードや空欄のセル、見出し行のずれなど、データ側の原因を先に疑えます。エラー文だけなら見当違いのプログラム修正に走っていたかもしれません。ポイントは「いつから・何をきっかけに」を添えたことです。
二つ目は、税理士事務所で顧問先の試算表を整理している士業の方の例です。複数の会計データを一つの表にまとめる作業を自動化していて、途中で「数値が合計されない」という挙動に出くわしました。ここでは「A社からE社まで5社分の月次推移を1枚にまとめたい。4社まではうまくいくのに、C社だけ合計が0になる。C社のデータだけ別の人が作ったもの」と伝えます。AIは「C社のデータだけ形式が違う可能性」に集中でき、原因をピンポイントで突き止められます。たとえば数字が文字列として入っていた、桁区切りのカンマが混じっていた、といった違いです。守秘の観点で実際の社名や金額を出したくないときは、A社・B社と置き換えて構いません。大事なのは構造だけ伝わることです。
三つ目は、15人ほどのマーケティング会社でSNS運用を担当している方の例です。複数アカウントの投稿実績を毎週集計するスクリプトが、ある週から動かなくなりました。「インスタとXの先週の投稿数といいね数を1つの表にしたい。先週までは毎週月曜に問題なく動いていた。先週末にパソコンの更新があったかもしれない」。この一文で、AIは「コードの中身」ではなく「環境の変化」を最初に疑えます。エラー文だけを渡していたら、正常なコードをいじって、かえって壊していた恐れもあります。状況を添えることが、無駄な手戻りを防ぐのです。
四つ目に、もう少し小さな例も挙げておきます。個人事業主のデザイナーの方が、請求書PDFを毎月まとめて作る仕組みでつまずいたとします。「先月までは10件まとめて出力できていたのに、今月は3件目で止まる。3件目のお客様だけ屋号がすごく長い」。この一言で、AIは「特定のデータの長さや特殊文字」を疑えます。共通しているのは、どの例も専門用語ゼロで、しかも原因の入り口を指し示しているという点です。
そのまま使える実践手順：伝え方のテンプレ
では、具体的にどう伝えればいいのか。難しく考える必要はありません。次の流れで一言ずつ足すだけです。エラーが出たら、すぐにコピペボタンを押す前に、頭の中でこの順番を一周してください。慣れれば10秒もかかりません。
最初に「何をしようとしていたか」を書きます。目的です。次に「どこまではうまくいって、どこで止まったか」を書きます。これが原因の範囲を一気に絞ります。さらに「最近変えたことはないか」を書きます。昨日まで動いていたものが急に止まったときは、たいてい何かが変わっています。ファイルの場所、ファイルの中身、パソコンの更新、いずれかが多いです。そのうえで、エラーメッセージも添える。順番が逆で、エラー文に状況を足す、というイメージです。最後に「どうなってほしいか」を書けば完璧です。
文章にすると、たとえばこうなります。「先月作った経費精算の集計ツールで、今月分のレシートデータを取り込みたい。先月までは動いていたが、今月のファイルでエラーが出た。変えたのはファイルの保存場所だけ。元どおり集計できるようにしたい。エラーはこれ→（ここに貼る）」。専門用語はゼロですが、AIが原因にたどり着くための材料はすべて入っています。慣れないうちは、この5項目を付箋やメモアプリにテンプレとして保存しておき、毎回そこに当てはめて書くのがおすすめです。
もう一つ、強力なコツがあります。AIに答えを急がせず、先に調べさせることです。「すぐ直さなくていいので、まず何が原因か考えてから教えて」と一言添えるだけで、AIは関連するファイルやログを確認してから動くようになります。「原因の候補を3つ挙げて、どれが怪しいか教えて」と聞くのも有効です。急いで答えを書かせるより、いったん原因を説明させてから直してもらう方が、結局いちばん速いです。 遠回りに見えて、これが最短ルートになります。
注意点とよくある誤解
ここでいくつか、ありがちな誤解を解いておきます。
一つ目の誤解は、状況を長く書かないといけない、という思い込みです。そんなことはありません。必要なのは精度であって長さではありません。だらだら書くより、「何をしたくて、どこで止まって、何を変えたか」の三点が入っていれば十分です。むしろ長すぎると要点がぼやけ、AIがどこに注目すべきか迷ってしまいます。一往復が一段落のメモで足りる、と考えてください。
二つ目の誤解は、エラー文はもう貼らなくていい、という極端な受け取り方です。これは違います。エラー文は依然として大事な手がかりです。元記事が言っているのは「エラー文だけを渡すな」であって「エラー文を渡すな」ではありません。状況を主役にして、エラー文は脇役として添える。この役割分担が正解です。エラー文は省略せず、できれば全文を貼ったうえで、その前に状況を置いてください。
三つ目は、機密情報の扱いです。顧客名や金額、社内の固有名詞をそのままAIに渡すことに不安がある方も多いはずです。前述のとおり、社名はA社・B社に、金額はダミーの数字に置き換えて構いません。AIが必要としているのは具体的な中身ではなく、データの構造や手順の流れです。会社で利用ルールが決まっている場合は、必ずそれに従ってください。ルールがまだない場合は、置き換えを習慣にしておくと安全です。
四つ目は、それでも直らないときの構え方です。状況を添えても一発で直らないことはあります。そのときは、AIが返してきた「原因の説明」が合っているかを自分の感覚で確かめてください。現場を知っているあなたが「いや、そこは関係ないはず」と思ったら、それを伝えればいい。AIは賢い相棒ですが、現場の文脈を知っているのはあなたであり、その違和感こそが正解への近道です。 主導権は最後まで人間が握ります。AIの説明をうのみにせず、対話で詰めていく姿勢が、結局いちばん安全で速い進め方です。
まとめ：コピペの前に、ひと呼吸
エラーが出たときの行動を、コピペから「状況を添える」に変える。たったこれだけのことですが、効果は大きいです。AIは症状ではなく状況から原因を絞り込めるようになり、的外れな修正や不毛な往復が減ります。そして何より、この習慣はエラー対応に限らず、AIに資料を作らせるときも、要約させるときも、分析させるときも、そのまま効きます。伝え方の型を一つ身につけるだけで、あらゆる場面の成果が底上げされるということです。
覚えておくべきは、結局これは特別なテクニックではなく、人に仕事を頼むときの当たり前を、AIにも適用するだけだということです。何をしたくて、どこで困っていて、どうなってほしいか。これを普段の言葉で伝えられる人は、AIを思いどおりに動かせます。そしてその力は、専門知識ではなく、現場を分かっている非エンジニアの方ほど強く持っています。
明日エラーが出たら、コピペボタンに指を伸ばす前に、ひと呼吸おいてください。「私は何をしたかったんだっけ」と一行書く。それだけで、あなたとAIの仕事はぐっと噛み合うはずです。
Claude Worksでは、非エンジニアの方が日々の業務でClaudeをうまく使いこなすための実践的なサポートを行っています。エラー対応の伝え方から、自分の仕事に合った使い方の設計まで、無料30分相談で具体的にお話しできます。気になることがあれば、お気軽にご相談ください。
