客户端接入总览
按「你用的是哪个工具」找到对应页面。能用 CC-Switch 就用 CC-Switch。
📌
推荐路径：先试 CC-Switch 一键导入
CC-Switch 是个第三方开源工具，能一键把 FluxToken 的配置导入 Claude Code / Codex， 省掉手写配置文件的步骤。控制台的导出/导入入口是可用的。
除非你明确想了解配置细节，否则先走 CC-Switch 一键导入， 不成功再回到手动配置。
按你的工具找页面
| 我在用的东西 | 去哪 | 配置方式 |
|---|---|---|
| 想一键导入，不手动改配置 | CC-Switch 一键导入 | 图形界面导入 |
| Claude Code | Claude Code | 环境变量 / settings.json |
| Codex CLI | Codex | ~/.codex/config.toml |
| Grok Build | Grok Build | 自定义端点 + API Key |
| Kimi Code | Kimi Code | 自定义端点 + API Key |
| Claude Desktop | Claude Desktop | 仅 【Claude】Max · 顶享 支持外接 |
| ChatGPT / Codex App | ChatGPT / Codex App | 自定义提供方 |
| OpenCode | OpenCode | 自定义提供方 |
| Cherry Studio | Cherry Studio | OpenAI 兼容模式 |
| Cline / Roo Code | Cline / Roo Code | 自定义端点 + 模型 |
| 沉浸式翻译、其他 | 沉浸式翻译与其他 | OpenAI 兼容端点 |
Gemini CLI 不在本分区的范围内
Google 官方 CLI 的稳定性不够，本站不为它提供配置教程。 Gemini 用户请走 Cline / Roo Code 这类客户端。
所有客户端共用的三件事
不管用哪个客户端，配置项翻来覆去就这三样。这一节适用于下表全部工具：
| 要填什么 | 值 |
|---|---|
| 端点 | 国内加速https://cn.fluxtoken.ai默认使用。国内网络首选，延迟更低。 |
| 令牌 | 控制台「令牌管理」里创建的 sk-...，创建时必须选分组 |
| 模型名 | 从模型列表逐字照抄 |
端点再强调一次，因为这是填错率最高的一项：
| 接口类型 | 填什么地址 | 举例 |
|---|---|---|
| OpenAI 兼容 | 末尾补 /v1 | 国内加速 · OpenAI 兼容https://cn.fluxtoken.ai/v1用于 Codex、OpenAI SDK、Cherry Studio 兼容模式等。 |
| Anthropic 兼容 | 填不带 /v1 的根地址 | 国内加速https://cn.fluxtoken.ai默认使用。国内网络首选，延迟更低。 |
港澳台及境外用户把上面的 cn 换成 api（
全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。
）。 两个端点功能完全相同，只是入口不同。客户端配置里最常见的四个错误
- 路径加错
/v1—— OpenAI 兼容要加，Anthropic 兼容不能加。 - 令牌建错分组 —— 表现是
模型不存在，不是 401。 - 改成配置没重启 —— 客户端进程还持有旧配置。
- 模型名拼错 —— 点号和中划线要分清（
kimi-k2.7-codevskimi-k2-7-code）。
验证方法：所有客户端通用
配完任何客户端，先跑这两条命令，就能确定问题出在服务端还是客户端：
第一步：端点连通性（期望 401）
curl -s -o /dev/null -w '%{http_code}' https://cn.fluxtoken.ai/v1/models; echo返回 401 是对的——端点通，只是在拒绝没有凭证的请求。
第二步：令牌与分组（期望 200 与模型清单）
curl -s https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"返回的模型清单就是你这个令牌所在分组的可用模型。
- 两条都正常、客户端还是不行 → 问题在客户端配置
- 第二步的清单里没有你要的模型 → 分组选错了，去控制台改令牌分组
这一步能省掉大量来回
「客户端报 401」到底是令牌的问题还是客户端读配置的问题？ 跑完上面两条就有答案了。详细的排查思路见报错原文索引。
关于第三方客户端
本站涉及的客户端里，只有 FluxToken 自己是平台自身，其余都是第三方产品：
| 客户端 | 归属 |
|---|---|
| CC-Switch | 第三方开源项目（GitHub） |
| Claude Desktop | Anthropic |
| ChatGPT / Codex App | OpenAI |
| OpenCode / Cherry Studio / Cline / Roo Code / 沉浸式翻译 | 各自的第三方维护者 |
这些工具与 FluxToken 没有隶属关系，也不由 FluxToken 维护。 它们自身的安装、升级、界面和配置项由各自的维护者决定：
- 文档只写「往哪个框里填什么」，不写死第三方工具的具体版本号和界面文案
- 遇到工具本身的报错（装不上、界面找不到入口、功能不工作），先查该工具的上游文档或 issue
- 我们这侧能保证的只有端点、令牌、模型名这三项
如果某个第三方工具的文档与本页描述冲突，以该工具官方文档为准。