逐个客户端的配置

下面每份配置都在真实 API 上跑通过：建临时仓库，把客户端指向 genmux，下达一条创建文件的指令，再检查文件确实生成。把 nb_live_... 换成你的密钥；qwen3.8-max 是合理的默认选择，任何支持工具调用的模型都可以。

OpenCode

OpenCode 通过 @ai-sdk/openai-compatible 包支持任意兼容 OpenAI 的服务商。把下面这段放进项目的 opencode.json（或 ~/.config/opencode/opencode.json），导出 GENMUX_API_KEY，再选择 genmux/<id> 形式的模型。每次请求会带上约 20 个工具和 32k 的 max_tokens，两者都没问题：工具定义约占 1.5K 个 prompt token，max_tokens 会被收敛到模型上限。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "genmux": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "genmux",
      "options": { "baseURL": "https://api.genmux.tech/v1", "apiKey": "{env:GENMUX_API_KEY}" },
      "models": {
        "qwen3.8-max": { "name": "Qwen3.8-Max" },
        "doubao-seed-2-pro": { "name": "Doubao Seed 2 Pro" }
      }
    }
  }
}

运行

export GENMUX_API_KEY=nb_live_...
opencode --model genmux/qwen3.8-max
# or one-shot:
opencode run --model genmux/qwen3.8-max "add a README with install steps"

Aider

Aider 通过 openai/ 模型前缀连接任意 OpenAI 风格的 base URL，并使用它自己的编辑格式，因此完全不需要工具调用。三个环境变量加一个 model 参数就是全部配置。用较小的模型时，--edit-format whole 最稳；aider 对我们的模型 id 打印的 “unknown model” 元数据警告可以忽略。

终端

export OPENAI_API_BASE=https://api.genmux.tech/v1
export OPENAI_API_KEY=nb_live_...
aider --model openai/qwen3.8-max
# smaller models: aider --model openai/qwen3.8-max --edit-format whole

Cline 与 Roo Code

这两个 VS Code 扩展都有 “OpenAI Compatible” 服务商选项。按下表填写，勾上 “supports streaming”，除非你选的是视觉模型（模型页面会标注 vision），否则不要勾 “supports images”。工具调用会以常见的工具卡片呈现；每次写入和命令仍然走扩展自己的确认流程。

设置 → API Provider

API Provider	OpenAI Compatible
Base URL	https://api.genmux.tech/v1
API Key	你的 genmux 密钥（nb_live_...）
Model ID	qwen3.8-max（或任意支持工具调用的模型）
Supports streaming	开
Supports images	关，视觉模型除外

Continue

Continue 从 ~/.continue/config.yaml 或项目里的 config.yaml 读取 YAML 配置。用 provider: openai、我们的 apiBase，以及 capabilities: [tool_use] 声明模型，这样 agent 模式才会发送 tools；roles 一行让同一个模型可用于 chat、edit 和 apply。命令行版本（npm i -g @continuedev/cli，然后 cn --config ./config.yaml）用的是同一个文件。

config.yaml

name: genmux
version: 0.0.1
schema: v1
models:
  - name: Qwen3.8 Max
    provider: openai
    model: qwen3.8-max
    apiBase: https://api.genmux.tech/v1
    apiKey: nb_live_...
    roles: [chat, edit, apply]
    capabilities: [tool_use]

命令行

npm i -g @continuedev/cli
cn --config ./config.yaml