安装与更新
选择脚本、包管理器或二进制安装 OpenCode，并区分 Windows 与 WSL。
OpenCode 提供终端、桌面和 IDE 入口。本页先安装终端 CLI；开始使用前还需要适合的终端环境与模型服务凭据。
选择安装渠道
| 渠道 | 官方命令 |
|---|---|
| 安装脚本 | curl -fsSL https://opencode.ai/install | bash |
| npm | npm install -g opencode-ai |
| Bun | bun install -g opencode-ai |
| pnpm | pnpm install -g opencode-ai |
| Yarn | yarn global add opencode-ai |
| Homebrew | brew install anomalyco/tap/opencode |
| Arch Linux 稳定包 | sudo pacman -S opencode |
| Arch Linux AUR | paru -S opencode-bin |
官方推荐 OpenCode 自己的 Homebrew tap，以更及时获取发布；Homebrew 团队维护的 brew install opencode 更新频率较低。也可从官方仓库 Releases 下载对应二进制。
选择一种适合现有环境的渠道即可，不需要逐条安装。上表的 Bun 方式不应直接套用到 Windows 原生环境，官方说明 Windows Bun 安装支持仍在进行中。
Windows 原生与 WSL
官方建议 Windows 用户优先使用 WSL，以获得更好的文件系统性能、终端支持和开发工具兼容性。WSL 内按 Linux 环境安装，具体见Windows 与 WSL。
原生 Windows 的官方安装选择包括：
choco install opencode也可以选择 scoop install opencode 或 npm install -g opencode-ai。Intro 还列出 Mise 的 mise use -g github:anomalyco/opencode 与容器方式 docker run -it --rm ghcr.io/anomalyco/opencode；容器本身不自动获得你的项目目录。
启动并连接模型
进入工作项目后运行：
opencode在 TUI 使用 /connect 选择提供商并完成凭据配置。官方 Zen 流程需要登录、填写计费信息、复制 API Key 后粘贴；如果使用其他提供商，则按对应提供商的设置完成连接。
首次任务流程见快速上手。本页不固定推荐某个模型版本，也不把安装成功等同于模型账户已经可用。
更新或卸载
官方排障页使用 opencode upgrade 更新 CLI，使用 opencode uninstall 卸载。卸载命令会显示将移除的内容并要求确认；保留配置和数据的具体选项应查 CLI 参考，不能将卸载视为只删除一个可执行文件。
桌面应用通过操作系统的应用管理工具卸载。连接失败或启动异常时，先阅读故障排查收集日志。