常见问题

遇到问题时，先按现象找。不要一上来就重装；很多问题只是 Key、线路或进程没重启。

先做三步快速排查

01确认 Key

重新从控制台复制 API Key，确认没有多余空格，也没有复制到旧 Key。

02确认线路

重新复制 Base URL 测试。当前默认线路是 https://hk.getelucid.com。

03重启工具

完全关闭 Claude Code / Codex 和终端，再重新打开，不要只关闭窗口。

配置不生效

现象	可能原因	处理方式
保存后仍然走默认配置	工具没完全退出	关闭终端和后台进程后重开
Claude Code 认证失败	Key 错或字段写错	检查 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL
Codex 认证失败	环境变量或配置文件未生效	检查 ELUCID_RELAY_API_KEY 和 ~/.codex/config.toml
连接失败	Base URL 错或线路不可用	回控制台复制当前可用地址
修改了但没变化	改错配置文件	回到手动配置页确认路径

关于模型与费用

我选了高阶模型，为什么有时显示轻量模型？

CLI 工具处理一些小任务时，可能自动使用更轻量的模型，例如生成标题、处理辅助信息或压缩摘要。正式问答和代码任务仍应按你的主要模型策略运行。

什么是缓存？

缓存是 API 用来降低重复上下文成本的机制。长对话里，历史上下文如果命中缓存，读取成本通常更低。

简单理解：

• 写缓存：首次把上下文写入服务端缓存。
• 读缓存：后续请求复用缓存内容，费用更低。

Elucid Relay 的具体缓存计费以控制台账单显示为准。

为什么缓存有时突然消失？

常见原因有两个：

1. 对话太长，触发上下文压缩，缓存需要重新建立。
2. 空闲时间太久，服务端缓存过期。

这属于正常现象，不代表配置坏了。

关于服务可用性

Relay 为什么有时多个渠道同时不可用？

Relay 依赖上游模型服务。如果上游官方服务故障、限制、区域策略变化或账号池触发风控，可能导致多个渠道同时不可用。

可以先做这些事：

1. 等几分钟后重试。
2. 换一条 Base URL。
3. 查看控制台公告或状态页。
4. 如果余额、Key、线路都正常，再提交报错截图。

临时兼容问题

Codex 或 Claude Code 新版本突然不兼容怎么办？

CLI 版本、模型路由和上游协议都有时效性。如果某个版本出现兼容问题，先看公告，不要盲目长期固定旧版本。

临时降级示例：

npm install -g @anthropic-ai/claude-code@2.1.133

恢复正常后，再升级回最新版：

npm install -g @anthropic-ai/claude-code

Codex 也同理：

npm install -g @openai/codex

不要长期固定旧版本

兼容问题修复后应回到最新版，避免旧版本带来新的安全、协议或功能问题。

还是解决不了

提交问题时，带上下面信息：

• 你的系统：Windows、macOS、Linux。
• 使用工具：Claude Code、Codex，还是两个都用。
• 配置方式：一键安装、ccswitch，还是手动配置。
• 报错截图：尽量包含最后 20 行终端输出。
• 是否换过线路：例如主线路、Cloudflare、美国线路。
• 是否重新打开过终端和 CLI。