Appearance
Claude Code 与 Codex 配置
为了减少手动改配置,我们用 cc-switch 帮你快速配置 ZR API:先获取 API Key、Base URL 和模型 ID ,写到 Claude Code / Codex 对应位置即可。
第一步:下载 cc-switch
先安装工具
打开 cc-switch v3.14.1 发布页,往下滑到资源位置,按你的系统下载对应文件。如果你已经安装过 cc-switch,可以直接看下一步。
GitHub 打不开怎么办
可以在浏览器搜索 cc-switch 下载教程,有很多人分享下载和安装方法。下载完成后,再回到本页按截图填写 ZR API 配置。
第二步:获取 API Key
登录控制台
打开 zrapi.org/console,进入令牌或 API Key 页面。
创建新 Key
复制以 sk- 开头的 Key。不要使用官方 OpenAI 或 Anthropic 的 Key。
第三步:使用 cc-switch 配置
cc-switch 适合在 Claude Code、Codex 或其他 AI 编辑器之间切换接入点,下面截图分别展示 Claude Code 和 Codex 的配置方式,双击放大。



选择模式
先按你要用的模型选择模式。Kimi、GLM、MiniMax、DeepSeek、Qwen 这些国产模型,通常按 Claude Code 兼容方式配置。
| 你要用的模型 | 工具里选择的模式 | API Key | Base URL | 模型示例 |
|---|---|---|---|---|
| Claude 系列 | Anthropic | sk-YOUR_TOKEN | https://zrapi.org | claude-opus-4-7 |
| GPT / Codex 系列 | OpenAI | sk-YOUR_TOKEN | https://zrapi.org/v1 | GPT-5.5 |
| Kimi / GLM / MiniMax / DeepSeek / Qwen | Claude Code 兼容 | sk-YOUR_TOKEN | https://zrapi.org | 从模型页复制 |
填写 API Key
填你在 ZR API 控制台创建的 sk-...,不要填官方 OpenAI 或 Anthropic 的 Key。
填写 Base URL
Claude Code 兼容模式填 https://zrapi.org;OpenAI / Codex 兼容模式填 https://zrapi.org/v1。
填写模型 ID
模型名最好直接从 模型与价格 复制。大小写、横线、斜杠都要保留。
保存后测试
在编辑器里发送 请回复 OK。能返回文本就说明配置可用。
常见错误
| 现象 | 优先检查 |
|---|---|
| 401 | Key 是否完整,是否多了空格 |
| 402 | 控制台余额是否足够 |
| 404 | Base URL 是否重复带了 /v1,模型 ID 是否写错 |
| 回复很慢 | 模型上游繁忙,换模型或稍后重试 |