OpenCode 配置教程

通过配置文件将 OpenCode 接入 Coding Flow 平台，快速完成 Claude、GPT 和 Gemini 模型配置。

开始前请先完成 Node.js 环境安装教程。

你需要准备

一个可用的 API Key（形如：sk-******）
一个可访问的 服务地址（Base URL）（通常由部署方/网关提供）

本站通用服务地址

https://api.codingflow.ai

安装 OpenCode

控制台中输入以下命令会从 npm 官方仓库下载并安装最新版本的 OpenCode 工具。

Bash

npm install -g opencode-ai

验证安装

安装完成后，输入以下命令检查，如果显示版本号，说明安装成功了！

Bash

opencode -v

配置 OpenCode

创建并打开配置文件 opencode.json：

txt

Windows:
C:\Users\<你的用户名>\.config\opencode\opencode.json

macOS: 
/Users/<你的用户名>/.config/opencode/opencode.json

Linux: 
/home/<你的用户名>/.config/opencode/opencode.json

将以下配置写入文件，关键配置项：

baseURL：https://api.codingflow.ai/v1
apiKey：将 YOUR_API_KEY 替换为 Coding Flow API Key

保存配置文件后，请退出并重新启动 OpenCode 使新配置生效。

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "name": "codingflow",
      "options": {
        "baseURL": "https://api.codingflow.ai/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex",
          "limit": {
            "context": 400000,
            "output": 128000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        }
      }
    }
  }
}