前置要求
在安装 OpenCode 之前，请确保你的系统满足以下条件。opencode windows 用户推荐使用 WSL（Windows Subsystem for Linux）获得最佳性能和完整功能兼容性。
现代终端模拟器
推荐 WezTerm（跨平台）、Alacritty（跨平台）、Ghostty（Linux/macOS）或 Kitty（Linux/macOS）
LLM API 密钥
至少一个 LLM 提供商的 API 密钥，或使用 GitHub Copilot / ChatGPT Plus OAuth 登录
Git（推荐）
安装 Git 以支持 /undo、/redo 等版本控制功能。OpenCode 的撤销操作依赖 Git 仓库
Windows 安装 opencode windows
OpenCode 在 Windows 上有多种安装方式。推荐使用 WSL 获得最佳体验。
推荐：使用 WSL（Windows Subsystem for Linux）安装 OpenCode 以获得最佳性能和完整功能。在 WSL 中按 Linux 方式安装即可。
方法一：Scoop 安装
scoop install opencode
# 安装 OpenCode Desktop（Beta）
scoop bucket add extras
scoop install extras/opencode-desktop
方法二：Chocolatey 安装
方法三：npm 安装
npm install -g opencode-ai
方法四：下载桌面应用
通过网盘下载 Windows 桌面应用安装包（NSIS .exe），官方原版安全可靠：
夸克网盘APP / 微信扫码
百度网盘APP / 微信扫码
时效性提醒：资源链接具有时效性，请及时转存至您的个人网盘，以免链接失效。网盘安装包含全平台（Windows/macOS/Linux）安装包。
macOS 安装
macOS 上推荐使用 Homebrew 或 curl 一键安装。
方法一：curl 一键安装（推荐）
方法二：Homebrew 安装
brew install anomalyco/tap/opencode
# 或使用官方 formula（更新较慢）
brew install opencode
# 安装桌面应用
brew install --cask opencode-desktop
方法三：npm 安装
Linux 安装
Linux 上支持多种安装方式，包括包管理器和一键脚本。
方法一：curl 一键安装（推荐）
方法二：Arch Linux 包管理器
sudo pacman -S opencode
# AUR 最新版
paru -S opencode-bin
方法三：npm 安装
方法四：Docker 运行
自定义安装目录
安装脚本按以下优先级确定安装路径：
# 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
配置 LLM 提供商
安装完成后，需要配置 AI 模型才能开始使用。OpenCode 支持多种配置方式。
运行 /connect 命令
在终端中运行 opencode 启动 TUI，然后输入 /connect 命令选择模型提供商。推荐新手选择 OpenCode Zen（精选模型，透明计费）。
输入 API 密钥
根据所选提供商输入对应的 API 密钥。如果使用 GitHub Copilot，直接用 GitHub 账号 OAuth 登录；如果使用 ChatGPT Plus/Pro，用 OpenAI 账号登录。凭证存储在 ~/.local/share/opencode/auth.json。
选择模型
使用 /models 命令选择要使用的 AI 模型。可选 Claude、GPT-4o、Gemini、DeepSeek、GLM-5.2 等 75+ 模型，也可选择本地 Ollama 模型。
首次使用
配置完成后，进入你的项目目录并启动 OpenCode。
cd /path/to/your/project
# 启动 OpenCode
opencode
# 初始化项目（创建 AGENTS.md）
/init
/init 命令会让 OpenCode 分析你的项目结构并创建 AGENTS.md 文件。建议将此文件提交到 Git，帮助 OpenCode 理解项目的编码模式和结构。
常见问题
Q: Windows 上安装后命令找不到？
A: 确保安装路径在系统 PATH 中。Scoop 和 Chocolatey 通常会自动配置。如果使用 npm 全局安装，可能需要配置 npm 全局路径。推荐使用 WSL 安装避免此类问题。
Q: 安装旧版本后如何升级？
A: 如果之前安装了 0.1.x 以下版本，请先卸载旧版本再重新安装。使用 npm uninstall -g opencode-ai 或对应包管理器的卸载命令，然后按本教程重新安装最新版。
Q: 如何使用本地模型？
A: 安装 Ollama 或 LM Studio 后，在 OpenCode 中运行 /connect，选择 Ollama 或 LM Studio，确保本地服务正在运行。这样可以在完全离线环境下使用 OpenCode（气隙隔离）。
Q: Bun 安装支持 Windows 吗？
A: 目前在 Windows 上使用 Bun 安装 OpenCode 的支持仍在开发中。Windows 用户请使用 Scoop、Chocolatey 或 npm 安装，或使用 WSL 环境。