【2026 最新】Mac 上手 OpenCode 完整安装指南（火山豆包 + 自定义模型）

Zhijun.li@Studio2026-03-11 22:21

【2026 最新】Mac 上手 OpenCode 完整安装指南（火山豆包 + 自定义模型）

最近把 OpenCode 折腾通了，感觉比 Claude Code 更香（开源、免费额度高、模型随便接），特意写下这篇保姆级教程。

OpenCode 是什么？

OpenCode 是目前最强悍的开源终端 AI 编程助手之一（类似 Cursor、Claude Code、Aider 的结合体），它运行在终端里，支持：

多模型接入（Claude、GPT、Gemini 等）
项目上下文记忆（自动读懂整个代码库）
技能系统（联网搜索、文件操作、提醒事项等）
TUI + Web 双界面
完全本地化配置，无需订阅

它最大的亮点是模型兼容性极强，国内用户可以用火山引擎的豆包 Seed 2.0 系列（256k 上下文、深度思考、代码能力强），免费额度也够日常开发用。

我用了几天后，基本把 Claude Code 替换掉了，分享一下 Mac 上的完整安装 + 配置流程。

一、安装 OpenCode（最推荐一键方式）

bash 复制代码

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

安装完成后验证：

bash 复制代码

opencode --version

如果提示 command not found，加 PATH：

bash 复制代码

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

二、配置豆包模型（火山 Ark）

进入你的项目目录，创建 opencode.json：

json 复制代码

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ark": {
      "npm": "@ai-sdk/openai",
      "name": "火山引擎 Ark",
      "options": {
        "baseURL": "https://ark.cn-beijing.volces.com/api/v3",
        "apiKey": "你的火山完整 apiKey"
      },
      "models": [
        {
          "id": "doubao-seed-2-0-pro-260215",
          "name": "豆包 Seed 2.0 Pro",
          "contextWindow": 256000,
          "maxTokens": 128000
        },
        {
          "id": "doubao-seed-2-0-code-preview-260215",
          "name": "豆包 Seed 2.0 Code Preview",
          "contextWindow": 256000,
          "maxTokens": 128000
        }
      ]
    }
  },
  "model": "ark/doubao-seed-2-0-pro-260215"
}

替换 apiKey 后保存，直接运行：

bash 复制代码

opencode

进入 TUI 界面就可以开始用了！