OpenCode 接入 Nbility

OpenCode 是一个终端导向的 AI 编程工具。如果你想让它走 Nbility 的接口，可以通过环境变量加配置文件的方式完成接入。

安装 OpenCode

你可以根据自己的平台选择安装命令：

npm install -g opencode-ai@latest

brew install opencode

scoop install opencode

准备令牌

先前往 /console/token 创建 API Key，并确保该令牌仍然可用。

配置环境变量

建议先把令牌放进环境变量中：

export NBility_TOKEN=sk-xxx

$env:NBility_TOKEN="sk-xxx"

这里的 sk-xxx 需要替换为你自己的 Nbility Token。

编写 opencode.json

在项目根目录，或者 ~/.config/opencode/ 目录下创建 opencode.json。如果你希望同时接入 Claude 和 GPT 两组模型，可以参考下面的写法：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "nbility-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "nbility-anthropic",
      "options": {
        "baseURL": "https://api.nbility.dev",
        "apiKey": "{env:NBility_TOKEN}"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "claude-sonnet-4-6"
        }
      }
    },
    "nbility-openai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "nbility-openai",
      "options": {
        "baseURL": "https://api.nbility.dev/v1",
        "apiKey": "{env:NBility_TOKEN}"
      },
      "models": {
        "gpt-5.2-codex": {
          "name": "gpt-5.2-codex"
        }
      }
    }
  }
}

重要: 示例中的环境变量名和值需要与你本机实际配置保持一致，尤其是 Token 不能保留为占位内容。

启动方式

配置完成后，进入项目目录直接运行：

cd my-project
opencode

进入界面后，选择你刚才定义的 Nbility provider 和模型即可开始对话或编码。

建议

• 如果你只用一组模型，可以先删掉另一组 provider，减少干扰
• 配置失败时，先检查环境变量是否已在当前 shell 会话中生效
• 想快速排查问题时，可以先从一个最简单的模型配置开始，再逐步补全