常见问题
遇到问题时，先按现象找。不要一上来就重装；很多问题只是 Key、线路或进程没重启。
先做三步快速排查
01确认 Key
重新从后台复制 API Key，确认没有多余空格，也没有复制到旧 Key。
02确认线路
优先换一条 Base URL 测试，确认 Base URL 填写正确。
03重启工具
完全关闭 Claude Code / Codex 和终端，再重新打开，不要只关闭窗口。
配置不生效
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 保存后仍然走默认配置 | 工具没完全退出 | 关闭终端和后台进程后重开 |
| Claude Code 认证失败 | Key 错或写错字段 | 检查 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL |
| Codex 认证失败 | auth.json 路径写错或 Key 错 | 检查用户目录下的 .codex/auth.json |
| 连接失败 | Base URL 错或线路不可用 | 换线路，确认 URL 是否需要 /v1 |
| 修改了但没变化 | 改错配置文件 | 回到手动配置页确认路径 |
关于模型与费用
我选了 Opus，为什么有时显示 Haiku？
Claude Code 处理一些小任务时可能自动使用更轻量的模型，例如生成标题、处理辅助信息等。正式问答和代码任务仍会按你的主要模型策略运行。
什么是缓存？
缓存是官方 API 用来降低重复上下文成本的机制。长对话里，历史上下文如果命中缓存，读取成本会更低。
简单理解：
- 写缓存：首次把上下文写入服务端缓存。
- 读缓存：后续请求复用缓存内容，费用更低。
中转站的具体缓存计费以后台显示为准。
为什么缓存有时突然消失？
常见原因有两个：
- 对话太长，触发上下文压缩，缓存需要重新建立。
- 空闲时间太久，服务端缓存过期。
这属于正常现象，不代表配置坏了。
关于服务可用性
中转站为什么有时全部不可用？
中转站依赖上游官方 API。如果官方服务故障、限制或策略变动，可能导致多个渠道同时不可用。
可以先做这些事：
- 等几分钟后重试。
- 换一条 Base URL。
- 关注中转站公告或 QQ 群消息。
临时兼容问题
max 分组提示 Claude Code 版本兼容问题怎么办？
以下处理方式只适用于“max 分组仍然存在 Claude Code 版本兼容问题”的阶段。这个问题具有时效性，执行前建议先看群公告确认是否仍需要降级。
临时降级命令：
bash
npm install -g @anthropic-ai/[email protected]恢复正常后，再升级回最新版：
bash
npm install -g @anthropic-ai/claude-code不要长期固定旧版本
如果兼容问题已经修复，应回到最新版 Claude Code，避免旧版本带来新的兼容或功能问题。
还是解决不了
把下面信息发到 QQ 群，排查会快很多：
- 你的系统：Windows 或 macOS。
- 使用工具：Claude Code、Codex，还是两个都用。
- 配置方式：C+、ccswitch，还是手动配置。
- 报错截图：尽量包含最后 20 行终端输出。
- 使用的 Base URL 地址。