Mac 安装 OpenCode 终端 AI 助手并配置火山豆包模型

OpenCode 简介

OpenCode 是一款开源终端 AI 编程助手，类似 Cursor、Claude Code 的结合体。它运行在终端里，支持多模型接入（如 Claude、GPT、Gemini 等）、项目上下文记忆、技能系统（联网搜索、文件操作等）以及 TUI + Web 双界面。

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

一、安装 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":