客户端与智能体配置指引

通用接入核心两要素

所有软件接入 FlowsToken 都只需要填这两个核心信息：

1. API 接口地址 (Base URL)：

2. API 密钥 (API Key)：粘贴您在 控制台 → API 密钥 中创建的 sk-... 密钥。

编程智能体首选：OpenCode 开源 · 终端编程 Agent · 全自动长任务

为什么推荐 OpenCode？
OpenCode 是完全开源的终端编程智能体（Claude Code 的开源对标），具备自主规划、读写代码、执行终端命令、多轮工具调用的能力。配置是一个明文 JSON 文件，只连您填写的 API 地址，代码不经过任何第三方服务器——这也是我们把它放在编程类首位、而不推荐闭源专有 IDE 的原因。以下步骤均已用 FlowsToken 智能组与官方组实测通过。

OpenCode 接入步骤：

1. 安装：macOS / Linux 终端执行 brew install sst/tap/opencode，或任意系统 npm i -g opencode-ai；
2. 写配置文件：在您的项目根目录（或 ~/.config/opencode/ 全局）新建 opencode.json，把下面内容粘进去，只需改 models 里的模型名：
   opencode.json 复制

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "flowstoken": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "FlowsToken",
         "options": {
           "baseURL": "https://www.flowstoken.com/v1",
           "apiKey": "{env:FLOWSTOKEN_API_KEY}"
         },
         "models": {
           "bestoo-auto": { "name": "FlowsToken 智能API" }
         }
       }
     }
   }

   • baseURL 必须带末尾的 /v1；
   • apiKey 推荐写 {env:FLOWSTOKEN_API_KEY}，密钥放环境变量、不进配置文件（export FLOWSTOKEN_API_KEY="sk-您的密钥"）；也可以直接填 "sk-..."；
   • OpenCode 不自动拉取模型列表，models 里的名字必须与您 Key 的分组匹配，对照表见下；
3. 模型名必须与 Key 分组匹配（OpenCode、Aider、Goose、Cline 等所有不自动拉模型的智能体通用）：

   您的 API Key 分组	配置里填入的模型名	说明与核心避坑
   智能API组 推荐小白与日常编程	bestoo-auto	强烈推荐！一个名字，系统按任务难度自动调度最合适的模型；智能体多轮工具调用实测一次通过。
   官方组 (VIP) 官方模型 · 官方价直售	Claude 编程首选：anthropic/claude-sonnet-4.6 Claude 深度思考：anthropic/claude-opus-4.6 OpenAI 旗舰：openai/gpt-5.6-sol OpenAI 性价比：openai/gpt-5.6-terra DeepSeek 满血：deepseek/deepseek-v4-pro 通义千问：alibaba/qwen3.5-plus	必须带厂商英文前缀（anthropic/、openai/、deepseek/ 等）。 若漏掉前缀直接填 claude-sonnet-4.6，系统会报“无可用渠道”。完整名单详见官网「价格」。
   普通组 (默认) 双通道高可用 · 官方1~3折	常规代码：gpt-5.6-sol 性价比 Claude：claude-sonnet-4-6 极速推理：deepseek-v4.1-flash	不要带任何前缀，直接输入常规模型名即可。普通组加了 openai/ 等前缀反而会识别不了。 注意 Claude 在普通组是横线写法 claude-sonnet-4-6（不是 4.6），写错会报“无可用渠道”。三款均已实测智能体工具调用通过。

   选型秘诀：想用其他模型？去「模型广场」一键复制即可！
   1. 打开 FlowsToken 模型广场；
   2. 在页面顶部「分组」筛选框中选中您创建 Key 时的分组（智能API (smart)、官方组 (vip) 或 普通组 (default)）；
   3. 页面即时筛出该组全部可用模型，点击模型名即可复制，粘进配置文件的 models 里，100% 准确不拼错。
4. 开始使用：在项目目录执行 opencode 进入交互界面（/models 可切换模型），或一句话直接跑任务：opencode run "把这个项目的 README 补全"。

前往 OpenCode 官网 →

Aider 开源 · 终端结对编程 · 最省 Token

Aider 是老牌开源终端编程助手，改动直接落盘并自动 git 提交，工具调用轮次少、Token 消耗在同类里最低，适合改小功能、修 bug、写测试。下方「终端极客模式」的生成器可粘贴密钥自动拼出命令。

1. 安装：uv tool install aider-chat（或 pipx install aider-chat）；
2. 配置环境变量（Mac/Linux）：export OPENAI_API_BASE=https://www.flowstoken.com/v1 与 export OPENAI_API_KEY=sk-您的密钥，可追加到 ~/.zshrc 永久生效；
3. 启动：智能组 aider --model openai/bestoo-auto；官方组 aider --model openai/anthropic/claude-sonnet-4.6（openai/ 前缀表示走 OpenAI 兼容协议，后面接您分组里的模型名）。

