CC Switch 通用概念与配置
这一篇把安装、界面结构、Provider 字段、6星中转 接口地址、令牌来源、切换原理和验证流程一次讲清楚。看完这里，再去 Claude Code、Codex CLI 或 Gemini CLI 的专页会顺很多。
看这篇前，先准备好这 4 件事
CC Switch 写的是本机配置。安装之前先把下面几项准备好，后面添加 Provider 时就不会在地址、令牌和模型之间来回猜。
| 准备项 | 通过标准 | 没准备好先看 |
|---|---|---|
| 6星中转 账号和可用额度 | 能登录控制台，并知道自己要用聊天、Claude、Codex、Gemini、图像还是视频能力。 | 5 分钟快速开始 |
| 对应用途的令牌 | 已经创建用途清楚的测试令牌，且只保存了脱敏片段用于排障。 | 令牌与安全 |
| 目标 CLI 至少能打开 | claude --version、codex --version 或 gemini --version 至少一个可用。 |
环境检查 |
| 知道地址差异 | Claude Code 用根地址，Codex CLI 用 /v1，Gemini 以 6星中转 导入结果为准。 |
地址速查 |
一、下载安装
CC Switch 是本机桌面工具，负责把你选中的配置写入 Claude Code、Codex CLI、Gemini CLI 等工具读取的本地配置里。安装后先打开一次，确认系统允许它注册外部协议和写入本机配置。
| 系统 | 推荐方式 | 安装后检查 |
|---|---|---|
| Windows | 下载 Windows 安装包，按提示安装。 | 从开始菜单能打开 CC Switch；浏览器允许打开 ccswitch:// 链接。 |
| macOS | 使用安装包，或执行 brew install --cask cc-switch。 |
如果系统拦截首次运行，在系统设置中允许打开。 |
| Linux | 按发行版选择 .deb、.rpm 或 AppImage。 |
桌面环境能唤起外部协议；服务器无桌面时看 ccs CLI 命令行版。 |
macOS Homebrew 安装
brew install --cask cc-switch
brew upgrade --cask cc-switch如果你看过旧教程里要求先 brew tap，以官方当前说明为准；能直接安装时，不需要额外添加旧 tap。
安装后做一次本地检查
- 启动 CC Switch，确认能看到 Claude、Codex、Gemini 等应用入口。
- 确认浏览器打开外部应用协议时，会弹出“是否打开 CC Switch”的提示。
- 如果系统提示授予文件访问权限，允许它读写目标 CLI 的配置文件。
- 先不要粘贴真实令牌，等下面地址和分组规则确认后再添加 Provider。
二、界面结构
把 CC Switch 理解成本机 CLI 配置文件的可视化管理器：你在界面里添加 Provider，点击启用，它会把这条配置写进对应工具的配置文件。
| 区域 | 作用 | 你需要关注什么 |
|---|---|---|
| 顶部应用切换 | 在 Claude、Codex、Gemini 等应用之间切换。 | 先选应用，再添加 Provider；不要在 Claude 页里误加 Codex 配置。 |
| 配置列表 | 显示当前应用下保存的所有 Provider。 | 确认只有目标配置处于启用或使用中状态。 |
| 详情编辑区 | 编辑名称、API URL、API Key、模型等字段。 | 重点检查 Base URL、令牌分组和模型 ID。 |
三、添加一个 6星中转 Provider
不管最终要切 Claude、Codex 还是 Gemini，第一次都要先添加一条后端配置。
选择应用
顶部先切到目标应用：Claude、Codex 或 Gemini。应用选错时，即使字段填对，也可能写入错误的配置位置。
添加 Provider
点击 Add Provider / 添加供应商 / 新建配置。名称建议写清用途，例如 6星中转-Claude-prod、6星中转-Codex-test。
填写地址和令牌
API URL 按下方地址表填写；API Key 使用 6星中转 控制台创建的令牌。不要复制多余空格，也不要把令牌截图发给别人。
保存并启用
保存后回到配置列表，点击 Enable / 启用。只有看到该配置处于使用中，才算切换完成。
四、配置项含义
| 字段 | 6星中转 怎么填 | 说明 |
|---|---|---|
| Name / 名称 | 6星中转-Claude-prod、6星中转-Codex-test |
本地显示名，建议包含平台、工具和用途。 |
| Provider / 应用 | Claude、Codex、Gemini | 决定写入哪个 CLI 的配置，不是任意选择的分类标签。 |
| API URL / Base URL | 按下一节的地址表填写 | 最容易出错。Claude 不带 /v1，Codex 必须带 /v1。 |
| API Key / 令牌 | sk-你的 6星中转 令牌 |
从 6星中转 控制台令牌管理复制，只显示一次时要妥善保存。 |
| Model / 模型 | 从 6星中转 模型广场复制模型 ID | 可先不填；要锁定模型时，必须选当前令牌分组可访问的模型。 |
五、字段填写示意
这里把“要填什么”压成一张能直接核对的字段示意。先选应用，再填地址、令牌和模型；不要在不同工具之间混用地址规则。
Add Provider / 添加后端配置
示意值请按实际工具选择6星中转-Codex-testhttps://www.6xin.cc/v1https://www.6xin.cc；Gemini 按导入结果保留根地址格式。sk-你的6星中转令牌Bearer。六、6星中转 接口地址速查
不同 CLI 的 Base URL 写法不一样，套用其他工具配置会直接导致 401、404 或路径异常。
| 目标工具 | API URL | 关键规则 |
|---|---|---|
| Claude Code | https://www.6xin.cc |
填根地址，不要加 /v1。 |
| Codex CLI | https://www.6xin.cc/v1 |
OpenAI 兼容协议，必须带 /v1。 |
| Gemini CLI | https://www.6xin.cc/ |
部分版本要求根地址末尾保留斜杠；以工具专页和导入结果为准。 |
| 备用域名 | 以 6星中转 控制台展示的备用域名为准 | 域名可替换，路径规则不变：Codex 带 /v1，Claude 不带。 |
七、6星中转 令牌怎么拿
- 登录 6星中转 控制台。
- 进入令牌管理页面。
- 点击新增令牌，填写容易识别的名称。
- 选择目标工具对应的分组或可用模型范围。
- 创建后立刻复制令牌，后续不要在聊天、截图、公开仓库里暴露完整 Key。
| 要接的工具 | 令牌建议 | 选错时常见表现 |
|---|---|---|
| Claude Code | 选择可访问 Claude 模型的分组。 | model not found、403、权限不足。 |
| Codex CLI | 选择 OpenAI 兼容或 Codex 使用的模型分组。 | 模型不存在、404、请求能发出但无可用模型。 |
| Gemini CLI | 选择 Gemini 相关模型分组。 | 权限不足、模型 ID 不匹配、路径或协议错误。 |
八、切换为什么要重开终端
CC Switch 点启用后，会修改对应 CLI 的本机配置文件。已经启动的终端或 CLI 进程通常不会自动重新读取这些配置，所以切换后要关闭旧终端，重新打开。
启用 Provider
在 CC Switch 里把目标配置设为使用中。
写入本机配置
CC Switch 把 API URL、Key、模型等字段写进对应工具读取的位置。
重开终端
关掉旧 CLI 窗口，打开新终端，再启动 Claude、Codex 或 Gemini。
发起短请求验证
先让工具回复一句 OK，再开始长任务，避免把错误配置带进高成本调用。
九、验证有没有切成功
| 验证项 | 成功表现 | 失败时先看 |
|---|---|---|
| CC Switch 状态 | 目标 Provider 显示使用中。 | 是否启用了错误应用下的 Provider。 |
| 命令行版本 | claude --version、codex --version 或 gemini --version 能输出版本。 |
CLI 是否已安装，PATH 是否生效。 |
| 短问答 | 新终端里让工具回复 OK，能正常返回。 | Base URL、令牌、模型 ID、分组。 |
| 6星中转 用量日志 | 控制台能看到刚才请求的时间点。 | 如果日志没有出现，可能仍在走旧后端。 |
本机命令检查
先确认目标 CLI 本身能运行，再验证 6星中转 网络连通。命令不存在时，先回到对应工具的安装教程，不要急着改 Provider。
claude --version
codex --version
gemini --versioncurl -I "https://www.6xin.cc"网络检查只用来确认本机能访问 6星中转 域名；真正是否走对 Provider，还要用目标 CLI 发一次短问答，并到 6星中转 用量日志核对时间。
十、通用配置完成标准
这一页不要求你已经把三个工具都接完，但至少要确认下面几项。满足后，再进入 Claude、Codex 或 Gemini 的专页会更稳。
| 检查项 | 应该看到什么 | 不满足时回到哪里 |
|---|---|---|
| CC Switch 可打开 | 桌面端能打开，能看到 Claude、Codex、Gemini 等应用入口。 | 下载安装 |
| 字段含义清楚 | 知道 Name、Provider、API URL、API Key、Model 分别控制什么。 | 配置项含义 |
| 地址规则清楚 | Claude 不带 /v1，Codex 带 /v1，Gemini 按导入结果保留根地址格式。 |
接口地址速查 |
| 验证方法清楚 | 知道要重开终端、发短问答，并到 6星中转 用量日志核对时间点。 | 验证有没有切成功 |
十一、配置记录怎么写
通用篇看完后，如果你准备正式添加 Provider，先约定一条记录格式。记录越清楚，后续越不容易因为“到底谁改了哪个配置”浪费时间。
| 字段 | 建议写法 | 用途 |
|---|---|---|
| 配置名 | 6星中转-Claude-prod、6星中转-Codex-test |
从名称就能看出工具和用途。 |
| 地址 | https://www.6xin.cc、https://www.6xin.cc/v1 或一键导入结果 |
确认 Claude、Codex、Gemini 的路径规则没有混用。 |
| 令牌 | 写令牌名称和脱敏片段，例如 sk-abc123...wxyz |
方便定位是哪条令牌，仍然不泄露完整 Key。 |
| 模型 | 从 6星中转 模型广场复制的模型 ID | 避免靠记忆手写旧模型名。 |
| 验证 | 写“短问答成功，日志已出现”，并记录时间点 | 证明配置真的生效。 |
配置名：6星中转-Codex-test
工具：Codex CLI
API URL：https://www.6xin.cc/v1
令牌：codex-test-2026-06，sk-abc123...wxyz
模型：从模型广场复制的模型 ID
验证：2026-06-21 20:30 新终端短问答成功，6星中转 用量日志可见
回退：Codex-official十二、常见误区速查
| 现象 | 常见原因 | 怎么处理 |
|---|---|---|
| 点启用后还是走旧后端 | 旧终端进程没有关闭。 | 关掉所有目标 CLI 窗口，重新打开终端再试。 |
| Claude 401 / 404 | API URL 多写了 /v1 或令牌不匹配。 |
改成 https://www.6xin.cc，并确认使用 Claude 可用分组。 |
| Codex 找不到接口 | API URL 漏了 /v1。 |
改成 https://www.6xin.cc/v1。 |
model not found |
模型 ID 不在当前令牌分组里。 | 回 6星中转 模型广场复制当前分组可用模型，或重建令牌。 |
| 多个配置看起来都在使用中 | UI 缓存或旧版本状态显示异常。 | 重启 CC Switch，只启用目标 Provider，再重开终端验证。 |
十三、配置异常后，先切回一条已知可用路线
CC Switch 很适合保存多套配置，但排障时不要同时改三套工具。先选一个工具、一条 6星中转 令牌、一个模型，把它恢复到最小可用状态，再决定是否复制到其他工具。
| 回退动作 | 怎么做 | 确认标准 |
|---|---|---|
| 只保留一个目标 Provider | 在当前应用页启用一条 6星中转 Provider，其他 Provider 先停用或不选。 | 界面上能明确看出当前工具正在使用哪一条配置。 |
| 恢复地址规则 | Claude 用 https://www.6xin.cc；Codex 用 https://www.6xin.cc/v1；Gemini 按一键导入结果保留。 |
没有把 Claude 和 Codex 的地址格式混用。 |
| 重开终端 | 关闭旧 CLI 进程，重新打开终端后再启动目标工具。 | 新请求时间能和 6星中转 用量日志对上。 |
| 回到短问答 | 先让工具回复一句 OK，再恢复长上下文、插件、脚本或自动化任务。 | 短问答成功后再逐步加回复杂参数。 |
下一步
通用篇看完后，按你实际使用的工具进入专页：
通用配置仍然不生效时，先整理这些信息
通用篇排障重点是“应用页、地址规则、Provider 状态、终端是否重开”。不要把 Claude、Codex、Gemini 的现象混在一起提交。
| 信息 | 建议内容 | 不要提供什么 |
|---|---|---|
| 应用页 | 当前是在 Claude、Codex、Gemini 还是其他应用页下添加 Provider。 | 不要只贴 Provider 名称。 |
| 配置字段 | API URL、模型 ID、Provider 名称、启用状态和切换时间。 | 不要提交完整令牌。 |
| 终端状态 | 切换后是否关闭旧终端、重新打开目标 CLI。 | 不要用旧终端的结果证明新配置无效。 |
| 6星中转 回证 | 最小短问答是否成功，用量日志是否有对应时间点。 | 不要只说“界面显示已启用”。 |
如果已经能定位到具体工具，继续看 Claude 定位信息、Codex 定位信息 或 Gemini 定位信息。