OpenCode保姆级安装教程

OpenCode 是一个开源的 AI 编程 Agent，支持在终端中直接完成代码理解、修改、执行等开发任务。

相比传统 AI 工具，OpenCode 可以直接参与开发流程，而不仅仅是生成代码。

在安装之前，需要确保你的环境满足以下条件：

1、操作系统要求

• macOS
• Linux
• Windows（推荐使用 WSL）

2、终端工具

需要一个现代终端，例如：

• WezTerm（跨平台）：https://wezterm.org/
• Alacritty（跨平台）：https://alacritty.org/
• Ghostty（Linux/macOS）：https://ghostty.org/
• Kitty（Linux/macOS）：https://github.com/kovidgoyal/kitty

3、API Key

OpenCode 本身不提供模型，需要你配置 AI 服务商（后文会详细介绍）：

• OpenAI（GPT）
• Anthropic（Claude）
• Google（Gemini）
• DeepSeek
• 阿里百炼
• GLM
• MiniMax

安装方式

OpenCode 提供多种安装方式，推荐优先使用官方脚本。

1、一键安装（推荐）

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

说明：

• 自动下载最新版本
• 自动配置环境
• 适用于 macOS / Linux / WSL

安装完成后，还会提示你怎么用，OpenCode 包含免费模式，使用方式：

cd <project>  # 进入项目目录opencode      # 启动 OpenCode

2、使用 Node.js 安装

如果你熟悉 Node.js，可以使用：

npm install -g opencode-ai

或者：

pnpm install -g opencode-ai

或者：

yarn global add opencode-ai

3、macOS（Homebrew）

brew install anomalyco/tap/opencode

说明：

• 推荐使用官方 tap（更新更快）
• brew install opencode 更新较慢

3、Windows 安装

推荐方式：WSL

原因：

• 更稳定
• 完整支持所有功能

使用 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

你也可以从 Releases 页面 https://github.com/anomalyco/opencode/releases 直接下载二进制文件。

4、Linux 安装

通用方式（推荐）：

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

验证安装

安装完成后，执行：

opencode --version

如果输出类似：

1.1.50

说明安装成功。

启动 OpenCode

直接运行：

opencode

如果出现 EACCES: permission denied, open '' 是权限问题，我们可以修复目录权限：
sudo chown -R $(whoami) ~/.local
然后执行：
chmod -R 755 ~/.local

你会看到终端界面（TUI）:

首次启动会引导完成基础配置：

• 模型选择：默认展示可用模型列表，可直接选择标注 Free 的免费模型（如 MiniMax M2.1、GLM-4.7），无需 API Key 即可使用。
• 登录选项：可选择跳过登录，后续需对接商业模型时再配置 API Key，也可登录 Claude Code Pro 账号调用专属模型。

启动成功后进入 TUI 界面，即可开始使用核心功能。

我们可以在终端输入 /models 查看可用的免费模型：