OpenCode 接入第三方 API 快速教程：opencode.json Provider 配置

安装 OpenCode 后，通过 opencode.json 注册第三方 Provider，配置 baseURL、API Key 和模型列表，在终端中使用 AI 结对编程。

OpenCode 是一个终端里的 AI 编程工具。它可以通过 provider 配置接入 OpenAI 兼容接口，因此也能使用 NixAPI 提供的多模型能力。

这篇教程会完成三件事：安装 OpenCode，注册 NixAPI Provider，配置默认模型并启动验证。

准备工作

先确认本机有 Node.js 18 或更高版本：

node -v

再准备一个 NixAPI API Key。可以在 NixAPI 控制台创建。模型列表建议从 NixAPI 支持的模型列表页复制。

第一步：安装 OpenCode

使用 npm 安装：

npm install -g opencode-ai

macOS / Linux 也可以使用安装脚本：

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

验证安装：

opencode -v

能看到版本号即可继续。

第二步：注册自定义 Provider

运行登录命令：

opencode auth login

按提示操作：

服务商列表中选择 other
Provider ID 输入 nixapi
API Key 输入你的 NixAPI API Key

Provider ID 建议只用小写字母和数字。后面的配置文件会引用这个 ID，必须保持一致。

第三步：编辑 opencode.json

配置文件位置通常是：

macOS / Linux：~/.config/opencode/opencode.json
Windows：C:\Users\你的用户名\.config\opencode\opencode.json

写入或合并下面的配置：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "nixapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "NixAPI",
      "options": {
        "baseURL": "https://nixapi.com/v1",
        "apiKey": "nix-your-api-key"
      },
      "models": {
        "claude-opus-4-7": {
          "name": "Claude Opus 4.7",
          "limit": {
            "context": 200000,
            "output": 32768
          }
        },
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
          "limit": {
            "context": 200000,
            "output": 16384
          }
        },
        "gpt-5.4": {
          "name": "GPT 5.4",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        }
      }
    }
  },
  "model": "nixapi/claude-sonnet-4-20250514"
}

关键点：

nixapi 要和 opencode auth login 时输入的 Provider ID 一致
baseURL 填 https://nixapi.com/v1
apiKey 换成真实 NixAPI API Key
顶层 model 格式是 provider-id/model-id

如果你不想在配置文件里直接写 Key，可以查看 OpenCode 的认证存储方式，继续使用 opencode auth login 保存的密钥。上面的写法更直观，适合首次排查。

第四步：启动并验证

进入项目目录：

cd your-project
opencode

启动后输入：

/models

确认列表中能看到 NixAPI Provider 下的模型。然后发一个简单任务：

请阅读当前目录结构，并给出适合新手的项目说明。

如果正常返回，说明 OpenCode 已通过 NixAPI 调用模型。

添加更多模型

想扩展模型时，在 models 里继续增加条目。例如：

"deepseek-v4": {
  "name": "DeepSeek V4",
  "limit": {
    "context": 128000,
    "output": 8192
  }
},
"gemini-3-pro-preview": {
  "name": "Gemini 3 Pro Preview",
  "limit": {
    "context": 1000000,
    "output": 8192
  }
}

上下文和输出限制请按你实际使用的模型调整。模型 ID 和价格以 NixAPI 模型价格页为准。

常见问题

1. 启动后看不到模型

确认 opencode.json 是合法 JSON。多余逗号、漏引号、括号不配对都会导致配置加载失败。

2. 报 401

API Key 错误或没有被正确读取。可以重新运行：

opencode auth login

也可以检查配置中的 apiKey 是否为 NixAPI 控制台创建的 Key。

3. 报 404 或连接失败

确认 baseURL 是：

"baseURL": "https://nixapi.com/v1"

4. 修改配置后没有生效

退出 OpenCode 后重新启动。很多终端工具不会在运行中自动重新读取配置文件。

5. 如何控制成本？

为日常任务配置一个性价比较高的默认模型，把复杂任务再切到更强模型。正式使用前可以查看 NixAPI 模型价格页。NixAPI 当前有限时充值兑换率：￥0.80 = $1.00。

小结

OpenCode 接入 NixAPI 的核心是注册 nixapi Provider，并在 opencode.json 中配置 @ai-sdk/openai-compatible、https://nixapi.com/v1 和模型列表。配置完成后，你可以在终端中通过 OpenCode 使用 NixAPI 的多模型能力。

OpenCode 接入第三方 API 快速教程：配置 openai-compatible Provider