常见问题

OpenAI 与 Anthropic 的 Base URL 有什么区别？

• OpenAI 兼容客户端：https://yunshuapi.org/v1
• Claude Code 或 Anthropic 兼容客户端：https://yunshuapi.org

Claude Code 会自行追加 /v1/messages，所以它的 Base URL 不要再填写 /v1。

为什么提示未授权？

依次检查：

1. 令牌是否完整，前后是否多了空格或引号。
2. 令牌是否已启用、过期或被删除。
3. OpenAI 请求是否使用 Authorization: Bearer ...。
4. Anthropic 请求是否使用 x-api-key 和 anthropic-version。
5. 客户端进程是否在设置环境变量之前就已启动。

为什么提示模型不存在或无权限？

客户端里的模型名称必须与模型广场或 /v1/models 返回的模型 ID 完全一致。还要确认令牌的模型范围和分组允许使用该模型。

为什么地址变成了 /v1/v1？

部分客户端会自动拼接 /v1。如果日志中出现 /v1/v1/chat/completions，请把客户端中的地址改为 https://yunshuapi.org；如果客户端要求填写完整 OpenAI Base URL，则使用 https://yunshuapi.org/v1。以客户端最终发出的请求地址为准。

环境变量已经设置，客户端仍然读取不到？

环境变量只会被新启动的进程读取。完全退出终端、IDE 或客户端后重新打开。Windows 使用图形界面启动 IDE 时，应设置用户级环境变量，而不只是 PowerShell 当前会话变量。

请求返回 429 怎么办？

检查账户余额、令牌额度和令牌速率限制。并发任务应使用指数退避重试，避免立即无限重发。

Codex 无法使用自定义提供商怎么办？

确认配置写在用户级 ~/.codex/config.toml，而不是项目内的 .codex/config.toml。然后检查 model_provider 名称是否与 [model_providers.yunshu] 一致，并重启 Codex。

令牌泄露了怎么办？

立即在访问令牌页面禁用或删除旧令牌，创建新令牌，并更新所有使用旧令牌的客户端。仅从代码仓库删除令牌并不能阻止它继续被使用；如果曾提交到 Git，还需要清理历史记录。

如何提交有效的问题信息？

请提供以下内容：

• 发生时间和时区
• 使用的客户端及版本
• Base URL 与请求端点
• 模型 ID 和 HTTP 状态码
• 脱敏后的错误信息

不要提供完整 API Key、密码或包含凭据的配置文件。