Source: https://wiki.niceai.dev/guide/clients/opencode

# OpenCode 接入自定义 API

在 OpenCode 的配置文件 `opencode.jsonc` 里添加一个自定义供应商，协议选 OpenAI 兼容，`baseURL` 填 `https://api.niceai.dev/v1`，密钥通过环境变量 `NICEAI_API_KEY` 提供，然后用 `/models` 选择模型即可。

## 准备工作

1. 安装 OpenCode（参考其官方文档）。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组按要用的模型选择。

## 配置步骤

1. 设置密钥环境变量：

   ::: code-group

   ```bash [macOS / Linux]
   export NICEAI_API_KEY="sk-你的密钥"
   ```

   ```powershell [Windows PowerShell]
   [Environment]::SetEnvironmentVariable("NICEAI_API_KEY", "sk-你的密钥", "User")
   ```

   :::

2. 编辑 OpenCode 配置文件 `opencode.jsonc`（全局配置或项目根目录均可），加入：

   ```jsonc
   {
     "$schema": "https://opencode.ai/config.json",
     "providers": {
       "niceai": {
         "name": "NiceAI",
         "env": ["NICEAI_API_KEY"],
         "package": "@opencode/ai/providers/openai-compatible",
         "settings": {
           "baseURL": "https://api.niceai.dev/v1"
         },
         "models": {
           "<模型名，见模型广场>": { "name": "<显示名称>" }
         }
       }
     }
   }
   ```

3. 重新启动 OpenCode，输入 `/models`，选择 `niceai/<模型名>`。

**不同版本的配置写法不同**
上面的写法来自 OpenCode 当前的官方文档。较早的版本使用 `provider`、`npm: "@ai-sdk/openai-compatible"` 和 `options.baseURL` 等字段。如果配置不生效，请对照你所用版本的官方文档调整字段名，`baseURL` 的值保持 `https://api.niceai.dev/v1` 不变。


## 验证

选好模型后随便问一句，能正常回复即接入成功；控制台使用记录里也能看到这次请求。

## 常见问题

### `/models` 里看不到 niceai？

检查 `NICEAI_API_KEY` 是否在启动 OpenCode 的终端里生效，以及 JSON 是否有语法错误（多余或缺少逗号）。

### 返回 404？

`baseURL` 要以 `/v1` 结尾。见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### 工具调用报错？

OpenCode 是 Agent 类工具，依赖模型的工具调用能力，换用支持工具调用的模型。

## 下一步

- [Aider 接入](https://wiki.niceai.dev/guide/clients/aider)
- [Kilo Code 接入](https://wiki.niceai.dev/guide/clients/kilo-code)
