疑难杂症排查

本指南汇总 Claude Code、CodeX 和 Gemini CLI 使用过程中的常见问题及解决方案。

服务状态

遇到问题时，请先检查服务状态：https://status.codekey.cc/status/api

快速诊断清单

1. 检查 服务状态页面
2. 验证环境变量配置
3. 确认令牌有效性
4. 测试网络/代理连接
5. 检查令牌余额
6. 重启会话

---

Claude Code 问题

问题 1：登录循环

解决方案：

• 参考官方教程
• 修改 settings.json，添加 API 配置和认证令牌

问题 2：使用中出现 400 错误

原因： 会话状态异常

修复方法：

• 使用 /clear 命令清除会话（会丢失历史记录）
• 高级恢复：直接访问 .claude/history 文件

问题 6：提示令牌无效

验证 Group Token 配置：

# Windows
echo $env:ANTHROPIC_AUTH_TOKEN

# macOS/Linux
echo $ANTHROPIC_AUTH_TOKEN

问题 7：API 连接错误

• 检查网络连接
• 确认代理稳定性
• 尝试直连

问题 8：上下文过大

使用 /context 监控 Token 用量，可考虑禁用 Auto Compress。

问题 9-10：超时和 503 错误

• 验证网络连接
• 检查代理状态
• 确认服务可用性

---

Gemini CLI 问题

问题 3：Gemini CLI 卡死

原因： 官方长时间使用后的适配问题

替代方案： 使用 VS Code 插件如 RooCode 或 Kilo

问题 11：Gemini CLI 400 错误

重启会话通常可以解决。

问题 12：内容分割问题

可能与模型版本相关，尝试更新或回退版本。

问题 13：自动更新问题

禁用自动更新：

export DISABLE_AUTOUPDATER=true

或回退到稳定版本：

npm install -g @google/gemini-cli@2.0.72

---

通用问题

问题 4：Token 消耗过快

RooCode 和 Kilo 有较大的内置提示词，会快速消耗 Token，这是设计特性。

问题 5：模型性能差异

模型	特点
Gemini	擅长 Web 前端开发
Claude Opus	代码质量更高
CodeX	速度较慢（Codex Max 除外）

---

联系支持

如果以上方案无法解决您的问题：

• Telegram 群组：https://t.me/codekey
• 查看 常见问题 FAQ
• 联系 售前售后