玖亿 API
常见问题

常见问题

遇到连接问题时，建议从上到下检查。一次只改一项配置，改完后重新发送请求并查看玖亿 API 控制台的请求日志。

快速定位：令牌与额度 · 模型与分组 · Codex 切换分组报错 · Base URL · 配置未生效 · 连接错误 · Claude 客户端

先做基础检查

  1. 使用 CC-Switch 时，确认选择的是实际使用的客户端入口
  2. 核对 Base URL 是否需要 /v1
  3. 确认令牌有效、仍有额度，并属于目标模型可用的分组
  4. 使用 CC-Switch 时重新启用配置；手动配置时保存更改并重新打开终端
  5. 完全退出并重启客户端，发送一次请求，再查看玖亿 API 使用日志 (opens in a new tab)

出现 401、403 或额度不足

提示优先检查
401 UnauthorizedAPI Key 是否完整、有效，并已写入当前启用的客户端入口
403 Forbidden结合错误正文检查令牌、分组、权限或请求限制
429 Too Many Requests请求频率、并发或上游容量；如有 Retry-After 请按提示等待
5xx平台或上游暂时异常；记录请求 ID 后稍后重试
额度不足账户余额，以及令牌是否设置了单独的额度上限

替换令牌后，使用 CC-Switch 时需要重新启用配置；手动配置时需要保存更改并重新打开终端。之后彻底重启客户端。令牌创建与额度设置见 快速开始。

提示模型不存在或分组不匹配

  1. 打开 模型广场
  2. 在目标分组下复制完整模型 ID，不要凭记忆填写简称
  3. 对照 令牌分组介绍 检查当前令牌
  4. 分组不匹配时，创建正确分组的新令牌
  5. 更新 API Key 和模型后，使用 CC-Switch 时重新启用配置；手动配置时保存更改并重新打开终端

模型列表会变化，以模型广场当前显示为准。

如果 CC-Switch 无法获取模型列表，先确认 Base URL、API Key 和令牌分组正确，再使用模型广场中的完整模型 ID 手动填写。

Codex 切换分组后，旧对话报加密内容校验失败（400）

典型报错如下，rs_... 是对话内容条目的标识：

status_code=400
The encrypted content for item rs_... could not be verified.
Reason: Encrypted content could not be decrypted or parsed.

例如，从 Codex 反代分组切换到官 Key 或 Azure-Sale 后，继续使用旧对话可能出现这个错误。旧对话可能携带原分组返回的加密上下文；不同分组的上游协议或加密处理方式不兼容时，新分组无法校验或解密这些内容。

处理方法：在目标分组下新建对话，再发送请求。 如需继续原任务，将任务说明和必要背景整理为文字带入新对话。若要继续使用旧对话，可尝试切回原分组。

仅重启客户端不会转换旧对话的加密内容。新建对话后仍报错时，再检查目标分组、API Key、模型和使用日志 (opens in a new tab)。

Base URL 应该怎么填

客户端Base URL
Claude Code CLIhttps://api.9e.lv
Claude Desktop（Code）https://api.9e.lv
Codex CLI / Codex 桌面版https://api.9e.lv/v1
Gemini CLIhttps://api.9e.lv
Grok Buildhttps://api.9e.lv/v1

Codex 和 Grok Build 需要 /v1；Claude Code、Claude Desktop 和 Gemini 不要添加 /v1。一般只填写 Base URL，不要自行追加 /responses 或 /chat/completions。

修改配置后没有生效

按以下顺序处理：

  1. 使用 CC-Switch 时确认点击了 启用；手动配置时确认文件已保存、环境变量已在新终端生效
  2. 完全退出客户端，包括系统托盘、菜单栏或 VS Code 后台进程
  3. 关闭旧终端窗口，再重新打开终端和客户端
  4. 确认没有同时使用 CC-Switch 和手动配置管理同一个客户端
  5. 在你实际使用的客户端中发送一次请求，并查看使用日志 (opens in a new tab)

