OpenCode · OptiWaves

先按准备 API Key设置 OPTIWAVES_API_KEY。以下配置适用于 OpenCode 1.x。

1. 选择配置文件

当前项目使用项目根目录的 opencode.json。需要在多个项目中共用时，使用用户配置：

系统	默认用户配置
macOS / Linux	`~/.config/opencode/opencode.json`
Windows	`%USERPROFILE%\.config\opencode\opencode.json`

已有 opencode.jsonc 时可继续使用它。设置了 XDG_CONFIG_HOME 或 OPENCODE_CONFIG 时，按对应路径编辑。

2. 添加 provider 和模型

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "optiwaves/auto",
  "provider": {
    "optiwaves": {
      "name": "OptiWaves",
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://api.optiwaves.app/v1",
        "apiKey": "{env:OPTIWAVES_API_KEY}"
      },
      "models": {
        "auto": {
          "name": "OptiWaves Auto",
          "reasoning": true,
          "limit": { "context": 500000, "output": 65536 },
          "options": { "reasoningEffort": "medium" }
        }
      }
    }
  }
}

@ai-sdk/openai 使用 Responses；{env:OPTIWAVES_API_KEY} 由 OpenCode 读取环境变量。这里不用再把密钥写进 opencode.json。

OpenCode 2.x 使用另一套 providers / package / settings 配置结构；本页的 provider / npm / options 属于 1.x。先运行 opencode --version 确认版本，2.x 用户按对应版本的 provider 文档配置。

3. 启动并验证

opencode --model optiwaves/auto --agent plan

进入后用 /models 查看 OptiWaves Auto，并发送一个简短的文本问题。后续对话操作见用 OpenCode 开始对话。

4. 添加 Fast 模型

在 provider.optiwaves.models 中增加一个模型条目：

{
  "auto-fast": {
    "name": "OptiWaves Auto Fast",
    "limit": { "context": 500000, "output": 65536 }
  }
}

将这个对象的条目合入 models，保留原有 auto 条目。随后重启并运行：

opencode --model optiwaves/auto-fast --agent plan

Fast 的开启方式与消耗见 Fast 模式。

常见问题

情况	检查
找不到 `optiwaves/auto`	provider ID 与模型 ID 是否分别为 `optiwaves`、`auto`，配置文件是否被读取
密钥为空	启动终端是否设置 `OPTIWAVES_API_KEY`；缺失变量会被替换为空值
实际使用了另一份配置	检查项目配置、用户配置与 `OPENCODE_CONFIG` 的优先级

参考 OpenCode 1.x provider 配置和配置文件说明。返回客户端选择。

本地记忆

API 接通后，可用 OptiWaves CLI 为这个客户端配置本地记忆：

optiwaves memory --client opencode

重启客户端后，用一次保存和一次新会话召回检查结果。具体路径与限制见本地记忆。