访问 Aider 官网

Goose 开源 · 桌面 + 终端通用智能体 · MCP 生态

Goose 由 Block 开源，既有桌面应用也有命令行，不限于编程：可以接 MCP 扩展去操作浏览器、数据库、办公软件，适合“让 AI 替我把这一串事做完”的通用任务。

1. 安装：brew install block-goose-cli，或在官网下载桌面版；
2. 配置环境变量：
   Shell 复制

   export GOOSE_PROVIDER=openai
   export GOOSE_MODEL=bestoo-auto
   export OPENAI_HOST=https://www.flowstoken.com
   export OPENAI_API_KEY=sk-您的密钥

   注意：Goose 的 OPENAI_HOST 不要带 /v1（它会自动拼接 /v1/chat/completions，带了会变成 /v1/v1/... 报 404）。这与 OpenCode / Aider 相反。桌面版在 Settings → Models → Configure Provider → OpenAI 中填同样的 Host 与 Key 即可。
3. 运行：goose session 进入交互，或 goose run -t "在当前目录新建 hello.py 并运行"。

访问 Goose 官网

ChatBox 轻量全平台（手机+电脑）

1. 打开 ChatBox，进入 设置 → AI 模型提供方，选择 OpenAI API；
2. API 密钥：粘贴您的 sk-...；
3. 注意 Base URL 填法：ChatBox 会自动在末尾拼接 /v1，因此请填写 https://www.flowstoken.com（不要带末尾的 /v1）；
4. 模型选择：智能API填 bestoo-auto，或普通组如 gpt-5.6-sol，点击保存即可。

访问 ChatBox 官网

NextChat (ChatGPT-Next-Web) 经典网页 / 桌面版

1. 点击界面左下角 设置 图标，服务商选择 OpenAI；
2. 接口地址 (Endpoint)：填写 https://www.flowstoken.com/v1；
3. API Key：填入您的 sk-...；
4. 自定义模型列表：填入 bestoo-auto,gpt-5.6-sol 等模型。

访问 NextChat 官网

其他编辑器插件 (Roo Code / Continue) 与 Cursor 代码编辑器插件

• Cursor：Settings → Models → 在 OpenAI API Key 处填入密钥，展开 Override OpenAI Base URL 并填入 https://www.flowstoken.com/v1。
• Roo Code（开源）：API Provider 选择 OpenAI Compatible，Base URL 填入 https://www.flowstoken.com/v1，API Key 填入密钥，模型从自动拉取的列表中选择；注意 3.54 及更早版本与 VS Code 1.122+ 不兼容（见上方 Cline 一节说明）。Cline 见上方独立教程。
• Continue：在配置文件中将 provider 设为 openai，apiBase 设为 https://www.flowstoken.com/v1。

Dify / FastGPT / Open WebUI 应用编排与大模型中台

• Dify：设置 → 模型供应商 → 添加 OpenAI 兼容模型，API Endpoint 填写 https://www.flowstoken.com/v1，填入 API Key。
• Open WebUI：管理员面板 → 外部连接 → OpenAI API 接口填 https://www.flowstoken.com/v1，保存后点击刷新同步模型。
• FastGPT：渠道管理中添加 OpenAI 兼容渠道，Base URL 指向 https://www.flowstoken.com/v1。

终端与命令行极客模式 (Terminal / CLI) 命令行开发 · 一键复制指令

FlowsToken 100% 遵循 OpenAI 标准接口协议，所有终端 AI 命令行工具（如 OpenCode、Aider、Goose、ShellGPT、aicommits）以及自动化 Shell 脚本均可无缝运行。

终端高阶使用秘诀：

• 永久生效：将上述 ① 中的 export 命令追加写入您的 ~/.zshrc（Mac 默认）或 ~/.bashrc（Linux 默认）文件末尾，以后每次打开终端都自动连通 FlowsToken；
• Aider 指定官方组 Claude 模型：运行 aider --model openai/anthropic/claude-sonnet-4.6（需使用官方组 Key）；
  OpenCode 配好 opencode.json 后直接 opencode run "任务描述"，见上方 编程智能体 一节；
• ShellGPT (sgpt)：配好环境变量后直接在终端运行 sgpt "用一行命令查找占用磁盘最大的前10个文件"；
• Git 自动生成提交信息：运行 aicommits 即可自动分析暂存区代码并生成标准 Commit Message。