故障排查
诊断命令
运行诊断检查
bash
claude /doctor检查环境变量
bash
# macOS / Linux
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
# Windows PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN常见错误及解决方案
| 错误信息 | 可能原因 | 解决方案 |
|---|---|---|
| API key is invalid | ① 密钥输入错误(多余空格) ② 密钥已过期或被重置 ③ 环境变量名称错误 | 检查密钥是否有多余空格;确认密钥是否有效;确保环境变量名称为 ANTHROPIC_AUTH_TOKEN |
| Connection refused / Network error | ① ANTHROPIC_BASE_URL 设置错误② 网络防火墙阻止连接 ③ 代理设置冲突 | 检查 BASE_URL 配置;排查防火墙规则;检查代理设置 |
| Insufficient quota | 额度不足 | 登录管理后台查看额度并充值 |
| Command not found: claude | 命令未找到 | 重新运行安装命令,或重新打开终端窗口 |
| Model not found | 模型名称错误 | 检查模型名称是否正确,确保已在后台启用该模型 |
API 连接测试
使用 curl 测试 API 连接:
bash
curl https://anyapi.pro/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"如果返回模型列表,说明连接正常。
获取更多帮助
- 查看官方文档:Claude Code 官方文档包含更多高级用法 → Anthropic Docs
- 联系管理员:如果以上方法无法解决问题,请联系管理员
