疑难杂症排查指南 支持

本文档汇总了 Claude Code、CodeX、Gemini CLI 等 AI 编程工具的常见问题和解决方案。

🔍 服务状态查看

在排查问题前，建议先查看服务状态：

• 访问 CC Code 官网 查看最新公告

---

一、Claude Code 启动时跳登录

问题描述

启动 Claude Code 时，反复弹出登录界面。

解决方案

在 Claude Code 的 settings.json 文件中添加以下配置：

{
  "apiKeyHelper": "echo 'xxx'",
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.cccode.org",
    "ANTHROPIC_AUTH_TOKEN": "您的CC Code Key"
  }
}

将 xxx 替换为您的实际配置信息。

---

二、使用过程中出现 400 报错

问题原因

这是 Claude Code 的已知问题，通常是会话状态异常导致。

解决方式

方法一：清空会话重启

使用 /clear 命令重新开启会话。

⚠️ 注意

原会话内容会丢失。

方法二：进阶恢复方案（保留历史记录）

进入 .claude 目录，找到 history 文件，直接让 Claude Code 读取该文件。

使用 /status 可查看当前对话的 ID，Claude Code 会根据 ID 自动查找对应的会话数据。

---

三、Gemini CLI 使用一段时间后卡住/停止响应

问题原因

Gemini CLI 官方适配存在问题，长时间使用后可能出现无响应。

解决方案

改用 VS Code 插件替代 CLI：

• RooCode
• Kilo

这些插件提供了更稳定的 Gemini 使用体验。

---

四、使用 Kilo/Roo 时 Token 消耗过快

原因分析

• Roo 和 Kilo 内置 Prompt 非常大
• 插件的模式设计本身不太考虑 Token 成本

这是这些插件的固有特性，建议根据使用需求选择合适的工具。

---

五、遇到「令牌无效」问题

Windows 系统检查方法

PowerShell 命令检查：

$Env:ANTHROPIC_AUTH_TOKEN
$Env:ANTHROPIC_BASE_URL

图形界面设置：右键「此电脑」→ 属性 → 高级系统设置 → 环境变量，查找 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。

macOS 系统检查方法

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

若无输出，说明当前会话未加载该变量。

---

六、API Connect Error 排查

排查方向

1. 本地网络异常：检查网络连接是否正常，尝试访问其他网站验证
2. 网络代理/梯子不稳定：检查代理配置，尝试切换代理节点

建议

尝试直接使用直连网络，关闭代理后测试是否恢复正常。

---

七、Claude Code 上下文过大导致异常

解决方案

1. 新建会话：开启新的对话，清空上下文
2. 查看 Token 分布：使用 /context 查看当前上下文的 Token 使用情况
3. 关闭自动压缩：关闭 Auto Compress（自动压缩）功能，手动控制上下文大小

---

八、Request Timed Out（请求超时）

可能原因

• 本地网络连接问题
• 代理或梯子状态不稳定
• 服务端负载过高

解决方案

1. 检查本地网络连接
2. 检查代理或梯子状态
3. 必要时尝试直连网络
4. 查看 CC Code 官网确认服务可用性

---

九、API Error 503

错误说明

当前分组服务不可用。

解决方案

• 切换至其他可用服务分组
• 通过 CC Code 官网确认分组状态