自学教程

OpenCode 安装

OpenCode 教程

⚠️注意：OpenCode v1 和 v2 共用opencode命令，不能同时安装共存，安装v2会覆盖v1；Windows的Chocolatey、Scoop不再支持v2版本。

前置条件

  1. 终端模拟器：WezTerm、Alacritty、Ghostty、Kitty。Windows强烈建议 WSL2。
  2. LLM服务商API密钥，新手可以使用 OpenCode Console / OpenCode Go订阅方案。

Linux / macOS 一键脚本（推荐）

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

Node包管理器安装（npm / bun / pnpm / yarn）

v2包名为 @opencode/cli；bun、pnpm需要额外参数允许postinstall脚本执行

# npm
npm install -g @opencode/cli# bun 需要加 --trust
bun install -g --trust @opencode/cli
# pnpm 需要--allow-build
pnpm add -g --allow-build=@opencode/cli @opencode/cli
# yarn
yarn global add @opencode/cli

macOS Homebrew（v2专属tap源）

brew install anomalyco/tap/opencode-v2

Arch Linux(AUR)

paru -S opencode-beta

Windows平台说明

❗v2不再支持Chocolatey、Scoop包管理器。
两种可行方案：

  1. 推荐：WSL2 在WSL内部执行上面Linux任意一条安装命令。
  2. 手动下载独立二进制：官网 Releases下载 Windows x64 / ARM64二进制包运行。

Docker v2

需要指定版本tag，示例：

docker run -it --rm ghcr.io/anomalyco/opencode:2.0.0

桌面客户端安装（图形界面，可选）

前往官网下载对应系统安装包：

  • macOS：Apple Silicon / Intel
  • Windows：x64 / ARM64
  • Linux：.deb / .rpm / AppImage包
    macOS也可以brew cask安装：
brew install --cask opencode-desktop

验证安装成功

终端输入：

opencode --version

输出版本号（2.x.x）即v2安装完成。

安装完成后下一步

  1. 进入你的项目目录
cd /path/to/your/project
  1. 启动OpenCode终端界面
opencode
  1. TUI内执行 /connect 配置模型API密钥；执行 /init 初始化项目，生成AGENTS.md

提示：AGENTS.md提交到Git仓库，v2支持多Agent角色定义。

标签：

0 条笔记