遇到问题怎么办

先到这里找。

中转站只转发你的请求。它不在你的电脑上开终端，不读你的文件，也不替你推 Git。终端、读文件、跑命令，都是 Codex、Claude Code 这类客户端自己登记的工具。模型回了话，只说明这一次调用通了。

下面每一节末尾是你自己能做的一步。Key 只用假值 sk-xxxx。不要把真 Key 贴进聊天、截图或工单。

Base URL 写错

Codex 和其它 OpenAI 兼容客户端，Base URL 写到 /v1，也就是 https://api.cloudborne.cn/v1。不要写成裸域名 https://api.cloudborne.cn。末尾也不要多一个斜杠。

Claude Code 用源站，不带 /v1。它读的是 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，不是上面那条 OpenAI 地址。

不带 Key 去打开 https://api.cloudborne.cn/v1/models，会得到 401。这是预期的。它只说明这条地址活着，并且在要凭证。

401、403、余额

先看状态码，再改配置。

401：Key 错了、停用了，或者一个旧进程还拿着旧 Key。到密钥页核对当前 Key，换上之后完全退出客户端再开。
403：余额、分组，或这个 Key 不允许调用该模型。余额为 0 时调用会被直接挡住。
Key 只显示一次。关掉创建弹窗之后看不到完整值。丢了不能找回，停用旧的，再建一把。
Key 泄露了也一样：先停用，再建新的，更新客户端，删掉公开位置里的那串。删不掉就当已经泄露，不要继续用旧的。

截图和工单里只出现 sk-xxxx。遮住邮箱、余额和 Key。

有回复，但没有终端

模型回了话。你让它跑 Get-Location，它列出自己看得到的工具，然后拒绝假装执行。列表里是这类名字：functions.functions__request_user_input_async、functions.clock__sleep、functions.collaboration__send_message。于是它也推不了 GitLab，改不了文件。

这些名字是客户端带上来的协作工具，不是终端。request_user_input_async 只是向你提一个问题。中转站不会往这个列表里补上 exec，也不会替你读盘。

你要做的：

完全退出 Codex Desktop 或 CLI。关掉窗口不够，进程还在就会沿用旧的工具登记。
再开一个新任务，不要复用刚才那个。
看新的工具列表里有没有 exec。

重启之后仍然没有 exec，就是这个客户端没有登记终端和读文件。换一个会登记这些工具的客户端，或在那个客户端里把工具打开。中转站转发它收到的工具列表，不负责补上你电脑上的能力。

协议不匹配

Responses 和 Chat Completions 是两条路，不能混用。

Codex 走 Responses：https://api.cloudborne.cn/v1，格式选 Responses。

DeepSeek 分组接 Claude Code 时走 Chat Completions。Claude Code 里的 Sonnet、Opus、Haiku 是本地档位，不是上游的模型 ID。这个分组可以先这样映射：

Claude Code 档位	模型 ID
Sonnet	`deepseek-v4-flash`
Opus	`deepseek-v4-pro`
Haiku	`deepseek-v4-flash`

分组如果只支持 DeepSeek，不要把这三档指到别的厂商，除非你已经在这个分组里打通了那些模型。

HTTP 200，但用量页是 0 token、0 费用，或者流式停在失败上：按协议错了处理。换成上表对应的格式，做一次很短的调用，再看用量页有没有一条非零记录。

Grok CLI 要写明 api_backend = "responses"。不写的话，它默认打到 /v1/chat/completions。

换了配置没生效

CC Switch 切到 Cloudborne 之后，Codex 不会自己捡起新配置。

确认当前激活的 Provider 是 Cloudborne，目标应用是 Codex。
关掉当前 Codex 会话。
重开终端，再启动 Codex。

预览里的 base_url 应是 https://api.cloudborne.cn/v1。

Claude Code 会热加载，是例外，一般不用为了换 Key 重启。其它客户端要重启。

模型名以中转站控制台或 CC Switch 的 Fetch Models 为准。别的教程里的模型 ID 不能直接抄过来。

思考字段报错

报错里出现 reasoning_content，常见两种：

带工具的思考回合里，下一条消息缺了这个字段，上游返回 400。
用 OpenAI 格式去接一个要求思考字段的上游，字段对不上。

先确认客户端选的格式和这个分组是同一条协议。DeepSeek 分组配 Claude Code，回到上一节的 Chat Completions 和三档映射。不要在同一把 Key 上混用两种格式再重试。

首字很慢、502、过载

先分开三件事。

模型突然不可用，先看对应厂商的官方状态页，再改 Base URL 或 Key。

OpenAI Status
Claude Status
xAI Status
DeepSeek Status
Kimi Status
MiniMax Status
首字要等很久，或 502 timeout awaiting response headers：请求已经发出，卡在上游响应。换一次很短的调用。短调用也这样，而协议和模型名是对的，就不是 Base URL 的问题。
overloaded / 服务器过载：上游在拒绝新请求。等一等再试，不要连着重发同一条长请求。
公开首页打得开，客户端打不开：先查本机代理、VPN 和公司网络。浏览器打开 https://api.cloudborne.cn/。首页通、调用不通，回到 Base URL 和 Key。

用量是 0 的成功响应，按「协议不匹配」处理，不要当成超时。

联网搜索 404

Codex 自带的联网搜索会去打 POST /v1/alpha/search 这类路径。中转站没有这条路由，所以返回 404。这不是 Key 坏了，也不是余额不够。

对话和补全仍走 /v1。把搜索当成客户端自己的功能：这个中转站不提供那条搜索地址。