AxiomCode 文档

主题

4.2 常见错误 ​

按错误码 / 错误信息归纳，定位速度比靠经验猜要快很多。

401 Unauthorized ​

典型现象：客户端弹出"未授权 / 鉴权失败"，或者日志出现 401。

可能原因：

  • Key 写错（前后空格、漏 sk-axiom- 前缀、复制时少了几位）
  • Key 被禁用 / 已删除
  • 把 OpenAI 协议的 Key 写到了 Anthropic 字段，或者反过来（同一把 Key 两边都能用，问题不会出在这里，但写错环境变量名会）
  • 走 Anthropic 协议时，没有用 x-api-key 头而是用了 Authorization: Bearer

排查顺序：

  1. 控制台 → 密钥页 → 确认这把 Key 状态是 已启用。
  2. 复制控制台显示的 Key 前 4 位 + 后 4 位，与本地配置的前后 4 位比对。
  3. 跑一遍 4.1 自检命令 看 curl 是否返回 200。

404 Not Found ​

典型现象：返回 404 或 model not found。

  • URL 多了一层 /v1 或者少了 /v1：
    • OpenAI 协议必须带 /v1：https://axiomcode.top/v1
    • Anthropic 协议不要带 /v1：https://axiomcode.top
  • 模型 ID 拼错：例如把 claude-sonnet-4-6 写成 claude-4-sonnet。请到控制台「接入配置」复制官方 ID。
  • 模型未开通：账号没开放该模型，可以在密钥设置里调整或联系客服。

402 / 余额不足 ​

典型现象：错误信息出现 insufficient_balance、额度不足、payment required。

去 https://axiomcode.top/billing 充值即可。建议从 小店 买兑换码秒到账。

429 Too Many Requests ​

典型现象：短时间内发太多请求被限速。

  • 降低客户端的并行度。
  • Codex 一类工具不要在大文件里连续触发整页改写，先收口。
  • 极少数情况下 IP 被识别为异常流量，换个网络或者稍等几分钟再试。

5xx Server Error ​

典型现象：500 / 502 / 503 / 504。

多为后端瞬时压力 / 上游波动，重试几次基本能恢复。如果连续 10 分钟以上不稳定，反馈给客服。

网络层故障 ​

typical：Connection refused、SSL handshake failed、timeout。

  • 代理/VPN 干扰：关掉 Clash / V2Ray 等系统代理重试一次。
  • 公司防火墙：办公网常会拦截非常用域名，换个网络（手机热点）测试。
  • 时间不对：操作系统时间偏差太大会导致 TLS 握手失败，把系统时间同步到正确时区。

客户端"找不到 CLI / 找不到环境变量" ​

  • Windows 上 setx 之后没重启终端 / VSCode。
  • macOS 上把变量写在 ~/.bash_profile 但用的是 zsh，请改写到 ~/.zshrc。
  • 检查 echo $OPENAI_API_KEY、echo $ANTHROPIC_API_KEY 是否能输出预期值。

仍然解决不了？ ​

按下面格式提供信息给客服，能极大缩短定位时间：

text
- 客户端：Codex CLI v0.x.x（或者 Claude Code、OpenCode 等）
- 操作系统：Windows 11 / macOS 14 / Ubuntu 22.04
- Base URL：https://axiomcode.top/v1
- Key 前后 4 位：sk-axiom-XXXX...YYYY
- 错误信息（完整截图或复制文字）：
- 自检 curl 的返回：

Copyright © 2026 AxiomCode