OpenCode 安装与使用指南
OpenCode 是一款开源 AI 编码助手，支持终端、桌面应用和 IDE 扩展三种形态。本文介绍其安装前的准备工作、全场景安装指南、配置初始化以及实战使用技巧。
一、安装前准备
在开始安装前，有两个基础准备工作必须完成：
1. 选择适配的终端模拟器
OpenCode 的终端交互功能（TUI）对终端模拟器有一定要求。官方推荐的现代终端模拟器包括：
- 跨平台首选：WezTerm（支持 Windows/macOS/Linux）、Alacritty；
- Linux/macOS 专属：Ghostty、Kitty。 建议避免使用系统自带终端（如 CMD、Terminal），以免出现兼容性问题。
2. 准备 LLM API 密钥
OpenCode 依赖大语言模型（LLM），需提前准备好 API 密钥：
- 新手用户：优先选择官方推荐的'OpenCode Zen'，兼容性最好；
- 有经验用户：可选择 OpenAI、Anthropic 等提供商，需确保账号有可用额度。
二、全场景安装指南
1. 通用方案：一键脚本安装（推荐）
打开终端，输入以下命令：
curl -fsSL https://opencode.ai/install | bash
注意事项：
- 执行过程中可能会提示是否允许安装依赖，输入'y'确认；
- 若出现'curl: command not found'错误，先安装 Git Bash；
- 安装完成后，输入'opencode -v'验证版本号。
2. Node.js 生态专属：包管理器安装
适合已安装 Node.js（v16+）的用户：
| 包管理器 | 安装命令 |
|---|---|
| npm | npm install -g opencode-ai |
| Bun | bun install -g opencode-ai |
| pnpm | pnpm install -g opencode-ai |
| Yarn | yarn global add opencode-ai |
3. 操作系统专属方案
（1）macOS 与 Linux：Homebrew 安装
- 默认源：
brew install opencode - 官方 tap 源（推荐）：
brew install anomalyco/tap/opencode
（2）Arch Linux：Paru 安装
paru -S opencode-bin
（3）Windows：多种方案
- Scoop：
scoop install opencode - Chocolatey：
choco install opencode
