OpenCode

安装

OpenCode 提供多种安装方式，涵盖一键脚本、主流包管理器以及各 Linux 发行版。

# 一键安装脚本
curl -fsSL https://opencode.ai/v2/install | bash

# 包管理器
npm i -g @opencode/cli@latest        # npm / bun / pnpm / yarn
brew install anomalyco/tap/opencode-v2 # macOS 与 Linux 推荐渠道
brew install opencode                  # 官方 Home formulae（更新较慢）
sudo pacman -S opencode                # Arch Linux 稳定版
paru -S opencode-beta                  # Arch Linux AUR 最新版
mise use -g opencode                   # 跨平台通用方案
nix run github:anomalyco/opencode      # Nix

升级前请先卸载 0.1.x 之前的旧版本。

安装路径优先级

安装脚本按以下顺序选择目标目录：

1. $OPENCODE_INSTALL_DIR：自定义路径
2. $XDG_BIN_DIR：遵循 XDG 目录规范
3. $HOME/bin：标准用户二进制目录
4. $HOME/.opencode/bin：默认兜底

OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/v2/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/v2/install | bash

桌面应用（BETA）

OpenCode 也提供桌面客户端，可从 opencode.ai/download 下载，覆盖 macOS（Apple Silicon / Intel）、Windows 与 Linux（.deb、.rpm、.AppImage）。macOS 用户也可通过 Homebrew Cask 安装：

brew install --cask opencode-desktop

内置 Agent

OpenCode 提供两个可通过 Tab 键切换的内置 Agent：

• build：默认 Agent，具备完整权限，适用于日常开发。
• plan：只读 Agent，默认禁止修改文件，执行 Bash 前需确认，适合探索陌生代码库或制定改动计划。

此外内置一个 general 子 Agent，用于处理复杂搜索与多步任务。可在消息中使用 @general 显式调用。更多细节见官方文档中的 agents 章节。

文档与社区

完整配置说明、TUI 操作与高级用法请查阅官方文档。

如需贡献代码，请在提交 PR 前阅读 CONTRIBUTING.md。涉及以 "opencode" 命名的衍生项目，请在 README 中注明其与官方团队无关、非官方出品。

基于 OpenCode 的项目

若项目名包含 "opencode"（如 opencode-dashboard、opencode-mobile），请在仓库说明中明确标注该项目的来源与独立性。

桌面端下载清单