ChatGPT・Claude・GeminiのAPIキーエラーの直し方：6つのチェックポイントで一発解決

こんな発狂する瞬間に遭遇したことない？ChatGPTやClaudeをサードパーティ製クライアントに接続したら、ひと言送っただけで401/403が出る。Geminiのほうも、キーをちゃんとコピーしたはずなのに無効だと言われる。焦らなくて大丈夫。こういう問題の8割は「あなたに使う資格がない」んじゃなくて、どこかの小さな見落としが原因。

1 まずはどのエラーなのかを見極める

401はたいていKeyの入力ミス／付け忘れ、403は権限・地域・プロジェクト未有効化っぽい、429はクォータ切れまたはレート制限。まずはエラーコードをスクショで残しておくと、後の切り分けが半分ラクになる。

2 Keyそのものの問題：一番多いし一番理不尽

• コピー時にスペースや改行が混ざっている（特にドキュメントからコピペ）
• 「表示用のKey」を「本物のKey」と勘違い（プラットフォームによっては一度しか表示されない）
• 環境を間違える：テスト用Keyを本番環境に入れている

小ネタ：多くの「APIキーエラー」は、目に見えないスペース1個が原因だったりする。人間の目には見えなくても、プログラムは容赦してくれない。

3 権限やスイッチが未有効：有効にしたつもりでできてない

Geminiでよくあるのは、該当プロジェクトでAPIを有効化していないこと。ChatGPT関連も、APIプロジェクトや請求（Billing）の状態を要確認。Claudeをツール層経由でつないでいるなら、ツール側が権限をちゃんとマッピングできているかも見ておく。

4 プロキシと地域が引き起こす“偽の失敗”

同じKeyなのに社内ネットワークだとダメで、スマホのテザリングだと通るなら、だいたいネットワーク経路の問題。プロキシ、DNS、社内ゲートウェイなどの要因を排除してから製品に文句を言っても遅くない。

5 サードパーティ製クライアントの罠：Headerの書き方ミス／変数が読めてない

クライアントによっては「Bearer + 半角スペース + Key」を要求し、スペースがないだけで即401になる。さらに腹立つのが、.envでKeyを更新したのにサービスを再起動しておらず、古いKeyのまま動いているケース。

6 ClaudeをMCPやゲートウェイ経由でつなぐときは、まず経路を分解してテスト

MCPゲートウェイのようなもので既存APIをClaudeで使えるサービスに変換しているなら、「元のAPIを直叩き → ゲートウェイを直叩き → Claudeから呼ぶ」の3段階でそれぞれ疎通確認するのがおすすめ。最初から全経路まとめて運ゲーしない。

ついでにMidjourney：なぜ“Keyエラー”があまり出ないのか

Midjourneyは主にDiscord上で使うため、よくある問題はむしろチャンネル権限、ボットに画像投稿権限がない、コマンド書式が崩れている、など。プロンプトも複雑にしすぎないで、絵のチュートリアルで言うKISS（シンプルに保つ）が本当に効く。

遠回りしたくないなら、よくある決済／サブスク／地域制限やツール連携の落とし穴もまとめてあるので、Titikeyで該当キーワードを検索してみて。だいたい“そのまま当てはまる”形で解決できるはず。