❓ 6.1 FAQ 与报错排查（纯净发布版） 在使用 Old Dog AI 的过程中，如果您遇到了问题，请先查看以下列表。99% 的连接失败和报错都可以在这里找到解决方案。

🛠️ 1. 核心连接报错 (HTTP 状态码) ❌ 401 Unauthorized (认证失败)

原因：您的 API Key 填写错误，或者该 Key 已被您在控制台删除/禁用。

解决：请前往控制台确认令牌状态；检查复制时是否带入了多余的空格或换行符；确保您的 Key 是以 sk- 开头的完整字符串。

❌ 404 Not Found (接口地址错误)

原因：这是最常见的错误。通常是您的 Base URL (接口地址) 填错，或者路径拼接不符合软件要求。

解决：检查地址是否拼写错误；尝试补全/移除 /v1。大部分软件需要 https://api.olddog.shop/v1，而部分软件（如 Chatbox）会自动补全，只需填写 https://api.olddog.shop。

❌ 429 Too Many Requests (额度不足或频率过高)

原因：您的账户余额已耗尽，或者您在极短时间内发送了过多的并发请求。

解决：登录控制台查看余额。如果余额充足，请检查您的程序是否在进行大规模并发测试，建议增加重试机制或降低请求频率。

💻 2. 终端 CLI 工具专属报错 👾 Claude Code 报错：修改了配置但不生效

原因：第一次安装好的 Claude Code 必须经过一次环境变量初始化才能识别配置文件。

解决：请参考文档中的“初始化命令”，在终端临时设置一次 ANTHROPIC_BASE_URL 启动，之后系统就会自动读取配置文件了。

♊ Gemini CLI 报错：GEMINI_API_KEY 未设置

原因：环境变量未生效，或 .env 文件路径错误。

解决：检查变量名拼写是否 100% 准确；如果使用 .env 文件，请确认路径为 ~/.gemini/.env（注意是两个点）；Windows 用户在设置环境变量后，必须重启终端窗口才能生效。

📂 Codex 报错：找不到 config.toml 目录

原因：系统没有自动生成配置目录。

解决：请手动创建 .codex 目录。Windows 用户使用 mkdir "$env:USERPROFILE.codex"，Mac/Linux 用户使用 mkdir -p ~/.codex。

🤖 3. 模型调用问题 ❌ 提示 "Model not found" (找不到模型)

原因：您的模型名称填错（例如把 claude-sonnet-4-6 填成了 claude-sonnet-4.6）；或者您的 API Key 权限没有勾选该模型。

解决：请严格对照文档中的 [1.2 模型清单] 进行填写；登录控制台确保您的令牌勾选了“所有模型”。

📬 4. 仍未解决？ 如果以上排查均无法解决您的问题，请通过以下方式联系我们：

工单系统：登录控制台提交工单，我们会在 24 小时内回复。

官方交流群：[点击加入我们的开发者交流群]

邮件支持：support@olddog.shop