CC-Switch 一键导入
不想手写配置文件就走这条路：在控制台生成导入配置，在 CC-Switch 里导入，选客户端，验证。
CC-Switch 能把 FluxToken 的配置一次性导进 Claude Code / Codex， 不用你手动去改环境变量或 config.toml。如果你只需要「把它跑起来」，这条路径最短。
代价是它多引入了一个第三方工具。如果你更想搞清楚配置里到底写了什么， 走手动配置那条路。
先说清楚：CC-Switch 是第三方项目
CC-Switch 是第三方开源项目（托管在 GitHub），不是 FluxToken 的产品， 与 FluxToken 没有任何隶属、合作或担保关系。
- 它的安装、更新、界面、功能由它自己的维护者负责
- 它自身的报错（装不上、界面打不开、崩溃），先查它的 GitHub 仓库与 issue
- FluxToken 这边只提供「导出配置」这一段，导入之后的工具行为与平台无关
- 本文档不写 CC-Switch 的具体版本号、界面文案和安装命令 —— 这些随它的版本变化，写死必然过期。以该项目的官方文档为准
整体流程
一共五步，顺序不能颠倒：
| 步骤 | 在哪做 | 做什么 |
|---|---|---|
| ① | 本地 | 安装 CC-Switch |
| ② | FluxToken 控制台 | 生成导入链接 / 配置 |
| ③ | CC-Switch | 导入这份配置 |
| ④ | CC-Switch | 选择要配置的客户端（Claude Code / Codex） |
| ⑤ | 终端 | 验证是否真的通了 |
一、安装 CC-Switch
CC-Switch 是一个需要装在本地的工具。它的安装方式、支持的操作系统和当前版本， 请到该项目的 GitHub 仓库看 README —— 文档这里不复制它的安装命令， 因为它会随版本变化，抄一份过期的命令反而会误导你。
怎么判断该不该用它
- 你只是想快点把 Claude Code 用起来 → 用它
- 你需要按项目切换不同端点或分组 → 它正是干这个的
- 你想完全掌控配置内容 → 直接看 Claude Code 或 Codex
二、在控制台生成导入配置
FluxToken 控制台提供了 CC-Switch 的导入/导出入口，当前是可用的（未被隐藏）。
大致流程：
- 登录控制台 https://cn.fluxtoken.ai
- 找到 CC-Switch 一键导入 / 导出 相关入口 （位置随控制台版本略有不同，通常在令牌管理或客户端接入相关的区域）
- 选择要导出的内容 —— 关键是带上你的令牌和分组
- 生成导入链接或配置文件，复制备用
导入配置里带着你的令牌
生成的链接或配置文件包含你的 API 令牌，等同于密码：
- 不要发到群里、不要贴到 issue 里、不要提交进 Git
- 令牌泄露了就去控制台删掉重建一个，改分组不会让泄露的令牌失效
三、在 CC-Switch 里导入
打开 CC-Switch，用它的导入功能读入上一步拿到的链接或配置。
具体的按钮名称和菜单位置以 CC-Switch 官方文档为准 —— 本文档不描述界面细节， 因为界面会随版本改版。
导入之后，你应该能在 CC-Switch 里看到刚导入的 FluxToken 配置项， 里面包含端点地址和一个令牌。
四、选择客户端
CC-Switch 的作用是把同一套配置写进不同工具的配置文件里。导入之后要指定写给谁：
| 客户端 | CC-Switch 会改的东西 | 对应的手动配置 |
|---|---|---|
| Claude Code | 写 Claude Code 读的配置（环境变量或 settings.json） | Claude Code 配置 |
| Codex | 写 ~/.codex/config.toml | Codex 配置 |
两边需要的端点格式不一样，这正是容易出问题的地方：
| 客户端 | 端点该长什么样 | 原因 |
|---|---|---|
| Claude Code | https://cn.fluxtoken.ai（不带 /v1） | Anthropic 兼容接口，客户端自己拼 /v1/messages |
| Codex | https://cn.fluxtoken.ai/v1（要带 /v1） | OpenAI 兼容接口 |
两边端点格式搞反是最常见的故障
如果 CC-Switch 导出的配置里端点格式不对（比如给 Claude Code 写成了带 /v1 的地址）， 表现是 404 或认证失败。这类问题属于 CC-Switch 的配置生成逻辑，先查上游。
你自己核对的方法：打开 CC-Switch 写好的配置文件， 对着上表看端点末尾有没有多余的 /v1。
五、验证
导入完成后必须验证一遍，不要直接就用。
第一步：确认令牌和分组没问题
curl -s -o /dev/null -w '%{http_code}' https://cn.fluxtoken.ai/v1/models; echo401 是对的——说明端点通，只是在拒绝没有凭证的请求。
curl -s https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"返回的清单就是你这个令牌所在分组的可用模型。 清单里没有你想用的模型，就是分组选错了，去控制台改令牌分组。
第二步：在客户端里实际发一句话
- Claude Code：终端里跑
claude，发一句话看有没有回复 - Codex：跑
codex，同样发一句话
能正常回复，说明整条链路通了。
第三步：确认生效的是新配置
CC-Switch 写完配置后，已经打开的客户端不会自动重载：
- 完全退出终端里的 Claude Code / Codex 进程，重新启动
- 只关窗口不算退出
改了分组也是同理——改完必须重启客户端才生效。
六、出问题时的排查顺序
先分清是 FluxToken 的问题还是 CC-Switch 的问题，这决定了你去哪儿找人：
| 现象 | 大概率是谁的问题 | 怎么办 |
|---|---|---|
上面两条 curl 就失败 | FluxToken 侧 | 看服务状态页、报错原文索引 |
curl 正常，客户端报 404 | CC-Switch 生成的端点多写了/漏了 /v1 | 手动改配置，见 Claude Code / Codex |
curl 正常，客户端报 401 | CC-Switch 没写进正确的令牌，或客户端没重启 | 检查配置文件内容，重启客户端 |
客户端报 模型不存在 | 令牌分组选错 | 控制台改分组，重启客户端 |
| CC-Switch 本身装不上 / 打不开 / 闪退 | CC-Switch 侧 | 去它的 GitHub 仓库查 issue |
| CC-Switch 界面里找不到某个选项 | CC-Switch 侧 | 界面随版本变化，以它官方文档为准 |
兜底方案
CC-Switch 只是省手工步骤，不是必需品。 如果它一直配不好， 直接按手动配置来：Claude Code 只需要两个环境变量， Codex 只需要一个配置文件。步骤不多，而且每一步你都能看明白。
相关页面
- 客户端接入总览 —— 先看该不该走这条路径
- Claude Code 配置 —— 手动配置的完整步骤
- Codex 配置 —— 手动配置的完整步骤
- 通用准备 —— 端点、令牌、验证方法
- 报错原文索引 —— 按报错文案查