バイブコーディングのやり方の通りにAIの指示どおりコードを書いたのに、実行したら赤い文字がずらっと出てきて固まってしまった——そんな場面に立たされていませんか。
英語だらけの文章に「Error」の文字。心当たりのない専門用語。思わずブラウザを閉じたくなった方もいるかもしれません。でも安心してください。エラーは失敗の証拠ではなく、プログラムを書く人なら誰でも毎日目にしている、ただの通過点です。
この記事では、エラーメッセージのどこを見ればいいか、AIにどう伝えれば直してもらえるか、そしてよくあるつまずきパターンの見分け方をお伝えします。読み終える頃には、赤い文字を見ても手が止まらなくなっているはずです。
エラーは失敗ではない——まず落ち着く
最初にはっきり言っておきます。エラーが出たのは、あなたのやり方が間違っていたからではありません。
正直に言うと、私はIT業務を30年近くやっていますが、いまだに毎日のようにエラーに出会います。インフラの設定を書き換えても、簡単なスクリプトを書いても、一発で完璧に動くことのほうが珍しいくらいです。プロと初心者の違いは「エラーが出るかどうか」ではなく、「出たときに慌てないかどうか」だけだと感じています。
バイブコーディング（AIとの会話でコードを作る手法）は、AIが下書きを作り、人間が動かして確認する共同作業です。動かしてみて初めて分かる不具合があるのは当然の流れであり、むしろ健全なプロセスと言えます。エラーが出たら「AIと一緒に直すフェーズに入った」くらいの気持ちで構いません。
エラーメッセージの見方——全部読まなくていい、ここだけ見る
Pythonのエラーメッセージは「トレースバック（traceback）」と呼ばれる形式で表示されます。長々と英語が並んでいて身構えてしまいますが、読み方にはコツがあります。
トレースバックは、上から順に「処理がどんな経路をたどったか」を記録したものです。そして一番下の行に、結局何が起きたのかという結論が書いてあります。つまり、上から全部読む必要はなく、まず一番下の行だけ見る。これだけで、原因の見当がつくケースがほとんどです。
代表的なエラーを4つ、実際の表示例つきで紹介します。
ModuleNotFoundError（ライブラリが見つからない）
たとえばAIが、外部ライブラリ（pandasなど）を使うコードを提案してきたとします。そのライブラリがまだPCに入っていない状態で実行すると、次のようなエラーが出ます。
Traceback (most recent call last):
File "sample.py", line 3, in <module>
import pandas as pd
ModuleNotFoundError: No module named 'pandas'
一番下を見ると「’pandas’という名前のモジュールがありません」とあります。AIが使おうとした部品（外部ライブラリ）が、まだPCに入っていないというサインです。ちなみにバイブコーディングのやり方で作ったコードは標準ライブラリだけで書かれているため、このエラーは出ません。AIが外部ライブラリを使うコードを出してきたときに覚えておいてほしいパターンです。
FileNotFoundError（ファイルが見つからない）
バイブコーディングのやり方で作ったinvoice_split.pyを例にします。読み込むはずのinvoices.csvが見つからないと、次のようなエラーになります。
Traceback (most recent call last):
File "invoice_split.py", line 9, in <module>
with open(input_file, encoding="utf-8", newline="") as f:
FileNotFoundError: [Errno 2] No such file or directory: 'invoices.csv'
指定したファイルが、指定した場所に存在しないという意味です。invoice_split.pyと同じフォルダにinvoices.csvを置き忘れていた、というのが典型的な原因ですね。
SyntaxError（書き方の間違い）
File "sample.py", line 8
if total > 10000
^
SyntaxError: expected ':'
コードの文法そのものが崩れている状態です。AIが生成したコードで発生することは比較的まれで、人間が手直しした際の消し忘れなどで出やすい印象があります。
PermissionError（書き込む権限がない）
同じinvoice_split.pyで、振り分け後のファイルを書き出す場面を例にします。出力先の2026-07.csvをExcelで開いたまま実行すると、次のようになります。
Traceback (most recent call last):
File "invoice_split.py", line 19, in <module>
with open(output_file, "w", encoding="utf-8", newline="") as f:
PermissionError: [Errno 13] Permission denied: '2026-07.csv'
保存しようとしたファイルが、別のソフト（Excelなど）で開いたままになっているときによく出ます。一度閉じてから実行し直せば解決することが多いです。
AIにエラーを直してもらう——伝え方のコツ
エラーの内容が分かったら、次はAIに直してもらう番です。ここで伝え方が雑だと、AIも状況を推測するしかなく、的外れな修正が返ってくることがあります。
悪い例と良い例を比べてみましょう。
- 悪い例：「動きません」とだけ送る → AIは何が起きたか分からないまま、当てずっぽうで直そうとします
- 良い例：エラーメッセージを全文コピペし、直前に何をしたかを添えて伝える
コピペしてそのまま使えるテンプレを用意しました。
以下のエラーが出ました。
（ここにエラーメッセージを全文貼り付け）
直前に実行したのは「〇〇.py」というファイルで、
やろうとしていたのは「△△」です。
原因と直し方を教えてください。
ポイントは「全文」を貼ることです。途中で省略してしまうと、一番大事な最後の行がAIに届かず、見当違いの回答が返ってくることがあります。面倒でも、エラー画面ごとコピーして貼り付けるのが結局は一番早い方法です。
よくあるつまずきパターンと対処
単発のエラーだけでなく、「なんとなく詰まって前に進めない」状態にもいくつかの型があります。
パターン1：ライブラリが見つからない
ModuleNotFoundErrorが出たら、pip install（部品を追加でインストールするコマンド）が必要というサインです。ただし、AIに言われるがまま実行する前に、そのライブラリが安全なものか一度確認する習慣を持ってください。詳しくはバイブコーディングで気をつけたい安全対策で解説しています。
パターン2：ファイルが見つからない
保存した場所と、コードが探しに行っている場所がズレているケースがほとんどです。「デスクトップに保存したつもりが、実は別のフォルダに入っていた」というのは、私も含めて誰でもやるうっかりです。
パターン3：何度直しても同じエラーがループする
AIと何往復もやり取りしているのに、同じエラーが出続けることがあります。こうなったら一度会話をリセットし、「何をしたいか」「今どんなエラーが出ているか」を箇条書きで整理してから、改めて伝え直してみてください。案外あっさり解決することが多いです。
パターン4：AIの回答がだんだん的外れになってきた
会話が長くなるほど、AIが過去のやり取りに引っ張られて変な方向に進むことがあります。そういうときは、粘るより新しい会話セッションを始めたほうが早い場合も少なくありません。
それでも解決しないときは
ここまでやっても解決しないことも、正直あります。そんなときの次の一手をいくつか用意しておきましょう。
- 別のAIに聞き直す（ChatGPTで詰まったらClaudeに、という「セカンドオピニオン」＝一人の意見だけで決めず、別の視点でも確認する発想）
- エラーメッセージの一部だけをコピーして検索する（
ModuleNotFoundError pandasのように短く区切ると探しやすい） - 一旦PCから離れて、翌日改めて考え直す（これは怠けではなく有効な戦略です）
そして、業務に直結するツールや機密データを扱っている場合は、無理に一人で抱え込まないでください。時間をかけて自力解決を目指すより、専門家に一度見てもらったほうが早く安全に済むことも多いものです。
まとめ
最後に、この記事のポイントを振り返ります。
- エラーメッセージは一番下の行から読む
- AIに伝えるときは、エラー文を全文コピペして状況を添える
- よくあるつまずきパターン（ライブラリ不足・パス違い・ループ・回答のズレ）を見分ける
- 解決しないときは会話をリセットする、セカンドオピニオンを聞く、一旦離れる
ここまでできれば、ツールを動かし続けるための基本は身についたと言えます。あとは安全に使い続けるための最後の仕上げです。バイブコーディングで気をつけたい安全対策で、pip install前に確認すべきポイントを押さえておきましょう。
「自分だけで判断するのは不安」「業務で使う前に一度見てほしい」という方には、TechnoBridgeの無料相談やセミナーもご用意しています。神奈川・東京・山梨を中心に活動していますので、エラー対応に限らず気軽にお声がけください。
コメント