⌨️ OpenCode V1 安装指南

一句话总结：OpenCode 是开源 AI 编码代理（anomalyco/opencode，前身 sst/opencode）。V1 是稳定/经典版，主要入口是终端（CLI/TUI），没有独立的桌面版（桌面版是 V2 才有的）。本文整理 V1 命令行版的安装。

---

是什么

OpenCode 是一个开源的 AI 编码代理，提供终端界面、桌面应用和 IDE 扩展等多种使用方式。V1（经典版）以终端 TUI 为主。

🔑 V1 与 V2 的关系：当前正在向 OpenCode V2 演进（见 OpenCode V2 安装指南）。V1 是 npm opencode-ai@1.x 稳定版；V2 是新的 @opencode/cli + 桌面版。V1 和 V2 都用 opencode 命令，默认不并行安装，装 V2 前要移除 V1。

npm 版本现状：opencode-ai 的 latest tag 是 1.18.34（V1）。V2 走 dev 通道。

前置要求：

• 一款现代终端模拟器（WezTerm、Alacritty、Ghostty、Kitty）
• 你的 LLM 提供商的 API Key

---

安装（命令行版）

方式一：安装脚本（最简单）

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

方式二：包管理器

# npm / bun / pnpm / yarn
npm install -g opencode-ai
bun install -g opencode-ai
pnpm install -g opencode-ai
yarn global add opencode-ai

方式三：各平台原生

平台	命令
macOS / Linux（Homebrew）	brew install anomalyco/tap/opencode（推荐，更新及时）· brew install opencode（官方 formula，更新较慢）
Arch Linux	sudo pacman -S opencode（Stable）· paru -S opencode-bin（AUR 最新）
Windows（Chocolatey）	choco install opencode
Windows（Scoop）	scoop install opencode
任意 OS（Mise）	mise use -g github:anomalyco/opencode
Docker	docker run -it --rm ghcr.io/anomalyco/opencode

也可以从 Releases 直接下载二进制。

⚠️ Windows 建议用 WSL：获得最佳性能并完全兼容 OpenCode 全部功能。Windows 上通过 Bun 安装的支持仍在开发中。

---

初始化与使用

初始化项目

cd /path/to/project
opencode

进入 TUI 后运行 /init，OpenCode 分析项目并在根目录创建 AGENTS.md（建议提交到 Git）。

配置模型

TUI 里跑 /connect 选择 OpenCode Zen 或其他提供商。也可以用任意 LLM 提供商的 API Key。

想用官方免费/精选模型，见 OpenCode Zen免费模型。

无交互模式

opencode run "Explain this repository"   # 一次性提交 prompt，适合脚本/CI
opencode mini                             # 极简交互界面（非全屏 TUI）

---

没有桌面版

❌ V1 没有独立的桌面应用——OpenCode 的 Electron 桌面版是 V2 才引入的。V1 的入口就是终端（TUI）+ IDE 扩展（VS Code、Cursor、Zed 等）。

如果你需要图形界面，直接上 OpenCode V2 安装指南（桌面版）。

---

更新 / 卸载

# 更新到最新 V1
npm update -g opencode-ai
# 或重跑安装脚本
curl -fsSL https://opencode.ai/install | bash
 
# 卸载（以 npm 为例）
npm uninstall -g opencode-ai

---

状态记录

• 2026-10-03：初版。整理 V1 命令行版安装（脚本 / npm / brew / windows / docker）、初始化、run/mini 无交互模式。未实测——按官方文档（opencode.ai/docs/zh-cn + GitHub README + npm dist-tags 核对）整理，未在本机跑过。

🔗 相关

• OpenCode V2 安装指南 — 下一代版本（桌面版 + 新 CLI）
• OpenCode Zen免费模型 — 官方模型网关，V1 也能用
• Superpower 安装指南 · Comet 安装指南 — 同类 agent 工具安装
• 官方仓库：anomalyco/opencode
• V1 文档站：opencode.ai/docs（中文 docs/zh-cn）