中转 API
常见问题

常见问题

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

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

先做基础检查

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

出现 401、403 或额度不足

提示优先检查
401 UnauthorizedAPI Key 是否完整、有效，并已写入当前启用的客户端入口
403 Forbidden账户余额、令牌额度、过期时间和模型分组权限
额度不足账户余额，以及令牌是否设置了单独的额度上限

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

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

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

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

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

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. 在你实际使用的客户端中发送一次请求，并查看请求日志

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

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

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

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

日志情况优先检查
完全没有新日志Base URL、环境变量、代理、客户端是否已重启
400 Bad Request先新建对话；仍失败时检查上下文长度、模型 ID、客户端版本和请求协议
401 或 403查看 令牌、权限与额度
模型不存在查看 模型与令牌分组
日志成功但客户端报错客户端版本、请求协议和客户端本地日志

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

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 入口重新启用玖亿AI 配置
  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。

令牌分组介绍