OpenCode 使用指南

OpenCode 是一款开源的 AI 编程助手框架，支持多种 AI 模型集成，包括代码生成、修改和审查功能。

本次实测仅覆盖 macOS CLI 的手动配置与普通 Key 请求。复合 Key、CC-Switch 配置及其他系统的安装流程未在本次实测。

安装

根据使用习惯选择安装方式。

macOS / Linux

bash

curl -fsSL https://opencode.ai/install | bash

Windows PowerShell

推荐使用 WSL 环境，按上述 macOS / Linux 方式安装。

导入

安装完成后，选择以下两种方式之一将 OpenCode 接入 TokenFlux。

推荐使用 CC-Switch 统一管理配置。

操作步骤：

按创建 API Key 教程生成 API Key。
在 CC-Switch 侧栏选择 OpenCode，点击“+”添加供应商，填入 API 地址 https://tokenflux.dev/v1、API Key 与模型。控制台的“导入到 CCS”不覆盖 OpenCode，详见 CC-Switch。
保存后，在供应商卡片上点击“添加”，再重启 OpenCode。

使用复合 Key

复合 Key 要求请求中的模型 ID 带分组前缀。假设已将 GPT 前缀映射到支持 gpt-6-astra 的分组，可以使用下面的 opencode.json：

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "tokenflux/GPT/gpt-6-astra",
  "provider": {
    "tokenflux": {
      "npm": "@ai-sdk/openai",
      "name": "TokenFlux",
      "options": {
        "baseURL": "https://tokenflux.dev/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "GPT/gpt-6-astra": {
          "name": "GPT-6 Astra (TokenFlux)",
          "reasoning": true,
          "tool_call": true,
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "limit": {
            "context": 128000,
            "output": 32768
          }
        }
      }
    }
  }
}

将 YOUR_API_KEY 替换为复合 Key，GPT 替换为该 Key 上实际配置的前缀。tokenflux 是 OpenCode 中的供应商标识，请求发送的模型 ID 是 GPT/gpt-6-astra。

limit 是示例设置的客户端 Token 预算，可按模型与分组的实际能力调整。添加其他模型时，还需填写相应的工具调用、输入类型和思考能力，字段见 OpenCode 自定义供应商文档。

验证接入

普通 Key 的上述配置可以用下面的命令确认：

bash

opencode models
opencode run -m openai/gpt-6-astra "只回复 OK"

使用上面的复合 Key 示例时，测试命令为：

bash

opencode run -m tokenflux/GPT/gpt-6-astra "只回复 OK"

opencode models 展示客户端模型目录，不会验证 TokenFlux 的 API Key、地址或模型权限。opencode run 会真实调用并扣费，收到回复后可在使用记录中确认请求。

命令报错或模型列表为空时，先按单独测试 Key 和端点排除客户端因素，再回头检查 opencode.json。

OpenCode 使用指南 ​

安装 ​

导入 ​

使用复合 Key ​

验证接入 ​

相关入口 ​

OpenCode 使用指南

安装

导入

使用复合 Key

验证接入

相关入口