开源AI编程代理。
英文 | 简体中文 | 繁體中文 | 한국어 | 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
# 包管理器
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公式，更新频率较低）
sudo pacman -S opencode # Arch Linux（稳定版）
paru -S opencode-bin # Arch Linux（来自AUR的最新版）
mise use -g opencode # 任何操作系统
nix run nixpkgs#opencode # 或 github:anomalyco/opencode 用于最新开发分支
[!TIP] 安装前请移除0.1.x之前的版本。
桌面应用（BETA）
OpenCode也提供桌面应用程序版本。直接从发布页面或opencode.ai/download下载。
| 平台 | 下载 |
|---|---|
| macOS (Apple Silicon) | opencode-desktop-darwin-aarch64.dmg |
| macOS (Intel) | opencode-desktop-darwin-x64.dmg |
| Windows | opencode-desktop-windows-x64.exe |
| Linux | .deb, .rpm, 或 AppImage |
# 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基础目录规范的路径$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包含两个内置代理，您可以使用Tab键在它们之间切换。
- build - 默认代理，用于开发工作的全权限代理
- plan - 只读代理，用于分析和代码探索
- 默认禁止文件编辑
- 运行bash命令前会请求权限
- 非常适合探索不熟悉的代码库或规划变更
此外还包含一个general子代理，用于复杂搜索和多步骤任务。
该代理用于内部调用，可以在消息中使用@general来触发。
了解更多关于代理的信息。
文档
如需了解如何配置OpenCode的更多信息，请访问我们的文档。
贡献
如果您有兴趣为OpenCode做出贡献，请在提交pull request前阅读我们的贡献文档。
基于OpenCode开发
如果您正在开发与OpenCode相关的项目，并且项目名称包含"opencode"（例如"opencode-dashboard"或"opencode-mobile"），请在您的README中添加说明，澄清该项目并非由OpenCode团队开发，且与OpenCode无任何关联。
常见问题解答
这与Claude Code有什么不同？
在功能方面，它与Claude Code非常相似。以下是主要区别：
- 100%开源
- 不与任何特定提供商绑定。虽然我们推荐通过OpenCode Zen提供的模型，但OpenCode可以与Claude、OpenAI、Google或本地模型一起使用。随着模型的发展，它们之间的差距将逐渐缩小，价格也会下降，因此保持提供商无关性非常重要。
- 开箱即用的LSP支持
- 专注于TUI。OpenCode由neovim用户和terminal.shop的创建者开发；我们将推动终端可能达到的极限。
- 客户端/服务器架构。例如，这允许OpenCode在您的电脑上运行，同时您可以通过移动应用远程控制它，这意味着TUI前端只是可能的客户端之一。