故障排查

遇到问题时，不要同时改很多项。先用 curl 验证账号和 Key，再排查客户端。

快速自检

先运行：

curl https://0x1c.io/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果这个请求失败，问题在账号、Key、网络或 0x1c 服务可用性。客户端配置先不要动。

如果这个请求成功，再测试模型：

curl https://0x1c.io/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "ping"
      }
    ]
  }'

错误码

401 Unauthorized

重点检查：

• Key 是否来自 0x1c 控制台。
• 是否把 sk-... 复制完整。
• Authorization 是否写成 Bearer YOUR_API_KEY。
• Bearer 和 Key 中间是否有空格。
• Key 前后是否多了引号或空格。

404 Not Found

最常见原因是 Base URL 填错。

客户端里应该填：

https://0x1c.io/v1

不要填：

https://0x1c.io/v1/chat/completions

Claude Code 这类 Anthropic 客户端通常填：

https://0x1c.io

429 Too Many Requests

这通常不是 Key 错，而是请求太密集。

处理方式：

• 降低并发。
• 减少自动重试次数。
• 给重试加指数退避。
• 换一个限速更高或更轻量的模型。
• 检查 agent 是否进入循环。

模型不存在

如果看到：

model_not_found

处理方式：

1. 打开控制台模型列表。
2. 复制完整模型 ID。
3. 确认当前账号能使用该模型。
4. 用 /v1/models 验证列表里是否存在。

客户端配置不生效

常见原因：

• GUI 设置和配置文件不是同一个入口。
• 终端没有重新打开，环境变量没生效。
• 工具读取的是 OPENAI_API_KEY，你设置的是 OX1C_API_KEY。
• 配置文件路径不对。
• 工具仍然使用官方 provider。

排查方式：

1. 打印环境变量。
2. 查看客户端启动日志。
3. 临时改成一个明显错误的 Base URL，看错误是否变化。
4. 如果错误不变，说明配置没有被读取。