ChatGPT・Claude・Geminiのインターフェースで「API keyが無効」エラーが出るときの切り分けチェックリスト

血圧が跳ね上がるのは、モデルが書けないことじゃなくて、いざ始めようとした瞬間にコンソールがAPI key invalid、401、network errorと突き返してくることだ。自分がいちばんハマったのは、Keyは問題ないのに原因が「周辺設定」にあるパターン。このチェックリストは、普段使っているChatGPT、Claude、Geminiの順で並べた。

まずは正しいKeyと正しいプロジェクトを使っているか確認する

古いKeyやテスト用Keyをコピーしていたり、コンソールでプロジェクトを切り替えたのに気づいていなかったりする人が多い。提供元の管理画面でKeyを新規作成して、すぐに一度差し替えるのがおすすめ。古い環境と泥沼で戦わないこと。

権限と課金が有効になっていなければ、Keyがないのと同じ

401/403は必ずしもKeyの間違いではない。よくあるのは、課金が未有効、権限スコープ不足、組織/プロジェクトの制限。ClaudeやGeminiのように「使えそうに見える」のに、APIを叩いた途端にエラーになるケースは特に多い。どうして知ってるかは聞かないで。

環境変数と空白は隠れた殺し屋

.envに余計な空白がある、改行処理ができていない、デプロイ先プラットフォームに変数が注入されていない——こうしたことが全部「Key無効」になる。Keyの長さを出力してみたり、前後をtrimしたりするほうが、エラーを30分にらむより効く。

ネットワーク接続の問題は思っているより頻繁に起きる

タイムアウト、DNS失敗、たまに出る502に遭遇したら、まずネットワーク/プロキシ経路を疑うべき。一部のプラグインのドキュメントでも「ネットワーク接続問題のトラブルシューティング」をわざわざ独立項目で書いているが、誇張じゃない。

依存関係やバージョンが原因の「偽エラー」を見落とさない

NodeプロジェクトでETARGET、ERESOLVE、ENOTEMPTYのような依存関係の問題が起きていると、アプリ自体がそもそも起動しておらず、それをAPI障害だと勘違いすることがある。まず依存関係を安定して入れてから、APIをテストすること。

自分がよく使うクイック自検の順番

• 新しいKeyに替えてすぐ1回テストする
• プロジェクト/組織/権限と課金ステータスを確認する
• 環境変数が注入されているか、空白や改行が混ざっていないか確認する
• 直結回線や、よりクリーンなプロキシで再テストする
• 依存関係のインストールと実行時エラーを除外する

Claudeをさらに多くのツールに接続したい（例えばMCPで既存APIを素早く「アシスタントに接続」する）なら、アカウント、Key、ネットワークの3つを先にきっちり整えておくのがおすすめ。時間を節約してハマりを減らしたいなら、Titikeyで自分が整理したツール一覧と実測の経験を見てみてほしい。基本的に「そのままコピペで使える」タイプのものばかりだ。