Claude Code 与 Codex 配置

这页教你用 cc-switch 快速把 ZR API 配进 Claude Code / Codex。Claude Code 用户先安装 Claude Code，再用 cc-switch 填 API Key、Base URL 和模型 ID；只配置 Codex 的用户，可以直接跳到 cc-switch 配置部分。

TIP

如果你不想手动改环境变量，推荐优先使用本页的 cc-switch 配置方式。需要手动配置 Claude Code 环境变量时，再看 Claude Code 环境变量配置。

准备工作

你需要准备	填什么
API Key	在 ZR API 控制台 创建，格式一般是 sk-...
余额 / 兑换码	余额不足时先 获取兑换码，再到控制台兑换
Claude Code 兼容地址	https://zrapi.org
Codex / OpenAI 兼容地址	https://zrapi.org/v1
模型 ID	建议直接从 模型与价格 复制，避免大小写或横线写错

第一步：安装 Claude Code

如果你已经能在终端里运行 claude --version，这一节可以跳过。安装完成后，重新打开终端再继续配置。

macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew

brew install --cask claude-code

WinGet

winget install Anthropic.ClaudeCode

npm

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

安装后验证：

claude --version

WARNING

Windows 上要分清 PowerShell 和 CMD。PowerShell 窗口通常以 PS C:\...> 开头；CMD 窗口通常是 C:\...>。如果复制命令后提示命令不存在，先确认你用的是对应的终端。

第二步：下载 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 编辑器之间切换接入点。下面截图分别展示 Codex 和 Claude Code 的配置方式，双击图片可以放大。

Codex 配置 1

Codex 配置 2

Claude Code 配置

选择模式

先按你要用的模型选择模式。Claude、Kimi、GLM、MiniMax、DeepSeek、Qwen 这类模型，通常按 Claude Code 兼容方式配置；GPT / Codex 系列按 OpenAI 兼容方式配置。

你要用的模型	工具里选择的模式	API Key	Base URL	模型示例
Claude 系列	Anthropic / Claude Code	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

模型名最好直接从 模型与价格 复制。大小写、横线、斜杠都要保留。

保存后测试

在 Claude Code 或 Codex 里发送 请回复 OK。能返回正常文本，就说明配置可用。

常见错误

现象	优先检查
401	Key 是否完整，是否多了空格，是否误用了官方平台 Key
402	控制台余额是否足够，兑换码是否已经充值
404	Base URL 是否重复带了 /v1，模型 ID 是否写错
回复很慢	模型上游繁忙，换模型或稍后重试
Claude Code 仍要求登录官方账号	先退出官方账号，或改用 环境变量配置 明确指定 ZR API

Claude Code 环境变量配置查看模型 ID错误码排查