开源的AI编码助手。

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

# 包管理器
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

安装目录

安装脚本会按照以下优先级选择安装路径：

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/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

代理

OpenCode 内置两个代理，可通过 Tab 键切换。

• build - 默认代理，具有完全访问权限，适用于开发工作
• plan - 只读代理，用于代码分析和探索
  • 默认拒绝文件编辑
  • 在执行 bash 命令前会请求许可
  • 非常适合探索不熟悉的代码库或规划更改

此外，还包含一个用于复杂搜索和多步骤任务的 general 子代理。该子代理在内部使用，可在消息中通过 @general 调用。

更多关于 代理 的信息，请参阅文档。

文档

如需了解更多关于 OpenCode 配置的信息，请 前往我们的文档。

贡献

如果您有兴趣为 OpenCode 做贡献，请在提交拉取请求前阅读我们的 贡献文档。

基于 OpenCode 构建

如果您正在开发与 OpenCode 相关的项目，并且名称中包含“opencode”，例如“opencode-dashboard”或“opencode-mobile”，请在 README 中注明该软件并非由 OpenCode 团队开发，也与我们没有任何关联。

常见问题

这与 Claude Code 有何不同？

在功能上与 Claude Code 非常相似。以下是主要区别：

• 100% 开源
• 不绑定任何特定提供商。尽管我们推荐通过 OpenCode Zen 提供的模型，但 OpenCode 也可以与 Claude、OpenAI、Google 甚至本地模型一起使用。随着模型技术的进步和价格的下降，跨平台兼容性将变得越来越重要。
• 开箱即用的 LSP 支持
• 专注于 TUI。OpenCode 由 Neovim 用户和 terminal.shop 的创建者开发；我们将不断突破终端环境的可能性。
• 客户端/服务器架构。例如，这使得 OpenCode 可以在您的计算机上运行，而您可以通过移动应用远程控制它，这意味着 TUI 前端只是众多可能客户端之一。

---

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

OpenCode 快速上手指南

OpenCode 是一款开源的 AI 编程助手（Coding Agent），支持终端界面（TUI）和桌面应用，具备多模型兼容性和内置 LSP 支持。

环境准备

• 操作系统：macOS、Linux 或 Windows。
• 前置依赖：
  • 推荐使用包管理器进行安装（如 brew, npm, scoop 等）。
  • 若使用一键脚本安装，需确保系统已安装 curl 和 bash。
  • 注意：安装前请移除旧版本（0.1.x 及以下）。

安装步骤

您可以选择以下任意一种方式进行安装：

方式一：一键脚本安装（推荐）

适用于大多数 Linux 和 macOS 环境。

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

自定义安装路径示例：

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

方式二：包管理器安装

macOS (Homebrew - 推荐)

brew install anomalyco/tap/opencode

Node.js 环境 (npm/yarn/pnpm/bun)

npm i -g opencode-ai@latest

Windows (Scoop)

scoop install opencode

Windows (Chocolatey)

choco install opencode

Arch Linux

sudo pacman -S opencode
# 或使用 AUR 获取最新版
paru -S opencode-bin

桌面版应用 (Beta)

如需图形化界面，可下载桌面客户端：

• 下载地址：opencode.ai/download
• macOS (Homebrew Cask):

  brew install --cask opencode-desktop
  

• Windows (Scoop):

  scoop bucket add extras; scoop install extras/opencode-desktop
  

基本使用

安装完成后，在终端输入 opencode 即可启动。

1. 启动与模式切换

OpenCode 内置了两种主要代理模式，可通过 Tab 键快速切换：

• build (默认模式)：全权限代理，用于实际开发工作，可编辑文件和执行命令。
• plan (只读模式)：用于代码分析和探索。默认禁止修改文件，执行 Bash 命令前会请求许可。适合熟悉陌生代码库或规划变更。

2. 简单交互示例

启动后，直接在提示符后输入自然语言指令即可：

opencode

(进入交互界面后)

> 帮我在这个项目中创建一个简单的 Python HTTP 服务器

3. 调用子代理

对于复杂的搜索或多步骤任务，可以在消息中通过 @general 调用通用子代理：

> @general 分析当前项目的依赖结构并生成优化建议

更多配置详情和高级用法，请访问官方文档：opencode.ai/docs