MNModel Nexus 使用文档
Model Nexus Docs

OpenCode 教程

OpenCode 是开源 AI 编程工具，适合希望用轻量配置接入不同模型的开发者。

OpenCode 能做什么

开源编程助手

OpenCode 可以在终端、桌面应用或编辑器里运行，帮你阅读项目、修改文件、解释报错和运行开发任务。它支持连接不同模型服务，适合想要轻量工具的人。

适合谁

如果你已经会打开项目目录、能按说明复制配置文件，OpenCode 是一个直接、轻量的选择。第一次使用建议先用 CC Switch 管理 key 和模型。

推荐 companion：CC Switch

为什么推荐

CC Switch 可以统一管理 OpenCode、Claude Code、Codex 等工具的供应商配置。你只需要保存一次 Model Nexus 地址、key 和模型名，再切换到 OpenCode 使用。

官网 ccswitch.ioGitHub 下载OpenCode 官网

不用 companion 也可以

OpenCode 自带连接流程。下面的配置文件适合想手动检查设置的人。

Windows / macOS / Linux 配置

  1. 从 OpenCode 下载页安装桌面版，或按官网说明安装命令行版。
  2. 打开 OpenCode，输入 /connect，选择 OpenAI 或 OpenAI-compatible。
  3. API Key 填你的 Model Nexus key。
  4. 如果需要手动配置，把下面内容保存到 OpenCode 的用户配置文件。
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/{{MODEL}}",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.modelnexus.net/v1"
      }
    }
  }
}
  1. 从 OpenCode 下载页安装桌面版，或在 Terminal 里按官网命令安装。
  2. 打开 OpenCode，输入 /connect，选择 OpenAI-compatible。
  3. API Key 填你的 Model Nexus key。
  4. 手动配置时，把同一份 JSON 保存到 ~/.config/opencode/opencode.json。
  1. 从 OpenCode 下载页安装桌面版，或在终端按官网命令安装。
  2. 打开 OpenCode，输入 /connect，选择 OpenAI-compatible。
  3. API Key 填你的 Model Nexus key。
  4. 手动配置时，把同一份 JSON 保存到 ~/.config/opencode/opencode.json。

常见问题

  • 401：重新复制 key，确认没有多余空格。
  • 404：OpenCode 这里使用 https://api.modelnexus.net/v1。
  • 模型不存在：确认 key 已开通你填写的模型。