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

【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（最推荐一键方式）

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

安装完成后验证：

opencode --version

如果提示 command not found，加 PATH：

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

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

进入你的项目目录，创建 opencode.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 后保存，直接运行：

opencode 

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