README

开源的 AI Coding Agent。

  
  
  



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




---

 安装

bash
 直接安装 (YOLO)
curl -fsSL https://opencode.ai/v2/install | bash

 软件包管理器
npm i -g @opencode/cli@latest       也可使用 bun/pnpm/yarn
brew install anomalyco/tap/opencode-v2  macOS 和 Linux（推荐，始终保持最新）
brew install opencode               macOS 和 Linux（官方 brew formula，更新频率较低）
sudo pacman -S opencode             Arch Linux (Stable)
paru -S opencode-beta               Arch Linux (Latest from AUR)
mise use -g opencode                任意系统
nix run github:anomalyco/opencode   Nix


 [!TIP]
 安装前请先移除 0.1.x 之前的旧版本。

 桌面应用程序 (BETA)

OpenCode 也提供桌面版应用。可从 opencode.ai/download 下载。

| 平台                  | 下载文件                           |
| --------------------- | ---------------------------------- |
| macOS (Apple Silicon) | opencode-desktop-mac-arm64.dmg   |
| macOS (Intel)         | opencode-desktop-mac-x64.dmg     |
| Windows               | opencode-desktop-win-x64.exe     |
| Linux                 | .deb、.rpm 或 AppImage         |

bash
 macOS (Homebrew Cask)
brew install --cask opencode-desktop


 安装目录

安装脚本将 OpenCode 安装到 $HOME/.opencode/bin。

 Agents

OpenCode 内置两种 Agent，可用 Tab 键快速切换：

- build - 默认模式，具备完整权限，适合开发工作
- plan - 只读模式，适合代码分析与探索
  - 默认拒绝修改文件
  - 运行 bash 命令前会询问
  - 便于探索未知代码库或规划改动

另外还包含一个 general 子 Agent，用于复杂搜索和多步任务，内部使用，也可在消息中输入 @general 调用。

了解更多 Agents 相关信息。

 文档

更多配置说明请查看我们的 官方文档。

 参与贡献

如有兴趣贡献代码，请在提交 PR 前阅读 贡献指南 (Contributing Docs)。

 基于 OpenCode 进行开发

如果你在项目名中使用了 “opencode”（如 “opencode-dashboard” 或 “opencode-mobile”），请在 README 里注明该项目不是 OpenCode 团队官方开发，且不存在隶属关系。

---

加入我们的社区 飞书 | X.com

Top issues

Latest release

Core

 Bugfixes
- Failed TUI worker requests now return an error instead of leaving the caller hanging. (@Nowaker)

Thank you to 1 community contributor:
- @Nowaker:
  - fix(opencode): answer a failed TUI worker request instead of hanging (54936)