OpenCode 配置手册

本文档详细介绍如何通过 Anthropic API 兼容接口，在 opencode 中调用 OspreyAI平台提供的大语言模型（如 glm-4.6-fp8、deepseek-r1-0528 等）。

项目地址：https://github.com/sst/opencode官方安装脚本：curl -fsSL https://opencode.ai/install | bash

---

一、安装方式

1. macOS / Linux（官方一键安装）

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

2. Windows 安装方式

✅ 推荐方式：使用 PowerShell + 官方脚本（需启用 TLS 1.2）

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
iwr https://opencode.ai/install.ps1 -UseBasicParsing | iex

💡 该脚本会自动下载 Windows 版二进制并加入 PATH。

其他可选方式：

通过 npm（需已安装 Node.js）

npm install -g opencode-ai

通过 Bun（需先安装 Bun）

bun install -g opencode-ai

⚠️ 目前 不支持 Homebrew（仅 macOS），Windows 用户请勿使用 brew。

3. 验证安装（所有平台通用）

opencode --version

4.DeskTOP安装

请前往https://opencode.ai/download 地址下载安装包进行安装

---

二、配置文件位置（含 Windows）

OpenCode 按优先级加载以下位置的配置（高 → 低）：

平台	项目级配置	全局配置路径（推荐）
Windows	.\opencode.json 或 .jsonc	%USERPROFILE%\.config\opencode\opencode.json
macOS/Linux	./opencode.json	~/.config/opencode/opencode.json

🔧 在 Windows 中，全局配置目录通常为：C:\Users\<你的用户名>\.config\opencode\

你可以手动创建该目录并放入 opencode.json。

---

三、基础配置结构（跨平台通用）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    // 各 LLM 提供商配置
  }
}

---

四、配置示例

{
  "$schema":"https://opencode.ai/config.json",
  "provider":{
    "anthropic":{
      "options":{
        "baseURL":"https://open.ospreyai.cn/v1",
        "apiKey":"YOUR_API_KEY"
      },
      "models":{
        "glm-4-latest":{
          "name":"glm-4-latest"
        },
        "minimax-m2-latest":{
          "name":"minimax-m2-latest"
        }
      }
    }
  }
}

五、opencode使用

启动opencode

在命令行中进入项目目录，执行以下命令启动：

opencode

切换模型

再对话框中输入 /models，回车之后，输入你在配置中输入的模型（例如：glm-4-latest）检索， 检索成功后，选择模型即可开始对话。

注：更多内容请查看opencode 官方文档