WHY CC SWITCH
先用 CC Switch，
把接入变成可管理的流程。
CC Switch 不是模型，也不会代替 EVORA。它是电脑上的配置和路由工具，负责把 EVORA 的 API 地址、密钥和模型正确交给不同 Agent。
为什么推荐使用
同一把 EVORA 密钥可以在图形界面中管理，避免改错 JSON、TOML 或环境变量。
Codex、Claude Code 等工具的配置文件不同，CC Switch 会按目标程序管理配置。Hermes 使用独立教程。
对于接口格式不同的工具，可通过 CC Switch 本地路由进行协议转换和模型映射。
可以分清是密钥、模型、端点还是本地代理出现问题。
可以在官方登录和 EVORA 之间切换，不需要每次重新填写密钥。
CC Switch 支持配置导入、导出和备份，换电脑时更容易恢复。
什么时候最需要 CC Switch？
同一台电脑同时使用 Codex、Claude Code、Hermes，或者目标程序不支持直接填写 OpenAI 格式接口时。
同一台电脑同时使用 Codex、Claude Code、Hermes，或者目标程序不支持直接填写 OpenAI 格式接口时。
支持的目标程序
Codex、Claude Code、Claude Desktop、Gemini CLI、OpenCode、OpenClaw 和 Hermes 都能使用 EVORA，但各程序的配置方式不同。请在 EVORA 快捷接入中选择真正要使用的程序。
先处理网络代理
- 先开启电脑上的 VPN 或代理软件。
- 打开 CC Switch 的“设置 → 代理”。
- 点击扫描本地代理，选择检测成功的地址。
- 测试通过后设为 CC Switch 全局出站代理。
- Codex、Claude Code、Gemini CLI 再开启对应的本地代理接管。
为什么多这一步？
系统代理开启，不代表每个命令行程序都会自动使用。CC Switch 的全局出站代理负责让它自己的请求走通；Hermes 等直连程序仍需单独配置代理。
系统代理开启，不代表每个命令行程序都会自动使用。CC Switch 的全局出站代理负责让它自己的请求走通；Hermes 等直连程序仍需单独配置代理。
导入步骤
- 进入 EVORA 控制台，创建 API Key 并确认模型。
- 选择 Codex、Claude Code、OpenCode 或 OpenClaw，点击“导入到 CC Switch”，自动传入地址、模型和完整密钥。
- 允许浏览器打开 CC Switch，在导入窗口确认地址和模型。
- 密钥显示为星号是正常保护。点击确认导入；如果提示缺少 API Key，请刷新网站后重新导入，不能用密钥列表中的隐藏预览值。
- 启用 EVORA，重新打开目标程序。
- 网页“检测密钥和模型”只检查模型列表；“测试实际对话”会发送短消息并消耗少量能量。最后在目标程序发送一句问题，验证本地配置。
含密钥的导入链接可能被浏览器或本机记录，请仅在自己的电脑使用。Hermes 使用独立配置，不支持通过此协议导入 CC Switch。
Gemini CLI 与 Claude Desktop
这两个程序需要在 CC Switch 中启用对应的本地路由和模型映射。不要直接复制 Codex 配置。配置后需要保持 CC Switch 运行，并重启目标程序。
API 地址
https://evora.work/v1不要把 http://127.0.0.1 发给客户，这个地址只代表客户自己的电脑。
常见错误
401：密钥错误、被删除或没有正确写入。402：账户能量不足，需充值或兑换。403：该密钥绑定了其他模型；需要创建“不限模型”密钥，或让客户端使用绑定模型。429：短时间请求过多，稍后重试。- 一直思考：先测试代理，再检查 CC Switch 是否运行、目标程序是否已接管、程序是否已重启。