

# YOLO
curl -fsSL https://opencode.ai/install | bash
# Package managers
npm i -g opencode-ai@latest # or bun/pnpm/yarn
scoop bucket add extras; scoop install extras/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)
paru -S opencode-bin # Arch Linux
mise use-g opencode # Any OS
nix run nixpkgs#opencode # or github:anomalyco/opencode for latest dev branch
在安装之前,请移除 0.1.x 版本之前的旧版本。
OpenCode 也提供桌面应用程序。你可以直接从发布页面[1]下载,或者访问 opencode.ai/download[2] 进行下载。
下载链接# macOS(通过 Homebrew 安装)
brew install --cask 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 | bashOpenCode 包含两个内置代理,你可以通过 Tab 键在它们之间切换。
•build - 默认的,具有完全访问权限的代理,适用于开发工作•plan - 只读代理,适用于分析和代码探索•默认情况下拒绝文件编辑•执行 bash 命令之前需要授权•适合探索不熟悉的代码库或规划修改
另外,还包含一个通用子代理,用于复杂的搜索和多步骤任务。该子代理是内部使用的,可以通过在消息中输入 @general 来调用。
了解更多关于代理[3]的信息。
想要了解更多关于如何配置 OpenCode 的信息,请访问我们的文档[4]。
如果你有兴趣为 OpenCode 做出贡献,请在提交拉取请求之前阅读我们的贡献文档。
如果你正在开发与 OpenCode 相关的项目,并且在项目名称中使用了 "opencode" 作为一部分,比如 "opencode-dashboard" 或 "opencode-mobile";请在 README 文件中注明该项目不是由 OpenCode 团队开发的,并且与我们没有任何关联。
它在功能上与 Claude Code 非常相似。以下是主要的区别:
•100% 开源•不依赖于任何提供商。尽管我们推荐通过 OpenCode Zen[5] 提供的模型;OpenCode 可以与 Claude、OpenAI、Google 甚至本地模型一起使用。随着模型的演进,它们之间的差距会缩小,定价也会下降,因此支持多个提供商非常重要。•开箱即用的 LSP(语言服务器协议)支持•专注于 TUI(终端用户界面)。OpenCode 由 neovim 用户和 terminal.shop[6] 的创作者开发,我们将推动终端中可能的极限。•客户端/服务器架构。举例来说,这意味着 OpenCode 可以在你的电脑上运行,而你可以通过移动应用程序远程操作它。也就是说,TUI 前端只是其中一种可能的客户端。
https://github.com/anomalyco/opencode?tab=readme-ov-file[1] 发布页面:https://github.com/anomalyco/opencode/releases
[2]opencode.ai/download:https://opencode.ai/download
[3]代理:https://opencode.ai/docs/agents
[4]我们的文档:https://opencode.ai/docs
[5]OpenCode Zen:https://opencode.ai/zen
[6]terminal.shop: https://www.terminal.shop/