OpenCode

准备 API

在配置之前，请确保已获取以下信息

API Key

以 sk- 开头的字符串。

Base URL (接口地址)

地址：https://api.magikcloud.cn/v1

重要：务必包含末尾的 /v1

模型名称

请在模型广场复制完整模型名称，如：DeepSeek-V4-Pro

---

安装 OpenCode

通过 OpenCode 官网 下载并安装。

macOS / Linux / WSL：

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

也可通过 npm 安装（需 Node.js）：

npm install -g opencode-ai

安装完成后，运行 opencode --version 验证是否安装成功。

---

接入 OpenCode

1. 添加 API Key

在 OpenCode 终端界面中运行 /connect 命令：

1. 滚动到底部，选择 Other
2. 输入 Provider ID，建议填写 magik
3. 粘贴你的 API Key（以 sk- 开头）

2. 编辑配置文件

编辑全局配置文件 ~/.config/opencode/opencode.json（若不存在则新建）：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "magik/GLM-5.1",
  "provider": {
    "magik": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MagikCloud",
      "options": {
        "baseURL": "https://api.magikcloud.cn/v1"
      },
      "models": {
        "GLM-5.1": {
          "name": "GLM-5.1"
        },
        "DeepSeek-V4-Pro": {
          "name": "DeepSeek-V4-Pro"
        },
        "MiniMax-M2.7": {
          "name": "MiniMax-M2.7"
        }
      }
    }
  }
}

注意： provider 中的 key（如 magik）必须与 /connect 时填写的 Provider ID 一致。models 中的 key 必须与 MagikCloud 模型广场中的模型名称完全一致。

关键字段说明

字段	说明
model	默认模型，格式为 provider_id/模型名称（如 magik/GLM-5.1）
npm	SDK 适配器，OpenAI 兼容接口使用 @ai-sdk/openai-compatible
name	Provider 在界面中的显示名称
options.baseURL	接口地址，需包含 /v1
models	可用模型列表，key 为 API 请求中的 model 字段值

3. 选择模型

保存配置后重启 OpenCode，运行 /models 查看并选择已配置的模型。

切换模型

• 在 TUI 中运行 /models 切换当前会话使用的模型
• 或修改 opencode.json 中的 model 字段更改默认模型

使用模型

在项目目录下运行 opencode 启动，选择 MagikCloud 上的模型即可开始使用。