接入客户端
拿到令牌之后，把端点填进客户端。首推 CC-Switch 一键导入，手动配置作为进阶，最后一定要验一次连通性。
先决条件检查
开始之前确认这三件事都齐了：
没有令牌 → 客户端配不了；没有余额 → 请求被网关层拒绝； 环境没装 Node.js → CLI 类客户端装不上。
前两样在控制台解决，第三样跑一遍环境检查。
路线选择
| 路线 | 适合 | 你要做的事 |
|---|---|---|
| CC-Switch 一键导入（推荐） | 大多数人，尤其是 Claude Code / Codex 用户 | 装 CC-Switch，从控制台一键导入，它帮你写好配置文件 |
| 手动配置 | 想完全掌控配置文件、或用 CC-Switch 不支持的工具 | 照抄CLI 配置里对应工具的配置 |
两条路线结果一样，都是把端点地址和令牌写进客户端配置。区别只是一键导入替你写。
路线一：CC-Switch 一键导入
CC-Switch 是一个第三方开源工具（GitHub 项目），用来在多个 API 配置之间切换。 FluxToken 控制台提供了「一键导入」按钮，把端点、令牌和分组直接推给 CC-Switch。
CC-Switch 是第三方项目
它与 FluxToken 没有隶属关系，不是官方客户端。它自身的问题（界面、切换逻辑、 配置文件格式）请先查其上游仓库；只有导入的内容不对（端点或令牌写错了）才和我们有关。
这个按钮在当前站点版本里是可用的，没有被隐藏。操作步骤、截图位置和常见问题见：
导入完成后，CC-Switch 会自动把配置写进对应工具的配置文件。 之后仍然建议做一次连通性验证，别等到写代码时才发现有问题。
路线二：手动配置
手动配置要自己决定三件事：端点、令牌、协议。分别看下面几节。
完整的逐工具配置（Claude Code、Codex、Grok Build、Kimi Code）在：
→ CLI 配置
各类 GUI 客户端的配置在：
→ 客户端接入
端点怎么选
两个端点功能完全相同，只是入口不同：
| 你的位置 | 填哪个 |
|---|---|
| 国内网络 | 国内加速 https://cn.fluxtoken.ai，默认 |
| 港澳台及境外 | 全球站 https://api.fluxtoken.ai |
| 国内加速异常 | 临时回退到全球站 |
OpenAI 兼容接口要补 /v1，Anthropic 兼容接口不要
这是最容易填错的一处：
- OpenAI 兼容接口（Codex、OpenAI SDK、Cherry Studio 兼容模式等）——地址末尾要带
/v1：
- Anthropic 兼容接口（Claude Code、Claude Desktop 等）——填不带
/v1的根地址， 客户端自己会拼/v1/messages。填成带/v1的反而会拼出/v1/v1/messages
完整对照表见端点与域名。
令牌填在哪里
所有客户端都是同一个位置：API Key / 认证令牌字段，填你创建的那个 sk- 开头的令牌。
几个常见客户端的字段名不一样，但含义相同：
| 客户端 | 字段 |
|---|---|
| Claude Code | 环境变量 ANTHROPIC_AUTH_TOKEN（配合 ANTHROPIC_BASE_URL） |
| Codex CLI | 配置文件里的 API Key 字段 |
| Cherry Studio | 「API 密钥」 |
| Cline / Roo Code | 「API Key」，Provider 选 OpenAI Compatible |
API Key 不得公开、出售、出租或共享。不要提交到 Git 仓库、不要贴在截图和群聊里、 不要写进前端代码。
详见账号与安全。
最后一步：连通性验证
配完一定要验一次。这个请求不消耗模型用量，只是列出你的令牌能调用的模型：
curl https://cn.fluxtoken.ai/v1/models \ -H "Authorization: Bearer sk-你的令牌"按返回结果对照：
| 结果 | 含义 | 下一步 |
|---|---|---|
| 返回一长串模型列表 | 端点、令牌、鉴权全部正常 | 去客户端发一条真实消息 |
401 / Unauthorized | 令牌不对 | 检查令牌是否完整、是否过期、Bearer 后有没有空格 |
| 列表里没有你要用的模型 | 端点对了，但分组选窄了 | 回令牌管理换分组，改完重启客户端 |
| 连不上 / 超时 | 网络或端点问题 | 换另一个端点试；再看服务状态页 |
| 提示余额不足 | 余额耗尽 | 去充值 |
不带令牌访问返回 401 是正常的
/v1/models 需要鉴权。所以「裸访问返回 401」说明服务是通的，不能当成故障。
列表能拉出来之后，在客户端里发一条最简单的消息验证端到端通路。 这一步才算跑通——列模型和真正对话走的是不同链路，前者通了不代表后者一定通。
按客户端继续
配好之后，按你的工具看对应的详细页：
- Claude Code → Claude Code 配置
- Codex → Codex 配置
- Claude Desktop → Claude Desktop
- Cherry Studio → Cherry Studio
- Cline / Roo Code → Cline / Roo Code
- 其他工具 → 客户端总览
报错了去哪查
报错一律按原文搜：
- 报错原文索引 —— 先在这里搜一遍
模型不存在→ 模型不存在 / 分组选错401→ 认证与 401- 超时、连不上 → 连接与超时
- 扣费疑问 → 余额与扣费
还是不行，看服务状态页确认不是上游波动， 再带上报错原文、请求时间、模型名、令牌所属分组进群： QQ 群 1108757955，或 Telegram 群。