OpenCode 配置

在 OpenCode 中使用平台的模型。OpenCode 使用 OpenAI 接口。

准备工作

API 密钥：在控制台的 API 密钥页新建，把下文配置里的 sk-... 换成你的密钥。
接入地址：https://api.gxcy.com/v1（OpenAI 接口）。
模型：可以调用的模型见控制台的模型页，下文以 deepseek-flash 为例。

使用 OpenCode 命令行

安装

macOS / Linux 可以用官方脚本安装：

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

也可以用 npm 安装：

npm install -g opencode-ai

验证安装，输出版本号即安装成功：

opencode --version

配置

编辑 opencode.json，目录不存在时自行创建：

macOS / Linux：~/.config/opencode/opencode.json
Windows：%USERPROFILE%\.config\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "custom": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "国芯词元",
      "options": {
        "baseURL": "https://api.gxcy.com/v1",
        "apiKey": "sk-..."
      },
      "models": {
        "deepseek-flash": {
          "name": "deepseek-flash"
        }
      }
    }
  }
}

custom 是服务商的名称，可以自取；models 里可以列多个模型。
模型支持识图时，在该模型下加上 "modalities": { "input": ["text", "image"], "output": ["text"] }。
可以用 "limit": { "context": 上下文长度, "output": 最大输出 } 写明模型的长度，OpenCode 据此在对话过长时自动压缩。

使用

进入项目目录，执行：

opencode

启动后输入 /models，选择「国芯词元」下的模型。

使用 VS Code 插件

插件在 VS Code 的终端中启动 OpenCode 命令行，需要先按上文安装并配置命令行。之后在 VS Code 扩展市场搜索并安装 OpenCode 插件，或在 VS Code 的终端中执行 opencode，插件会自动安装。插件沿用上文的 opencode.json。

常见问题

Windows 上安装时提示 failed to install the right opencode CLI package

按提示手动安装对应的包，再重新执行 npm install -g opencode-ai：

npm install -g opencode-windows-x64

CPU 不支持 AVX2 时，改装 opencode-windows-x64-baseline。

在 VS Code 中启动时提示“因为在此系统上禁止运行脚本”

Windows 默认不允许 PowerShell 运行脚本。在 PowerShell 中执行下面的命令后重启 VS Code：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

也可以把 VS Code 默认的终端改为命令提示符（cmd）或 Git Bash。