AxiomCode 文档

主题

4.1 自检命令 ​

把客户端排错的"信号"从客户端剥离出来，直接用 curl 跟 AxiomCode 通信，能在 30 秒内判断到底是 Key/URL 错 还是 客户端配置错。

一、OpenAI 协议自检（Codex / OpenCode 等） ​

打开终端，把下面这段中的 你的Key 替换成实际值，整段粘贴进去运行：

bash
curl https://axiomcode.top/v1/chat/completions \
  -H "Authorization: Bearer sk-axiom-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-codex",
    "messages": [{"role": "user", "content": "ping"}]
  }'

Windows PowerShell 版本：

powershell
curl https://axiomcode.top/v1/chat/completions `
  -H "Authorization: Bearer sk-axiom-你的Key" `
  -H "Content-Type: application/json" `
  -d '{ "model": "gpt-5-codex", "messages": [{"role":"user","content":"ping"}] }'

成功 时会返回类似：

json
{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "choices": [{ "message": { "role": "assistant", "content": "pong" } }]
}

二、Anthropic 协议自检（Claude Code / OpenClaw 等） ​

bash
curl https://axiomcode.top/v1/messages \
  -H "x-api-key: sk-axiom-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "ping"}]
  }'

成功会返回包含 content 字段的 JSON。

三、如何用自检结果判断问题 ​

curl 结果含义下一步
200 OK，返回 JSON后端通的，Key 正确问题在客户端配置：检查环境变量 / 配置文件
401 UnauthorizedKey 错误 / 已禁用回控制台核对 Key，必要时新建一把
402 / 余额不足账户没钱了去 充值页 加额度
404 Not FoundBase URL 错 / 模型 ID 错检查 URL 是否多/少了 /v1，模型名是否正确
429 Too Many Requests速率受限降低并发或稍后重试
5xx后端临时异常稍等几分钟重试，仍持续可联系客服
网络超时DNS / 出口 / 防火墙换网络试试，关闭代理/VPN 重试

四、给 curl 加详细日志 ​

如果你怀疑是请求被代理改写了，可以加 -v 打印完整请求/响应头：

bash
curl -v https://axiomcode.top/v1/chat/completions ...

观察输出里实际请求的目标 IP / Host / Authorization 头是否符合预期。

下一节给出 常见错误码与原因对照表：4.2 常见错误

Copyright © 2026 AxiomCode