开源终端 AI 编程工具 Opencode

开源 AI 编程 Agent。

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

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

# Package managers
npm i -g opencode-ai@latest        # or bun/pnpm/yarn
scoop install opencode             # Windows
choco install opencode             # Windows
brew install anomalyco/tap/opencode # macOS and Linux (recommended, always up to date)
brew install opencode              # macOS and Linux (official brew formula, updated less)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-bin               # Arch Linux (Latest from AUR)
mise use -g opencode               # Any OS
nix run nixpkgs#opencode           # or github:anomalyco/opencode for latest dev branch

安装前，请先移除低于 0.1.x 的版本。

OpenCode 也提供桌面应用。你可以直接从 releases 页面或 opencode.ai/download 下载。

# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop

安装脚本会按照以下优先级确定安装路径：

$OPENCODE_INSTALL_DIR——自定义安装目录

$XDG_BIN_DIR——符合 XDG Base Directory Specification 的路径

$HOME/bin——标准用户二进制文件目录（如果该目录已存在或可以创建）

$HOME/.opencode/bin——默认备用路径

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

OpenCode 内置了两个 Agent，你可以使用 Tab 键在它们之间切换。

build——默认 Agent，拥有完整访问权限，适用于开发工作

plan——只读 Agent，适用于分析和代码探索。默认禁止编辑文件；运行 bash 命令前会请求许可；非常适合探索陌生代码库或规划变更。

默认禁止编辑文件

运行 bash 命令前会请求许可

非常适合探索陌生代码库或规划变更

此外，OpenCode 还内置了一个 general subagent，用于处理复杂搜索和多步骤任务。它会在内部使用，也可以在消息中通过 @general 调用。

进一步了解 Agent。

如需了解如何配置 OpenCode，请前往我们的文档。

如果你有兴趣为 OpenCode 做贡献，请在提交 pull request 前阅读我们的贡献文档。

如果你正在开发一个与 OpenCode 相关的项目，并在项目名称中使用了「opencode」，例如「opencode-dashboard」或「opencode-mobile」，请在 README 中添加说明，明确该项目并非由 OpenCode 团队开发，也与我们没有任何关联。

加入我们的社区：Discord | X.com