常见问题

按错误现象排查。先确认三件事再排查具体错误：

API Key 以 sk- 开头，已完整复制
余额充足
Base URL 正确（见下表）

Base URL 速查

工具类型	Base URL
Claude Code	`https://api.bestai.chat`
Codex CLI / App	`https://api.bestai.chat`
OpenAI SDK	`https://api.bestai.chat/v1`
Anthropic SDK	`https://api.bestai.chat`
其他 OpenAI 兼容工具	`https://api.bestai.chat/v1`

401 Unauthorized

认证失败。按顺序检查：

Key 是否完整——开头 sk-，没有多余空格或换行
环境变量是否生效：
- Claude Code: echo $ANTHROPIC_AUTH_TOKEN | head -c 5
- Codex: echo $CODEX_API_KEY | head -c 5
余额是否充足
是否把 BestAI Key 填到了官方 OpenAI / Anthropic 的配置里（地址不对）

404 Not Found

Base URL 填错。常见错误：

text

# 错误写法
https://api.bestai.chat/v1/chat/completions  ← 不要填完整 endpoint
https://api.bestai.chat/v1/messages          ← 不要填完整 endpoint
https://api.bestai.chat/codex/v1             ← 旧地址，BestAI 不用子路径

# 正确写法
https://api.bestai.chat      ← Claude Code / Anthropic SDK / Codex
https://api.bestai.chat/v1   ← OpenAI SDK / OpenAI 兼容工具

Base URL 字段只填基础地址，SDK 会自动拼接后续路径。

有回复但余额没有记录

请求没走 BestAI。检查：

工具里是否选中了 BestAI 的 provider / profile
是否有多个同名配置，实际走了另一个
Claude Code: 运行 echo $ANTHROPIC_BASE_URL 确认值是 https://api.bestai.chat
Codex: 检查 config.toml 中 model_provider 是否指向 bestai

模型列表为空

不影响使用。手动填写模型 ID 即可：

gpt-5.5
claude-sonnet-4
claude-opus-4
o3

可用模型以模型价格页为准。

502 / 503

上游临时异常。处理方式：

等 1-2 分钟后重试
切换到另一个模型试试
持续复现时，记录时间和错误文本，提交工单

重启终端后配置失效

export 命令只对当前终端窗口有效。长期使用需要写入 shell 配置文件：

bash

# ~/.zshrc 或 ~/.bashrc 末尾添加
export ANTHROPIC_BASE_URL="https://api.bestai.chat"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

或使用 ~/.claude/settings.json 的 env 字段（见 Claude Code 接入指南）。

Codex App 读不到环境变量

从桌面图标启动的 App 不继承 shell 环境变量。解决方案：

从终端启动：codex app
或确认 ~/.codex-gac/config.toml 配置正确

验证方法

发送验证句：

请只回复：BestAI 已连接。

接入成功 = 收到回复 + 余额页面出现请求记录。两者缺一不可。

curl 快速测试

如果工具内失败，用 curl 排除是服务端还是配置问题：

bash

curl https://api.bestai.chat/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'

curl 结果	说明
成功返回	服务端正常，检查工具配置
401	Key 或余额问题
404	URL 填错
502/503	服务端临时异常，稍后重试

常见问题 ​

Base URL 速查 ​

401 Unauthorized ​

404 Not Found ​

有回复但余额没有记录 ​

模型列表为空 ​

502 / 503 ​

重启终端后配置失效 ​

Codex App 读不到环境变量 ​

验证方法 ​

curl 快速测试 ​