OpenCode 配置
OpenCode 接 FluxToken：声明一个自定义提供方，填端点、令牌、模型名。
OpenCode 由第三方维护，与 FluxToken 没有隶属关系。 它的安装方式、配置文件路径和字段名由它的维护者决定，以 OpenCode 官方文档为准。
本文档讲 FluxToken 这一侧要准备的三样东西（端点、令牌、模型名）， 以及它们在本类工具里通常怎么填。不写死 OpenCode 的版本号和配置字段名 —— 这些会随版本变化。
一、准备工作
1. 端点
港澳台及境外用户用
按 OpenCode 要求的接口类型补路径：
| 接口类型 | 地址 |
|---|---|
| OpenAI 兼容 | https://cn.fluxtoken.ai/v1 |
| Anthropic 兼容 | https://cn.fluxtoken.ai（不带 /v1） |
该配哪一种由 OpenCode 决定。 到它的官方文档里找自定义提供方 / custom provider 的说明，按那边的接口类型填上面的地址。
2. 令牌与分组
控制台 → 令牌管理 → 添加令牌，选一个分组。按你打算用的模型选：
| 打算用的模型 | 分组 |
|---|---|
| Claude 系 | 【Claude】Max · 稳享（主）（日常）或 【Claude】Max · 惠享（省钱） |
| GPT / Codex 系 | 【Codex】Pro · 稳享（日常）或 【Codex】Pro · 惠享（省钱） |
| Gemini 系 | 【Gemini】Pro · 企业级 |
| Grok / Kimi / DeepSeek / GLM | 对应的单一分组 |
选组思路见怎么选分组。
3. 模型名
从模型列表逐字照抄。同一个分组里能用的模型是固定的， 填了分组里没有的模型会返回 模型不存在。
二、配置要点
这类工具配置自定义提供方的通用套路是三件事：
- 声明一个提供方，给它一个名字（如
fluxtoken） - 填 Base URL（上面的端点）和 API Key（你的令牌）
- 在模型列表里填模型 ID，然后把默认模型指过去
这三项在 OpenCode 里的具体字段名和文件位置，以 OpenCode 官方文档为准。 文件名（常见的是在配置目录下放一个 JSON 或 TOML 配置）和键名都可能随版本调整。
命令行工具通用的一条经验
Base URL 与接口类型必须配套：OpenAI 兼容的提供方要 /v1， Anthropic 兼容的提供方不能有 /v1。
如果你配完报 404，九成是这里弄反了，先检查这一项再去查别的。
改完配置后完全退出进程再启动——大多数 CLI 工具只在启动时读一次配置。
三、连通性验证
第一步：端点是否可达（期望 401）
curl -s -o /dev/null -w '%{http_code}' https://cn.fluxtoken.ai/v1/models; echo第二步：令牌与分组是否正确（期望 200）
curl -s https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"返回的模型清单就是你这个令牌所在分组的可用模型。
把这份清单和你打算填进 OpenCode 的模型名对一遍—— 对不上的那个就是会报 模型不存在 的那个。
第三步：在 OpenCode 里发一句话
能正常回复即链路打通。
四、排查顺序
| 你看到的 | 先查这里 |
|---|---|
| 装不上 / 命令找不到 | OpenCode 侧，查它的官方文档 |
| 404 | Base URL 与接口类型不配套（/v1 加错或漏加） |
| 401 | 令牌串复制不全、带了引号空格，或提供方没配到 env_key 对应的变量 |
| 连不上 / 超时 | 端点选择问题，国内加速异常可回退 全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。 |
模型不存在 | 令牌分组不含该模型，或模型 ID 拼错 |
| 改了配置没反应 | 完全退出进程再启动 |