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 一下，比盯報錯半小時管用。

網路連線問題比你想的更頻繁

如果你遇到逾時、DNS 失敗、偶發 502，優先懷疑網路/代理鏈路。像一些外掛文件裡也把「網路連線問題故障排除」單拎出來說，真不是矯情。

別忽略依賴和版本導致的假報錯

Node 專案裡遇到 ETARGET、ERESOLVE、ENOTEMPTY 這類依賴問題時，應用可能壓根沒跑起來，你卻以為是 API 掛了。先把依賴裝穩，再測介面。

我常用的快速自檢順序

• 換新 Key 立刻測一次
• 確認專案/組織/權限和計費狀態
• 檢查環境變數是否注入、是否有空格換行
• 用直連網路或更乾淨的代理複測
• 排除依賴安裝與執行時錯誤

如果你還想把 Claude 接到更多工具（比如用 MCP 把現有 API 快速「接入助手」），建議把帳號、Key、網路這三件事先打磨順了。想省時間少踩坑，可以去 Titikey 看看我整理的工具清單和實測經驗，基本都是「能直接照抄」的那種。