OpenCode: OpenCode安装
最后更新：2026-08-31
OpenCode 支持多平台安装，推荐使用一键脚本快速部署。
1. 你将学到
- 系统环境要求
- 一键安装方法
- 各平台安装方式
- 验证安装与启动
2. 环境要求
(1) 操作系统
| 系统 | 支持情况 |
|---|---|
| macOS | ✅ 完全支持 |
| Linux | ✅ 完全支持 |
| Windows | ⚠️ 推荐使用 WSL |
(2) 终端工具
需要一个现代终端，以获得最佳体验：
| 终端 | 平台 | 说明 |
|---|---|---|
| WezTerm | 跨平台 | 推荐 |
| Alacritty | 跨平台 | 性能优秀 |
| Ghostty | Linux/macOS | 新兴选择 |
| Kitty | Linux/macOS | GPU 加速 |
(3) API Key
OpenCode 本身不提供模型，需要配置 AI 服务商：
- OpenCode Zen（官方精选，含免费模型）
- OpenAI（GPT）
- Anthropic（Claude）
- DeepSeek
- 阿里百炼
- GLM / MiniMax
3. 一键安装（推荐）
适用于 macOS / Linux / WSL：
BASH
curl -fsSL https://opencode.ai/install | bash
安装完成后，进入项目目录启动：
BASH
cd <project>
opencode
4. Node.js 安装
如果你熟悉 Node.js 生态：
BASH
npm install -g opencode-ai
或使用 pnpm：
BASH
pnpm install -g opencode-ai
或使用 yarn：
BASH
yarn global add opencode-ai
5. 各平台安装
(1) macOS（Homebrew）
BASH
brew install anomalyco/tap/opencode
推荐使用官方 tap，更新更快。
brew install opencode更新较慢。
(2) Windows
推荐使用 WSL，更稳定且完整支持所有功能。
其他方式：
BASH
# Chocolatey
choco install opencode
# Scoop
scoop install opencode
# NPM
npm install -g opencode-ai
# Mise
mise use -g github:anomalyco/opencode
# Docker
docker run -it --rm ghcr.io/anomalyco/opencode
也可以从 GitHub Releases 页面直接下载二进制文件。
(3) Linux
BASH
# 通用方式（推荐）
curl -fsSL https://opencode.ai/install | bash
# Arch Linux
sudo pacman -S opencode
# 或
paru -S opencode-bin
# Docker
docker run -it --rm ghcr.io/anomalyco/opencode
6. 验证安装
BASH
opencode --version
输出类似以下内容说明安装成功：
TEXT
📖 仅展示
1.1.50
7. 启动 OpenCode
BASH
opencode
如果出现 EACCES: permission denied 错误，修复目录权限：
BASHsudo chown -R $(whoami) ~/.local chmod -R 755 ~/.local
8. 权限问题排查
| 问题 | 解决方案 |
|---|---|
| EACCES: permission denied | sudo chown -R $(whoami) ~/.local |
| command not found | 检查 PATH 是否包含安装目录 |
| 版本过旧 | 运行 opencode upgrade |
❓ 常见问题
Q Windows 原生和 WSL 该选哪个？
A 推荐 WSL。Windows 原生支持部分功能受限，WSL 能获得完整的 Linux 体验，与 OpenCode 兼容性更好。
Q 安装后提示 command not found 怎么办？
A 通常是 PATH 问题。npm 全局安装的路径可能不在 PATH 中。可以运行
npm prefix -g 查看全局安装路径，将其 bin 目录加入 PATH。Q Alice 在 macOS 上安装，Bob 在 Windows 上安装，谁更顺利？
A Alice 更顺利。macOS 原生支持，一条命令即可。Bob 需要先安装 WSL，步骤更多。建议 Bob 优先使用 WSL。
Q Docker 方式安装有什么限制？
A Docker 方式运行在容器中，默认无法访问宿主机的项目文件。需要通过
-v 挂载项目目录：docker run -it --rm -v $(pwd):/workspace ghcr.io/anomalyco/opencode。📖 小节
- 一键安装
curl -fsSL https://opencode.ai/install | bash是最快的方式 - Windows 用户推荐 WSL
- Node.js 安装方式适合前端开发者
- 遇到权限问题用
chown和chmod修复 - 安装后用
opencode --version验证
📝 作业
-
基础题：在你的操作系统上安装 OpenCode，并验证版本号。
-
进阶题：尝试使用两种不同的安装方式安装 OpenCode，比较它们的优缺点。
-
挑战题：在 Docker 中运行 OpenCode，并挂载一个本地项目目录，使其能读取项目文件。
