跨平台开源 AI 编程助手,提供桌面客户端和多端安装方式,支持 curl/npm/brew/pacman 等多种安装渠道,已支持多语言界面。
开源 AI 编程代理。

# YOLO
curl -fsSL https://opencode.ai/install | bash
# 包管理器
npm i -g opencode-ai@latest # 或 bun/pnpm/yarn
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS 和 Linux(推荐,始终最新)
brew install opencode # macOS 和 Linux(官方 brew formula,更新较慢)
sudo pacman -S opencode # Arch Linux(稳定版)
paru -S opencode-bin # Arch Linux(AUR 最新版)
mise use -g opencode # 任意操作系统
nix run nixpkgs#opencode # 或 github:anomalyco/opencode 获取最新开发分支
安装前请先移除 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 - 默认备选方案
# 示例
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 命令前会请求许可
适合探索不熟悉的代码库或规划改动
此外还有一个通用的子 Agent,用于复杂搜索和多步骤任务。此 Agent 供内部使用,可通过消息中的 @general 来调用。
了解更多关于 Agent 的信息。
更多配置 OpenCode 的信息,请查阅我们的文档。
如果你有意为 OpenCode 做贡献,请在提交 pull request 前阅读我们的贡献文档。
如果你的项目与 OpenCode 相关,并且在其名称中使用了 "opencode",例如 "opencode-dashboard" 或 "opencode-mobile",请在你的 README 中添加说明,明确指出它并非由 OpenCode 团队构建,也与我们没有任何关联。
加入我们的社区 Discord | X.com