跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

CC Switch 是一个跨平台桌面 App，专门用来给 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 这些 AI 命令行工具做配置切换。一个图形界面，多端口一键切到 RuAPI，不用手改 ~/.claude/settings.json、~/.codex/config.toml、~/.openclaw/openclaw.json。
如果你只用一个 CLI 工具（比如只有 Claude Code），可以直接看 Claude Code 直连 这一页，不一定要装 CC Switch。CC Switch 的价值在于 多工具 + 多服务商 之间快速切换。

​
前置条件

1

注册并充值

在 www.ruapi.ai 注册账号、用 USDT 完成首次充值。详见 充值指南。
2

创建一把 API key

控制台 → 令牌 → 创建令牌。复制以 sk-... 开头的字符串。详见 API key 与安全。
3

先装好至少一个 CLI 工具

CC Switch 本身不安装 Claude Code / Codex 等工具，只负责切换它们的配置。请先按 Claude Code 或 Codex 装好对应 CLI。

​
安装 CC Switch

到 Releases 页 按平台下载：
下载 cc-switch-x.y.z-arm64.dmg（Apple Silicon）或 cc-switch-x.y.z-x64.dmg（Intel）→ 双击挂载 → 把 CC Switch.app 拖进 应用程序 文件夹。
首次打开提示 “无法验证开发者” 时，去 系统设置 → 隐私与安全性 拉到底 → 点 仍要打开。

​
把 RuAPI 加进 CC Switch（Claude Code）

打开 CC Switch，左侧选择 Claude Code 这一栏，开始添加 RuAPI：
1

点『添加供应商』

主界面右上角的 + 添加供应商（Add Provider）按钮。
2

选『自定义』

在弹出的预设列表里下拉到底，选 自定义供应商（Custom Provider）。如果列表里有 “RuAPI” 预设可直接选，配置字段会自动填好，只用填 API key。
3

填基础信息

字段填什么
名称（Name）RuAPI
网站（Website）https://www.ruapi.ai
图标（Icon）可选，不填走默认
4

填环境变量

切到 环境变量（Environment Variables） 或 Endpoint 配置 Tab：
变量值
ANTHROPIC_BASE_URLhttps://www.ruapi.ai
ANTHROPIC_API_KEYsk-你刚生成的KEY
ANTHROPIC_MODEL（可选）claude-sonnet-4-6
ANTHROPIC_SMALL_FAST_MODEL（可选）claude-haiku-4-5
ANTHROPIC_BASE_URL 末尾不要带 /v1。Anthropic SDK 会自动补 /v1/messages，多写 /v1 反而会 404。
5

保存并启用

点 保存 → 回到主界面，点 RuAPI 这一栏右侧的 启用（Enable） 按钮。状态变成绿色 = 当前 Claude Code 已经切到 RuAPI。

​
把 RuAPI 加进 CC Switch（Codex）

左侧切到 Codex 栏，重复上面的添加流程，但环境变量改成：
变量值
OPENAI_BASE_URLhttps://www.ruapi.ai/v1
OPENAI_API_KEYsk-你的KEY（同一把 key 即可）
OPENAI_MODEL（可选）gpt-5 或你想默认用的模型
Codex 走 OpenAI 兼容协议，OPENAI_BASE_URL 末尾要带 /v1。

​
验证切换是否生效

CC Switch 切换完之后，需要根据工具不同做不同处理：

Claude Code

不用重启，CC Switch 会热切换。直接在已开着的 claude 会话里继续提问即可。

Codex / OpenClaw / Gemini CLI

需要 关掉再重开终端（或重启对应 CLI），让新的环境变量生效。
简单跑一句验证： 
# Claude Code
claude "用一句话说一下你在哪个 API 上"

# Codex
codex "用一句话说一下你在哪个 API 上"
回复正常 + 没有报 401 / 网络错误 = 切换成功。

​
切回官方 / 其他服务商

在 CC Switch 主界面，选中其他 provider → 点 启用。CC Switch 会自动把 ~/.claude/settings.json 等配置文件改回去。
你可以同时保留多个 provider（RuAPI、官方、其他中转），随时一键切换。这是 CC Switch 最大的便利点。

​
常见问题

  1. 关掉当前 claude 会话，新开一个终端窗口重试。
  2. 检查终端环境里是否手工 export 过 ANTHROPIC_BASE_URL —— 手工设置的环境变量优先级最高，会覆盖 CC Switch 改的 settings 文件。
  3. 运行 cat ~/.claude/settings.json，确认 env 部分有 RuAPI 的配置。
  • 检查 ANTHROPIC_API_KEY 是否复制完整（包括前缀 sk- 和所有结尾字符）。
  • 在 RuAPI 控制台 → 令牌 里确认这把 key 没被禁用，也没设置「可访问模型」白名单把当前模型排除。
  • 检查余额是否充足（控制台首页查看 USD 余额）。
  • 模型名拼写错误。Claude Code 默认模型 ID 在 RuAPI 的「模型广场」可查，常用：claude-sonnet-4-6、claude-opus-4-7、claude-haiku-4-5。
  • 不要在 ANTHROPIC_BASE_URL 末尾加 /v1。
确认 Claude Code 至少跑过一次 claude 命令（创建 ~/.claude/settings.json）。完全没装 Claude Code 的话，CC Switch 也没东西可切。

​
下一步