CLI 通用准备
配任何命令行工具之前，先把这页的三件事做掉：选端点、拿令牌、验通。
各工具页只讲「这个工具专属的那几步」。端点、令牌、验证方法三件事是共用的， 本页讲一次，后面不再重复。建议按顺序读完再跳到你用的工具。
一、选端点
FluxToken 提供两个接入地址，功能完全相同，区别只在入口。按你的网络位置选：
国内加速是默认选择。港澳台及境外用户用全球站；国内加速出现异常时也可以回退到全球站。
两条容易写错的规则
OpenAI 兼容接口要在末尾补
/v1，用于 Codex、OpenAI SDK、Cherry Studio 兼容模式等：国内加速 · OpenAI 兼容https://cn.fluxtoken.ai/v1用于 Codex、OpenAI SDK、Cherry Studio 兼容模式等。Anthropic 兼容接口填不带
/v1的根地址，因为客户端会自己在后面拼/v1/messages。 给 Claude Code 填https://cn.fluxtoken.ai/v1是错的，这是新用户最常见的失败原因。
二、拿令牌（API Key）
令牌在控制台里创建，路径固定：
- 打开控制台 https://cn.fluxtoken.ai
- 左侧菜单进入 令牌管理
- 点 添加令牌
- 填名称、选择分组、按需设置过期时间与额度上限
- 保存后复制令牌串（形如
sk-...）
「分组」是这一步唯一不能随便填的字段。 它决定了这个令牌能调用哪些模型、 按哪个倍率扣费。选错了的表现不是报错，而是 模型不存在。
令牌只显示一次
令牌串在创建后要立刻保存。丢了就只能重新建一个。
改分组的正确姿势：
- 分组可以事后修改，不用重建令牌
- 但改完必须重启客户端（或重新加载配置）才生效。 正在运行的进程可能还持有旧的分组配置，表现为「我明明改了却还报
模型不存在」
详细的字段说明见创建 API 令牌，选哪个分组见怎么选分组。
三、准备运行环境
Claude Code 和 Codex 这两个工具通过 npm 分发，所以要先有能用的 Node.js 与 npm。
node -vnpm -v- 两条命令都要能正常输出版本号。只装 Node 忘了 npm、或版本过旧，都会在安装阶段报错。
- 具体要求的最低版本以各工具官方文档为准 —— 各工具的引擎要求会随版本变化， 文档这里给一个固定数字必然过期。报
Unsupported engine就是版本不够，升级 Node 即可。 - 升级 Node 推荐用版本管理器（如 nvm、fnm）或发行版自带的包源，不要手动覆盖系统 Node。
工具装好后，本页下面给的验证命令都可以直接复用。
四、通用验证方法
配完任何客户端，都用同一条思路验证：先证明令牌和端点没问题，再怀疑客户端配置。
第一步：不带令牌打端点（期望 401）
curl -s -o /dev/null -w '%{http_code}' https://cn.fluxtoken.ai/v1/models; echo期望输出 401。
返回 401 说明端点是通的 —— 它只是拒绝了一个没带凭证的请求，这正是正确行为。 如果这里超时或连不上，问题在网络或端点选择，跟令牌无关。
第二步：带上令牌再打一次（期望 200）
curl -s https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"期望返回一个 JSON，里面是你这个令牌所在分组能用的模型清单。
看到 401 是令牌不对；看到 200 但模型列表里没有你想用的模型，是分组选错了， 去改令牌的分组然后重启客户端。
这第二步同时验证了两件事
- 令牌本身有效（否则 401）
- 分组选对了（模型列表就是那个分组的模型清单）
后面遇到「客户端报错但不知道哪一步错」，回来跑这两条命令就能定位是服务端还是客户端。
港澳台及境外用户把上面地址换成 https://api.fluxtoken.ai/v1 再跑一遍。
五、三个反复出现的坑
| 现象 | 原因 | 处置 |
|---|---|---|
模型不存在 | 令牌分组不含该模型，或模型名拼错 | 改分组 / 核对模型名，然后重启客户端 |
| 401 / 认证失败 | 令牌填错、被删、已过期，或粘贴时带了引号空格 | 重新复制令牌；注意别把 sk- 漏掉 |
| 改了配置却没用 | 客户端还持有旧配置 | 完全退出进程再启动，不是只关窗口 |
还有一条不属于配置问题：分组本身可能在上游波动。 如果同一分组多个模型同时失败，先看服务状态页， 或者查你自己的错误请求记录，再去翻报错原文索引。
六、按工具进分页
端点、令牌、验证都做完之后，选你用的工具：
| 工具 | 页面 | 一句话 |
|---|---|---|
| Claude Code | Claude Code | 环境变量或 settings.json 两种配法 |
| Codex CLI | Codex | 改 ~/.codex/config.toml |
| Grok Build | Grok Build | 官方说明推荐走 稳享 分组 |
| Kimi Code | Kimi Code | Kimi 专用分组，两个模型 |
不想手动改配置文件的话，先看客户端接入总览里的 CC-Switch 一键导入， 那是省事的路径。缓存相关的成本优化单独在缓存优化。
关于地区
FluxToken 不面向、也不向位于中国大陆的个人或组织提供服务。 这是《服务条款》和《支持的国家和地区》里的明文规定，平台不提供任何规避方式。 详见支持的国家和地区。