OpenCode 接入

OpenCode 与 OpenClaw 是不同产品。本页配置的是 OpenCode，完成后可从 /models 选择 NexaGW 的 GPT 模型。

准备工作

已安装 OpenCode。
已创建支持 GPT / Codex 模型的 NexaGW API Key。
确认 NEXAGW_API_KEY 已在启动 OpenCode 的终端中生效。

设置 Key 环境变量
- PowerShell
- Bash / Zsh
Terminal window
[Environment]::SetEnvironmentVariable('NEXAGW_API_KEY', 'YOUR_API_KEY', 'User')
Terminal window
export NEXAGW_API_KEY="YOUR_API_KEY"

创建全局配置

编辑 ~/.config/opencode/opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "nexagw/gpt-5.6-sol",
  "small_model": "nexagw/gpt-5.6-luna",
  "provider": {
    "nexagw": {
      "npm": "@ai-sdk/openai",
      "name": "NexaGW",
      "options": {
        "baseURL": "https://api.nexagwapi.com/v1",
        "apiKey": "{env:NEXAGW_API_KEY}"
      },
      "models": {
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol" },
        "gpt-5.6-terra": { "name": "GPT-5.6 Terra" },
        "gpt-5.6-luna": { "name": "GPT-5.6 Luna" },
        "gpt-5.4": { "name": "GPT-5.4" },
        "gpt-5.4-mini": { "name": "GPT-5.4 Mini" }
      }
    }
  }
}

重新启动并选择模型
Terminal window
```
opencode
```
在 OpenCode 中运行 /models，选择 NexaGW 下的模型，再发起一条简单请求。

香港线路只需把 baseURL 改为 https://api.nexagw.org/v1。Key 不变。

验证与清理

/models 中没有 NexaGW：检查 JSON 语法、provider ID 和环境变量是否由当前进程继承。
模型报不存在：先请求 /v1/models，只保留 Key 实际可见的模型。
需要停用：从配置中移除 provider.nexagw，并把 model、small_model 切换到其他 provider。

字段格式依据 OpenCode 官方 provider 文档和全局配置文档。

下一步：查看常见问题与报错。