Codex CLI 与 Codex 桌面版共用配置；Claude Code CLI 与 Claude Desktop 是两个不同的 CC-Switch 入口。

API Connect Error、环境变量或代理冲突

旧环境变量可能覆盖 CC-Switch 写入的配置，重点检查：

  • ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN
  • OPENAI_BASE_URL、OPENAI_API_KEY
  • GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY

如果变量仍指向旧服务，请更新或移除冲突项，再打开新的终端窗口。

玖亿 API 可以直接填写 Base URL。除非你明确需要，否则保持 CC-Switch 的 本地代理 / 路由 关闭。系统代理、VPN 或其他转发工具同时工作时，也可能造成地址被改写、证书错误或连接超时。

如何根据请求日志判断问题

打开使用日志 (opens in a new tab)，找到对应请求后按下表排查。

日志情况优先检查
完全没有新日志Base URL、环境变量、代理、客户端是否已重启
400 且提示 encrypted content ... could not be verified切换分组后在目标分组下新建对话，见 Codex 加密内容校验失败
400 Bad Request先新建对话；仍失败时检查上下文长度、模型 ID、客户端版本和请求协议
401、403 或 429查看 令牌、权限与额度，并结合错误正文判断
模型不存在查看 模型与令牌分组
日志成功但客户端报错客户端版本、请求协议和客户端本地日志

不要只依赖 CC-Switch 的模型检查。你实际使用的客户端能收到回复，并且控制台出现正常请求日志，才表示配置成功。

Grok Build 与 Claude 客户端常见问题

Grok Build 通过 CC-Switch 连接失败

  1. 确认 CC-Switch 已更新到 v3.18.0 或更高版本，并在客户端入口中选择 Grok Build
  2. API Key、Grok 分组和模型 ID 以模型广场当前显示为准，Base URL 使用 https://api.9e.lv/v1
  3. 重新点击 启用，完全退出并重启 Grok Build
  4. 如果开启了 CC-Switch 本地代理，使用软件自动生成的本地路由，不要手动拼接 /grokbuild；普通直连场景可保持本地代理关闭

如果 CC-Switch 中没有 Grok Build 入口，先升级软件；仍不可用时可按 Grok Build 手动配置备用方案操作。

Claude 客户端常见问题

VS Code 中无法使用

先在 VS Code 外的终端运行 claude：

  • CLI 也失败：按本页前面的步骤检查地址、令牌、环境变量和请求日志
  • CLI 正常、VS Code 失败：更新 Claude Code CLI 和 VS Code 扩展，然后完全退出并重新打开 VS Code
  • 如果通过 code . 等方式从终端启动 VS Code，请确认该终端没有旧环境变量

仍在连接 Anthropic 官方地址

如果看到 Unable to connect to Anthropic services 或 Failed to connect to api.anthropic.com：

  1. 在 CC-Switch 的 Claude Code 入口重新启用玖亿 API 配置
  2. 确认 Base URL 是 https://api.9e.lv，不要添加 /v1
  3. 检查旧的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN
  4. 保持 CC-Switch 本地代理 / 路由关闭，并排除系统代理或 VPN 冲突
  5. 关闭全部终端和 VS Code 进程，再重新运行 claude

不要使用一行命令覆盖整个 .claude.json。需要手动配置时，请先备份现有文件，再参考 Claude Code 手动配置教程。

Claude Desktop 仍要求登录

确认 CC-Switch 选择的是 Claude Desktop，而不是 Claude Code CLI；开启“跳过初次安装确认”等桌面选项，重新启用配置后彻底退出并重启 Claude Desktop。

谨慎使用跳过权限确认

claude --dangerously-skip-permissions 会跳过文件修改和命令执行的权限确认。不要在生产环境、含敏感数据的目录或来源不明的项目中使用；日常使用应保留正常权限确认。

⚠️

仍无法定位时，请记录所用客户端、模型 ID、令牌分组、错误原文和请求日志状态码。请勿发送完整 API Key。

令牌分组介绍API 开发接入