SETUP GUIDE · CC SWITCH
用 CC Switch 把免费 API 接入 Claude Code / Codex
一句话回答
在 CC Switch 里点 Add Provider 新增一个自定义供应商，
Base URL 填 https://jiurelay.com/anthropic/v1（Claude Code、Hermes、OpenClaw 等 Anthropic 协议客户端）或
https://jiurelay.com/openai/v1（Codex / Cursor / Cline 等 OpenAI 协议客户端），
API Key 粘贴在 JiuRelay 首页一键领取的免费 Key，模型 ID 填 5.2（Free 线路）或
grok-4.5（Grok 线路，仅 OpenAI 协议），保存后点 Enable，
终端执行 claude 问一句话能答上来就算接通。
全程无需注册、无需绑卡，也不需要你自己的官方 API Key。
Key 有效期 Free 3 小时、Grok 2 小时、Claude 1 小时，到期自动失效，
有效期内不设 token 总量与总请求次数上限；
但需要在领取后 15 分钟内完成首次调用，否则会被自动吊销。
配置参数速查
ANTHROPIC 协议
- 适用客户端
- Claude Code、Claude 桌面端、Hermes（爱马仕）、OpenClaw
- Base URL
- 模型 ID
5.2· 仅 Free 线路支持本协议
OPENAI 协议
- 适用客户端
- Codex、Cursor、Cline、Roo Code、Aider、OpenCode（Hermes / OpenClaw 也可走此协议）
- Base URL
- 模型 ID
5.2或grok-4.5
API Key 两种协议都一样：在首页一键领取，限时有效、到期自动失效。
客户端不限于上表。判断标准只有一条：只要客户端允许你自己填 Base URL 和 API Key，就能用。市面上主流的 AI 编程客户端基本都支持这一点，填法完全相同。
本站提供 OpenAI / Anthropic 协议兼容端点，并非上述模型厂商的官方接口；实际可用模型以接口实时返回为准。
四步配完
添加供应商
CC Switch → Add Provider → 自定义。名称随意，Base URL 与 Key 按上表填入。
点 Enable 启用
CC Switch 自动写入 ~/.claude 等配置文件。只保存不点启用是不会生效的。
15 分钟内试跑
终端执行 claude 问一句话。超过 15 分钟没调用，Key 会被自动吊销。
常见问题
CC Switch 是一个跨平台桌面工具，集中管理 Claude Code、Codex、Gemini CLI 等命令行工具的 API 供应商配置，一键切换。它把配置写入各 CLI 对应的配置文件，省去每次手动改 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 的麻烦。接本站最省事的地方在于：Key 是限时的，过期后只需在 CC Switch 里换一次 Key，不用重新翻配置文件。
要加 /v1。Anthropic 协议填 https://jiurelay.com/anthropic/v1（仅 Free 线路支持），OpenAI 协议填 https://jiurelay.com/openai/v1。末尾不要多加斜杠，也不要重复写成 /v1/v1 —— 这是第三方中转最常见的配置错误，表现为 404 或连接失败。
Free 线路填 5.2，同时兼容 OpenAI 与 Anthropic 两种协议。Grok 线路填 grok-4.5，仅兼容 OpenAI 协议。模型 ID 必须原样填写，写成官方名称（例如 claude-sonnet-4 或 gpt-4o）会返回模型不存在的错误。
不能。Claude Code 走 Anthropic 协议，而 Grok 4.5 线路只兼容 OpenAI 协议，协议不匹配。想在 Claude Code 里用，请选同时兼容两种协议的 Free 线路（模型 ID 5.2）；想用 Grok 4.5，请改用 Codex、Cursor、Cline 等 OpenAI 协议客户端。
按客户端区分：Claude Code 支持热切换，一般即时生效，个别版本需要关掉当前会话重开；Codex 需要重启终端才会重新读配置；Gemini CLI 每次请求都会重新读配置。重启后仍不生效，优先检查 Base URL 末尾是否多了斜杠，以及是否真的点了 Enable。
按顺序查四点：① Key 是否复制完整、前后有无空格换行；② 协议是否配对，Anthropic 协议客户端填了 /openai/v1 会认证失败；③ Key 是否已过期 —— 本站 Key 限时有效，401 最常见的原因就是过期；④ Key 是否已被吊销。确认无误后回首页重新领一个即可。
两种情况：① 领取后 15 分钟内没有发起首次调用，Key 会被自动吊销，用来回收领了不用的额度；② 检测到多 IP 共享同一个 Key，Key 会被限制，正常单人使用不会触发。两种情况都需要重新领取。
限制只在时间上：Free 线路 3 小时、Grok 4.5 2 小时、Claude Sonnet 5 1 小时，到期自动失效。本站不给单个 Key 设 token 总量上限，也不设总请求次数上限，有效期内可以正常连续使用，包括在 Claude Code 里跑多文件任务。高峰时段上游共享额度可能临时限速（表现为 429，见下一条）。需要更长有效期可以通过推广计划兑换 24 小时 / 7 天 / 30 天的长效 Key。
429 表示触发了限速，等待几十秒再重试，不要立刻反复重发，那样只会持续触发限速。在 Claude Code 里跑大型多文件任务时频繁 429，建议把任务拆小、降低并发。免费线路是共享额度，高峰时段限速更明显。
同一设备每条线路每天限领 1 次，每天 00:00（北京时间）刷新；此外每个 IP 每小时最多领 1 次、连续 12 小时内最多 4 次。同一局域网或公司出口下多人共享公网 IP 会共用 IP 额度，属于正常现象。需要更长有效期的 Key，可以通过推广计划用有效访问和调用积分兑换。
市面上的 AI 编程客户端基本都能用，判断标准只有一条：只要它允许你自己填 Base URL 和 API Key，就能接。已验证可用的包括 Claude Code、Codex、Cursor、Cline、Roo Code、Aider、OpenCode、Hermes（爱马仕）、OpenClaw，以及用 CC Switch 统一管理的各类 CLI。没列到的客户端不代表不支持 —— 按它自己的"自定义 / OpenAI 兼容 / Anthropic 兼容"设置项填入上表三个参数即可，填法完全相同。
Codex 可在 CC Switch 里一起管理，切换后需重启终端；Cursor 在设置的 Models 页填自定义 OpenAI Base URL 与 Key；Cline 在插件设置里选 OpenAI Compatible 后填三项；Hermes（爱马仕）和 OpenClaw 在各自的模型 / 网关配置里选 Anthropic 或 OpenAI 提供方，再填 Base URL 与 Key。OpenAI 协议一律填 https://jiurelay.com/openai/v1，Anthropic 协议一律填 https://jiurelay.com/anthropic/v1。
CC Switch 的供应商配置存在 ~/.cc-switch/cc-switch.db，重装前备份这一个文件即可恢复全部供应商。注意本站 Key 是限时的，恢复旧备份后里面的 Key 大概率已过期，需要回首页重新领取并更新。
对话内容不落库，本站只记录请求状态、Token 数量和延迟等运行数据，用于限速与故障排查。但这是免费公共中转，出于通用安全常识，仍不建议用它处理生产密钥、私有仓库或含敏感信息的代码 —— 这条对任何第三方中转都成立，不只是本站。
在 CC Switch 里保留一个官方登录（Official Login）配置，需要时切过去走正常 OAuth 流程，本站配置不会被删除，随时可以切回来。这也是推荐做法：日常探索用免费线路，复杂重构等吃模型能力的任务切回官方。