安装 OpenCode

本节介绍 OpenCode 命令行工具在 macOS、Linux 和 Windows 上的安装方式。

文档核验：2026-10-06，依据官方安装文档↗。本文未在各平台执行安装测试，也不将固定版本号作为安装成功的标准。

# 安装前准备#

使用现代终端，并确保能访问所选安装源。使用云端模型还需要连接对应提供商；安装 CLI 本身不代表已经完成模型认证。

# macOS 和 Linux：Homebrew#

已安装 Homebrew 的用户，可以使用官方文档推荐的 OpenCode tap：

bash
brew install anomalyco/tap/opencode

anomalyco/tap/opencode 由 OpenCode 项目维护，官方推荐它以更及时地获得新版本。brew install opencode 也是有效安装方式，对应 Homebrew 团队维护的 formula，更新可能较慢。两者是不同维护渠道，不应把后者写成无效命令，也不要为追求版本号直接重复安装。

# macOS 和 Linux：安装脚本#

官方还提供安装脚本：

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

运行前可查看脚本内容。若出现权限问题，先检查具体报错及目标目录权限，不要直接给整段下载和执行命令加上 sudo。

# 使用 npm#

已安装 Node.js/npm 时，也可选择：

bash
npm install -g opencode-ai

这是另一种安装方式，通常选择一个渠道即可。其他包管理器用法见官方安装文档↗。

# Windows#

官方推荐通过 WSL 获得更好的兼容性。在 WSL 中打开 Linux 终端后，可使用上面的 Linux 安装方式。

如果使用 Windows 原生终端，官方文档列出了 Chocolatey、Scoop 和 npm 等方式；例如，已经安装 Chocolatey 或 Scoop 时，分别使用：

powershell
choco install opencode

powershell
scoop install opencode

也可从 GitHub Releases↗ 下载与你的系统和架构匹配的文件，解压后将可执行文件所在目录加入 PATH。本次核验的官方安装页未列出旧教程中的 winget install opencode，因此这里不再将它作为推荐步骤。

# Arch Linux#

官方文档区分稳定渠道与 AUR 渠道：

bash
# 稳定渠道
sudo pacman -S opencode

bash
# AUR 渠道，需要先安装 paru
paru -S opencode-bin

# 验证安装#

安装完成后，重新打开终端并运行：

bash
opencode --version
opencode --help

确认能显示实际安装版本及帮助信息即可，不要与旧教程的 1.0.0 示例做字符串匹配。升级前可在 Releases↗ 查看版本说明；不同安装渠道到达同一版本的时间可能不同。

如果提示 command not found，检查安装日志、可执行文件位置及 PATH。若机器上曾通过多个渠道安装，先确认当前终端调用的是哪一份程序，再按对应渠道维护。

# 下一步#

前往首次配置，连接提供商并选择模型。