疑难杂症排查指南

排查问题前，请先按顺序检查以下 6 点。

先看服务状态

排查前先确认服务是否可用：

• 控制台首页：https://api.nassaapi.xyz

1) Claude Code 启动反复跳登录

现象

启动后不断进入登录流程。

处理

在 ~/.claude/settings.json 中加入：

{
  "apiKeyHelper": "echo 'sk-你的Key'",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nassaapi.xyz",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

2) 使用中出现 400 报错

多见于会话状态异常。

• 快速处理：/clear 重新开会话（会丢失当前上下文）
• 进阶处理：读取 .claude/history 做会话恢复
• 辅助命令：/status 查看当前对话 ID

3) Gemini CLI 长时间后卡住

可尝试改用 VS Code 插件：

• RooCode
• Kilo

4) Kilo / Roo Token 消耗快

这通常是插件内置 Prompt 体积较大导致，不一定是你配置错误。

5) 令牌无效

先确认分组与变量设置正确。

Windows 检查

$Env:ANTHROPIC_AUTH_TOKEN
$Env:ANTHROPIC_BASE_URL

macOS / Linux 检查

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

6) API Connect Error

重点排查：

1. 本地网络
2. 代理 / 梯子稳定性

建议尝试直连网络复测。

7) 上下文过大异常

• 新开会话
• 用 /context 看 token 分布
• 关闭自动压缩，手控上下文规模

8) Request Timed Out

可能原因：

• 网络抖动
• 代理不稳定
• 服务端繁忙

建议结合状态页与网络排查。

9) API Error 503

常见于当前分组不可用：

• 切换分组
• 查看状态页确认恢复时间

10) Gemini CLI 400

通常会话异常，直接重开会话可恢复。

11) Claude Code 2.0.73 内容割裂

可临时回退版本：

npm install -g @anthropic-ai/[email protected]

12) 关闭 Claude Code 自动更新

在 settings.json 中加入：

{ "env": { "DISABLE_AUTOUPDATER": "1" } }

或设置环境变量：

macOS / Linux

export DISABLE_AUTOUPDATER=1

Windows PowerShell

$Env:DISABLE_AUTOUPDATER = "1"

常见 HTTP 错误码

HTTP	错误码	含义	解决方案
401	invalid_api_key	Key 无效或已删除	检查 Key 是否复制完整，或前往控制台重新生成
403	forbidden_model	该 Key 无权调用该模型	前往 修改令牌设置 放开模型白名单
429	rate_limit_exceeded	超过速率限制	降低并发 / 稍后重试 / 申请提额
402	insufficient_quota	余额不足	前往 充值
500	upstream_error	上游官方服务异常	稍后重试；若长时间异常请联系 售前售后

连接不稳定 / 响应很慢

• 切换网络（WiFi / 移动数据）对比
• 使用 Hapi 进阶：优选 IP 固定到优质节点
• 检查 DNS，推荐 1.1.1.1 / 223.5.5.5
• 模型 opus 系列天然比 haiku 慢，按需切换

快速诊断流程

1. 看状态页
2. 检查环境变量
3. 检查 Key 有效性与分组
4. 排查网络 / 代理
5. 查看余额
6. 重开会话

常用命令：

/status     # 查看当前对话状态
/context    # 查看 token 分布
/clear      # 清空会话重开

仍未解决？

• 售前售后 — 联系人工支持
• 常见问题 (FAQ) — 查阅高频问题