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看看我整理的工具清单和实测经验，基本都是“能直接照抄”的那种。