OpenCode配置教程 - 阡陌数智API文档

一、基本介绍
本文档说明如何将符合 OpenAI 接口规范的第三方 API 服务集成到 OpenCode 环境中。
如果你想在 OpenCode 中使用 Gemini 模型，可以尝试使用 Chat 格式，如果使用原生格式会报错不兼容。
二、环境准备
pnpm install -g @opencode/cli
三、CLI 凭证注册

1.
执行认证指令：opencode auth login
2.
选择类型：在列表中选中底部的 other
3.
定义 ID：输入一个自定义标识符（例如 local）
4.
录入密钥：输入你在阡陌数智平台上已创建的令牌密钥 API Key（sk-xxxx）

四、配置第三方 API
配置文件路径：

Windows: %USERPROFILE%.config\opencode\opencode.json

MacOS: ~/.config/opencode/opencode.json

Linux: ~/.config/opencode/opencode.json

配置模板：
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "local": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "local",
      "options": {
        "baseURL": "https://qmszai.cn/v1",
      },
      "models": {
        "gpt-4o": { "name": "gpt-4o" },
        "claude-sonnet-4-20250514": { "name": "claude-sonnet-4-20250514" }
      }
    }
  }
}

参数节点	说明
根键名 (local)	必须与 CLI 注册时的 Provider ID 完全一致（大小写敏感）
npm	固定使用 @ai-sdk/openai-compatible
baseURL	填写阡陌数智平台的 API 接口地址，通常需包含 /v1 后缀
models	需手动声明模型列表，键名需对应真实的 Model ID

五、加载与验证

opencode

# 在交互栏输入：
/models

若配置无误，你将在列表中看到自定义的阡陌数智平台及其模型。