故障排查

按工具和症状分组的排查指南。遇到问题先走一遍本页，大部分场景可以自助解决。

先做三件事

不管是什么症状，排查前先确认这三项：

1. Key 是否有效：登录 https://aitongdao.com，在令牌页看这把 Key 是否启用、是否过期、额度是否用光。
2. Base URL 是否对：AI 调用统一走 ai. 子域 —— Anthropic 系工具填 https://ai.aitongdao.com，OpenAI 系填 https://ai.aitongdao.com/v1，Gemini 填 https://ai.aitongdao.com。
3. 网络连通性：在终端 curl -I https://ai.aitongdao.com/v1/models 看是否能返回 401（Invalid token 代表鉴权链路通）。

Claude Code 常见问题

一直弹登录页/请求走到了 Anthropic 官方

原因：环境变量没配置，Claude Code 按默认配置走官方地址。

检查环境变量：

# macOS/Linux
echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_AUTH_TOKEN"

# Windows PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

如果打印为空，说明没设置成功。按你的平台重新配置：

• macOS/Linux：写入 ~/.zshrc 或 ~/.bashrc：

  export ANTHROPIC_BASE_URL="https://ai.aitongdao.com"
  export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxx"

  然后 source ~/.zshrc，重启终端。

• Windows：在系统环境变量里添加 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，然后重启终端。

报 400 "会话异常" 或对话错乱

先清空会话：

/clear

然后重新开始一轮对话。如果仍然 400，检查你选的模型是否在当前分组下可用。

Codex 常见问题

配置写了但没生效

Codex 的配置文件路径：

• macOS/Linux：~/.codex/config.toml
• Windows：%USERPROFILE%\.codex\config.toml

检查配置里 base_url 是否是 https://ai.aitongdao.com/v1，以及 auth.json 里的 key 是否正确。配置写错不会自动报错，会静默走默认地址。

修改后记得重启 Codex 进程，让它重新加载配置。

Gemini CLI 常见问题

安装后找不到 gemini 命令

原因：npm 的全局 bin 目录没加到 PATH。

npm root -g   # 查看全局安装目录

把对应的 bin 目录加进 PATH，或者重新全局安装：

npm install -g @google/generative-ai-cli

配置了 Key 仍然提示登录

Gemini CLI 的环境变量写在这里：

• macOS/Linux：~/.gemini/.env
• Windows：%USERPROFILE%\.gemini\.env

确认文件里的 GEMINI_API_KEY 和 GEMINI_BASE_URL 正确。注意 Gemini 协议的 Base URL 是 https://ai.aitongdao.com（不带 /v1）。

OpenCode 常见问题

启动时报找不到 SDK

OpenCode 依赖 @ai-sdk/anthropic，缺失时手动安装：

npm install @ai-sdk/anthropic

如果是全局场景，加 -g。

配置文件 JSON 格式错误

OpenCode 的配置在 ~/.config/opencode（Windows 在 $env:USERPROFILE\.config\opencode）。JSON 对格式很严格，常见错误：

• 最后一个键值对后多了逗号
• 字符串用了单引号
• 注释行没删干净

用 JSON 校验工具（比如 jq . config.json）确认格式没问题。

OpenClaw 常见问题

doctor 提示 provider / api 配置不对

OpenClaw 的配置里 provider 要填 anthropic，api 对应 Base URL 要填 https://ai.aitongdao.com。如果填了其他值或者少了协议前缀，doctor 命令就会报这个错。

常见错误码

状态码	含义	处理
401	Key 无效/过期/被禁用	去后台令牌页检查，必要时新建
403	分组不允许调用该模型	换一把对应分组的 Key
404	路径或模型名错误	确认 Base URL 和 model 字段
429	触发限流	降低并发，加退避重试
500	上游或网关异常	稍后重试；持续出现请联系客服

仍然没解决？

• 复查本页的"先做三件事"。
• 查看后台日志页，看那次失败的请求有没有记录、错误信息是什么。
• 把错误截图、请求体、时间点等信息发给客服，见获取支持。