ChatGPT Claude Gemini 接入外掛報 API 金鑰錯誤的解決辦法

把 ChatGPT、Claude、Gemini 接到第三方客戶端或機器人外掛裡，最常見的翻車點就是API 金鑰錯誤：明明複製貼上了，還是提示 invalid key、401、unauthorized。下面這套排查我基本每次都能救回來。

先別急著重裝 5 個高頻原因

1 金鑰複製帶了空格或換行

尤其從網頁複製到設定檔，末尾多一個空格就能讓你懷疑人生。把 key 手動重打一遍最省心。

2 放錯位置 環境變數沒生效

很多工具同時支援「設定檔」和「環境變數」，結果你改了 A 它讀的是 B。建議直接在日誌裡搜key from或查看外掛文件的讀取優先順序。

3 選錯供應商或模型名

多模型客戶端很容易把 OpenAI 的模型名拿去請求 Claude，報錯還挺像。模型列表別靠記憶，去控制台複製最穩。

4 權限或額度問題

有些 key 預設沒開啟計費／沒綁卡／沒開啟對應 API 權限，會被當成「無效」。看控制台裡的 Usage 和 Billing，比盯著報錯強。

5 網路與地區限制

請求根本沒到伺服器，也會被客戶端包裝成「金鑰錯誤」。能的話用 curl 直連測一次，再決定要不要換節點。

順手修兩類常見安裝報錯

如果你用的是類似 koishi 這類外掛環境，遇到 ETARGET、ERESOLVE、ENOTEMPTY 這類相依問題，別和 key 死磕，先把相依裝乾淨、鎖定版本，再回頭測 API。

我更推薦的省事做法

想把 Claude 之類快速接進現有 API 體系，可以看看把現有 API 轉成 MCP 服務的方案，省掉一堆膠水設定，少踩坑。

如果你卡在帳號開通、訂閱或支付環節，折騰半天還沒開始用，去Titikey看看更省時間的方案，別讓「設定」搶走你真正要做的事。