疑难杂症排查指南

本文汇总 Claude Code、CodeX、Gemini CLI 的常见报错与处理方式。

先看服务状态

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

• https://callxyq.xyz

---

1) Claude Code 启动反复跳登录

现象

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

处理

• 参考：https://www.cnblogs.com/gordonMlxg/articles/19103691
• 或在 settings.json 中加入：

{
  "apiKeyHelper": "echo 'xxx'",
  "env": {
    "ANTHROPIC_BASE_URL": "xxx",
    "ANTHROPIC_AUTH_TOKEN": "xxx"
  }
}

---

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"
  }
}

或设置环境变量：

export DISABLE_AUTOUPDATER=1

$Env:DISABLE_AUTOUPDATER = "1"

---

快速诊断流程

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

常用命令：

/status
/context
/clear

仍未解决：

• 售前售后
• 常见问题