常见问题
这里按客户端收录 APINebula 接入和使用过程中较常见的问题。请先确认自己使用的是哪个客户端，再进入对应页面排查；不同客户端的配置文件和启动方式不能混用。
API 正常使用与封禁风险
请仅将 API 用于合法、正常的开发和测试。以下行为可能触发风控，导致 API Key、令牌分组或相关账号被限制甚至封禁：
- 发送探针、扫描或批量试探请求，用于探测接口、模型、账号状态或平台规则。
- 将 API 对接到沉浸式翻译、酒馆等工具，并用于违规内容、绕过平台限制或其他违法违规用途。
- 连续触发官方账号的风险提示或风控规则，尤其是涉及黄、赌、毒、诈骗等违法违规内容。
- 破解、盗用、撞库、绕过验证，或以其他方式破坏、规避官方账号安全机制。
请控制请求频率和并发，遵守相关平台的服务条款与法律法规；出现风险提示时应立即停止相关请求并排查调用内容。
按客户端选择
| 客户端 | 配置教程 | 常见问题 |
|---|---|---|
| Codex CLI / VS Code 插件 | Codex 配置 | Codex 常见问 题 |
| ChatGPT | ChatGPT 配置 | ChatGPT 常见问题 |
| Claude Code CLI | Claude Code 配置 | Claude Code 常见问题 |
| Claude Code 桌面版 | Claude Code 桌面版配置 | Claude Code 桌面版常见问题 |
| Gemini CLI / Antigravity CLI | Gemini CLI 与 Antigravity CLI 配置 | Gemini CLI 与 Antigravity CLI 常见问题 |
| Kimi Code CLI | Kimi Code CLI 配置 | Kimi Code 常见问题 |
| Grok Build | Grok Build 配置 | Grok Build 常见问题 |
| GLM（通过 Claude Code） | GLM Claude Code 配置 | GLM 常见问题 |
常见报错速查
| 现象 | 优先检查 |
|---|---|
当前服务暂不支持该模型、model_not_found | 模型名称是否正确，令牌分组是否支持该模型 |
403 Forbidden、令牌无权访问模型 | 令牌的 模型可用列表 是否限制了当前模型 |
仍在连接 api.anthropic.com | Claude Code 是否读取了正确的 settings.json 和 ANTHROPIC_BASE_URL |
| 桌面版无法启动或缺少 Code 组件 | 进入 Claude Code 桌面版问题页，检查系统组件和下载状态 |
| 修改配置后没有变化 | 完全退出并重新启动客户端；再检查 CODEX_HOME 或 CLAUDE_CONFIG_DIR 是否将配置目录改到了其他位置 |
