Nexoraivision Nexoraivision
Claude Code 中转介绍

CC-Switch 一键配置

用 CC-Switch 图形化工具 5 分钟完成 Claude Code 中转配置，无需手改 settings.json。
强烈推荐新手使用。CC-Switch 是完全免费开源的多 Provider 配置管理工具，一个 GUI 同时管 Claude Code / Codex / Gemini / OpenCode / OpenClaw / Hermes / Claude Desktop 全家桶，一键在不同中转之间切换，无需手编任何 settings.json。本文档讲的是 Claude Code Tab 下的 Provider 配置流程。Codex / Gemini 等其他工具的 Provider 在各自 Tab 里独立管理，字段、写入的配置文件都不同：

⚠️ 只用官方渠道下载（务必阅读）

CC-Switch 是 完全免费开源 的桌面应用，作者不向用户收取任何费用。近期有多个冒牌网站伪装成 CC-Switch 收钱、套取账号，已有用户被骗。只通过以下官方渠道获取：
渠道唯一官方地址
官方网站ccswitch.io
源代码github.com/farion1231/cc-switch
下载GitHub Releases
作者@farion1231
举报冒牌GitHub Issues
任何向你收费、要充值、要登录密码的「CC Switch」网站或客户端都是假的。

为什么推荐 CC-Switch

  • 💡 图形化界面 — 不用手动编辑 ~/.claude/settings.json
  • 🚀 一键切换 — 多个 API 提供商之间秒切
  • ⚙️ 多 Key 管理 — 个人 / 工作 / 测试 Key 分开存
  • 🔄 配置保存 — 切换记录、自动备份
  • 🎯 全家桶管理 — Claude Code / Codex / Gemini / Claude Desktop 等共用一个 UI

下载安装

最新版本：CC-Switch v3.15.0（发布于 2026-05-16）

下载文件大小适合
CC-Switch-v3.15.0-Windows.msi12.3 MB推荐，标准 MSI 安装包
CC-Switch-v3.15.0-Windows-Portable.zip12.0 MB免安装版（解压即用）

双击 .msi 安装即可。支持 Windows 10+。

v3.15.0 新特性速览

Claude Desktop 一级管理面板

Claude Desktop 现在和 Claude Code 同等地位，可通过内置代理网关切换第三方供应商，自带 44 个预设供应商

反向代理大幅加固

P0-P3 修补路由 / 生命周期 / 重试 / 失败回退；非 Anthropic 后端 HTTPS 连接池复用；支持 IPv6 监听

Role-based 模型映射

Claude Code 改用 sonnet / opus / haiku 角色映射 + supports1m 标志，替代旧的 [1M] 后缀

用量看板 Hero Card

Filter-driven Hero 卡片显示缓存归一化的真实总 token + 缓存命中率，按筛选实时更新

配置前先备份：CC-Switch 会自动覆写 ~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json）。强烈建议先备份：
# macOS / Linux
cp ~/.claude/settings.json ~/.claude/settings.json.bak

# Windows PowerShell
Copy-Item $env:USERPROFILE\.claude\settings.json $env:USERPROFILE\.claude\settings.json.bak
CC-Switch 也会在每次切换前自动备份到 ~/.claude/backups/。

配置 Claude Code 中转

步骤 1：打开 CC-Switch

启动 CC-Switch 后看到主界面。顶部有多个工具分组（Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes），每组管自己的 Provider 列表。

列表里每个 Provider 都会显示当前余额（如截图 2355.14 USD）和最近一次同步时间，方便监控用量。

步骤 2：选 Claude 分组 + 点 + 按钮

确认顶部分组栏选中 Claude，然后点右上角橙色 + 按钮。

步骤 3：选「自定义配置」+ 填表

进入「添加新供应商」页面：

顶部 Tab

确认选中 Claude 供应商 Tab（页面顶部蓝色横条）

预设供应商

预设里 Nexoraivision 不在列表，所以选最左边的 自定义配置（默认选中）

填基本信息

字段值
供应商名称nexoraivision
备注nexoraivision（可选，自己记）
官网链接留空（可选）
API Key你的 Nexoraivision Key（sk-xxx）
请求地址https://nexor.nexoraivision.com
请求地址末尾不要带斜杠。是 https://nexor.nexoraivision.com，不是 https://nexor.nexoraivision.com/。

（可选）勾选行为开关

下方有一排复选框，按需勾选：

复选框推荐作用
隐藏 AI 署名✅ 勾选等价 CLAUDE_CODE_ATTRIBUTION_HEADER=0，请求不带 Claude Code 标识
禁用自动升级✅ 勾选关闭 Claude Code CLI 后台自动升级
启用 Tool Search按需允许 Claude 调用工具（默认就行）
最大强度思考按需强制 thinking budget 拉满（耗时但效果最好）
Teammates 模式按需团队共享模式（个人开发不需要）

检查配置 JSON

页面底部的「配置 JSON」会实时展示最终写入的内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://nexor.nexoraivision.com"
  }
}

如果勾选了「隐藏 AI 署名」会多出 CLAUDE_CODE_ATTRIBUTION_HEADER: "0"，以此类推。

步骤 4：点右下角「添加」

填完确认无误，点页面右下角蓝色 + 添加 按钮提交。

提交后 CC-Switch 会：

  1. 把这条 Provider 写入本地 Provider 列表
  2. 暂时不会激活（需要下一步手动启用）

步骤 5：点「启用」激活

回到主界面，新加的 Provider 在列表顶部。鼠标移到该行右侧，会出现操作按钮组，点 ▶ 启用 按钮。

启用后：

  • 状态变为「使用中」
  • CC-Switch 自动写入 ~/.claude/settings.json 和 shell 环境变量
  • 旧的 Provider（如果有）会被自动停用

步骤 6：验证

关掉所有终端窗口重开（关键，环境变量在已运行进程里是缓存的），然后：

claude --version
claude "你好"

能返回即配置成功。

在多个 Provider 间切换

如果你同时配了多个 Provider（如官方 Anthropic + Nexoraivision + 另一家中转）：

  • 列表里点哪条的「启用」就用哪条
  • 切换会自动覆盖 ~/.claude/settings.json 和环境变量
  • 旧 Provider 状态自动变为「未启用」
  • 不影响正在运行的 claude 会话；下次启动新会话时生效

高级功能

自动备份

CC-Switch 每次切换前会备份到 ~/.claude/backups/，文件名带时间戳。误操作可从这里恢复。

导入 / 导出

设置 → 导入/导出：

  • 导出：把所有 Provider 配置打包成 JSON（不含 API Key）
  • 导入：从同事/团队那拿模板快速搭建

多端共用一份配置

把导出的 JSON 加密后传到 iCloud / Dropbox，多台机器导入即可保持 Provider 列表一致（Key 需要每台机器单独填）。

同时管理 Claude / Codex / Gemini 等

CC-Switch 一个 GUI 同时管多种工具，互不干扰：

顶部 Tab管理的文件
Claude~/.claude/settings.json + shell env
Codex~/.codex/config.toml + ~/.codex/auth.json
GeminiGemini CLI 配置
OpenCode~/.config/opencode/opencode.json
OpenClawOpenClaw 配置
HermesHermes 配置

切 Claude Provider 不会影响 Codex 配置，反之亦然。

常见问题

不想用 CC-Switch？看 手动配置指南 自己写 settings.json。

手动配置

Claude Code CLI 与 VSCode 插件的环境变量与 settings.json 配置（macOS / Linux / Windows CMD / PowerShell）。

命令速查

Claude Code CLI 常用命令、slash 命令、快捷键速查表。