在 Mac 上安装 OpenCode 并接入豆包模型

OpenCode 简介

OpenCode 是一款开源的终端 AI 编程助手，定位有点像 Cursor 和 Claude Code 的中间形态。它跑在终端里，既有 TUI，也有 Web 界面，支持接入 Claude、GPT、Gemini 这类模型，还带了项目上下文记忆和一些常用技能，比如联网搜索、文件操作。

对国内用户来说，比较实用的一点是它能接火山引擎的豆包 Seed 2.0 系列。256k 上下文，代码能力也够用，免费额度拿来做日常开发、改小工具、查代码都比较省心。

安装 OpenCode

官方给的是一条命令安装：

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

装完先看版本，确认命令已经进来了：

opencode --version

如果这里报 command not found，通常不是安装失败，而是 PATH 没配好。Mac 上我一般直接把 ~/.local/bin 加进 zsh：

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

配置豆包模型（火山 Ark）

进入项目目录，新建一个 opencode.json。这里的配置是直接走火山 Ark，模型名也一并写进去：

{
  "$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"