🆘 报错锦囊

AI 工具常见报错及解决方案。搜索报错信息，快速找到解决办法。

🤖

ChatGPTAPI额度付费

You have exceeded your current quota, please check your plan and billing details

原因

API 免费额度已用完

✅ 解决方案

1. 登录 OpenAI 平台查看用量
2. 升级到付费计划（Plus 或 API 付费）
3. 或等待下月额度重置
4. 免费替代：切换使用 DeepSeek 或 Claude 免费版

⌨️

Claude CodeAPI Key认证环境变量

Error: Authentication failed. Please check your API key

原因

API Key 未设置或已过期

✅ 解决方案

1. 检查环境变量 ANTHROPIC_API_KEY 是否设置
2. 在 Anthropic Console 重新生成 API Key
3. 确认 Key 格式正确（以 sk-ant- 开头）
4. Windows 用户：注意 PowerShell 和 CMD 设置方式不同

🧠

DeepSeek频率限制免费版

模型请求频率过高，请稍后再试

原因

免费用户有频率限制（每分钟请求数）

✅ 解决方案

1. 等待 1-2 分钟后重试
2. 减少并发请求数量
3. 升级到 DeepSeek 付费版（频率限制大幅提升）
4. 使用离线/异步方式批量处理

⚡

Codex CLI安装权限npm

npm ERR! code EACCES — permission denied

原因

全局安装权限不足

✅ 解决方案

1. Mac/Linux：在命令前加 sudo
2. Windows：以管理员身份运行终端
3. 或使用 npx 代替全局安装
4. 配置 npm 全局目录为非系统路径

🔧

通用网络超时常见

Request timed out / 请求超时

原因

网络连接不稳定或 API 服务端负载过高

✅ 解决方案

1. 检查网络连接
2. 使用代理/VPN（如访问海外服务）
3. 减少单次请求的 token 数量
4. 错峰使用（避开高峰期）
5. 实现重试机制（间隔 3 秒重试 3 次）

🤖

ChatGPT上下文token限制

The model returned an error: context_length_exceeded

原因

对话内容超过模型上下文限制

✅ 解决方案

1. 开启新对话
2. 删除对话中不必要的历史消息
3. 将长文档分段发送
4. 使用支持更长上下文的模型（如 GPT-4-Turbo 128K）
5. 使用 RAG 技术处理超长文档

🎨

Stable Diffusion显卡显存本地部署

CUDA out of memory

原因

显卡显存不足

✅ 解决方案

1. 降低生成分辨率
2. 减少 batch size
3. 使用 --medvram 或 --lowvram 参数启动
4. 关闭其他占用显存的程序
5. 使用云端 GPU 服务（如 RunPod/Replicate）

🔧

通用API速率限制429

API 返回 429 Too Many Requests

原因

请求频率超过 API 限制

✅ 解决方案

1. 检查 Retry-After 响应头，等待指定时间
2. 实现指数退避重试策略
3. 使用多个 API Key 轮换
4. 批量合并请求减少调用次数
5. 在代码中添加速率限制器