macOS / Linux OpenCode 下载脚本安装

下载脚本后运行，终端会提示选择产品线组合；只需要粘贴你选择的 Key。

返回热门工具 改为复制命令
开始前先做这一步：先到 Key 管理 创建你要使用的产品线 Key。只用哪个产品线，就准备哪个产品线的 sk- Key。

1 下载脚本安装

点击下面按钮下载脚本，然后按“运行方式”执行。

下载 OpenCode macOS / Linux 脚本

脚本文件：opencode-setup.sh

脚本会按 1 → 2 → 3 自动执行；环境检测或任一步失败都会停止。请先修复提示问题后重新运行，不要跳过失败步骤继续下一步。

2 运行方式

运行方式
下载 opencode-setup.sh 后，打开终端输入 bash，后面空一格，再拖入脚本文件或粘贴脚本绝对路径。
环境要求
需要先安装 Node.js 18+。macOS 可到 nodejs.org/zh-cn/download 下载；Linux 可执行：curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs。

3 运行后怎么选（1-7）

脚本运行到第 3 步时，会显示下面这些选项。选几个产品线，就会让你粘贴几把 Key。

  • 1 Codex
  • 2 Claude Code
  • 3 Gemini
  • 4 Codex + Claude Code
  • 5 Codex + Gemini
  • 6 Claude Code + Gemini
  • 7 全部

完整说明

安装前确认

  • 需要先安装 Node.js 18+。macOS 可到 nodejs.org/zh-cn/download 下载；Linux 可执行：curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs。
  • 先到 Key 管理 创建你要使用的产品线 Key。
  • Codex / Claude Code / Gemini 三条产品线 Key 不通用，只填写你选择的产品线 Key。

脚本会做什么

  • 检查 Node.js / npm 是否可用。
  • 安装 opencode-ai。
  • 让你选择 1-7 产品线组合，并只提示填写所选产品线 Key。
  • 校验 Key 必须以 sk- 开头，避免把占位符写入配置。
  • 写入配置前会备份旧配置。

配置写入位置

配置文件
~/.config/opencode/opencode.json
写入规则
只写入你选择的 provider；想在 OpenCode 里切换多模型，就选择多产品线组合。

可用模型参考

  • Codex：gpt-5.4 / gpt-5.4-mini / gpt-5.3-codex-spark / gpt-5.3-codex
  • Claude Code：claude-sonnet-4-6 / claude-opus-4-7 / claude-opus-4-8
  • Gemini：gemini-2.5-flash / gemini-2.5-pro

安装完成后

重新打开终端后运行 opencode。

常见问题

  • 提示未安装 Node.js：先安装 Node.js 18+，再重新运行脚本。
  • 提示 Key 格式不对：确认填写的是本站创建的真实 sk- Key。
  • 写入后不生效：完全退出 OpenCode 和相关终端/编辑器后重新打开。