疑难杂症

这一页汇总 Token中转站接入过程中最常见的故障与处理思路。排障时不要盲猜，优先按“配置 → 权限 → 网络 → 余额 → 会话状态”这个顺序查。

通用排查顺序

1. 先确认 Key 没过期、没禁用
2. 确认 Base URL 写对
3. 确认令牌组与当前工具匹配
4. 确认本地网络正常
5. 再看余额和模型权限
6. 最后才考虑客户端 Bug

1. Claude Code 一启动就跳登录

原因

首次初始化还在尝试走官方校验流程，或者本地 onboarding 状态没写好。

处理

• 用 CC-Switch 跳过初始化
• 或手动补 hasCompletedOnboarding: true

2. 使用中突然 400 / 会话异常

常见原因

• 当前会话状态坏了
• 上下文太重
• 客户端版本问题

处理

• 先 /clear
• 不行就新建会话
• 仍不行再考虑回退客户端版本

3. Gemini CLI 卡住不动

原因

长会话或官方适配问题比较常见。

处理

• 直接新开会话
• 或换用桌面客户端 / 插件继续任务

4. Key 无效 / 鉴权失败

先查三件事

• Key 是否复制完整
• Base URL 是否对应当前协议
• 令牌组是否正确

环境变量检查

macOS / Linux：

env | grep -E 'ANTHROPIC|OPENAI|GEMINI'

Windows PowerShell：

Get-ChildItem Env: | Where-Object { $_.Name -match 'ANTHROPIC|OPENAI|GEMINI' }

5. Request Timed Out

常见原因

• 本地网络抖动
• 代理异常
• 图像或长上下文任务本身耗时大

处理

• 先排网络
• 再缩小上下文
• 图像任务可先降到 1K / 2K 验证链路

6. 503 / 服务暂时不可用

这类问题通常不是本地配置错，而是上游或当前模型暂时不可用。

处理

• 换模型
• 换 Key / 分组
• 稍后重试
• 查看控制台公告

7. OpenClaw 报 403 blocked

通常是 Authorization 或 User-Agent 没按要求补齐。

8. 上下文越来越乱

表现

• 引用不存在的文件
• 逻辑开始跑偏
• 同一问题回答前后矛盾

处理

• 新开会话
• 缩小上下文范围
• 先总结再继续下一轮

9. npm 安装慢或失败

npm config set registry https://registry.npmmirror.com
npm config get registry

10. 想停掉自动更新

可在对应工具配置或环境变量里关闭自动更新，避免新版本突然带来行为变化。

出问题时最有价值的现场信息

• 当前模型名
• 当前 Base URL
• 当前 Key 用途
• 错误原文
• 本地系统与终端类型
• 是否刚升级过客户端