快速上手：安装、连接模型与 build / plan

OpenCode 是开源的 AI 编程智能体，可以作为终端界面、桌面应用或 IDE 扩展使用。

前提

在终端里使用 OpenCode，你需要：一个现代终端模拟器（如 WezTerm、Alacritty、Ghostty、Kitty）；以及你想使用的 LLM 提供商的 API Key。

安装

最简单的方式是安装脚本：

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

也可以用这些命令：

# Node.js（npm、Bun、pnpm、Yarn 都行）
npm install -g opencode-ai

# Homebrew（macOS 和 Linux）
brew install anomalyco/tap/opencode

# Arch Linux
sudo pacman -S opencode      # 稳定版
paru -S opencode-bin         # AUR 最新版

官方建议用 OpenCode 的 tap 获得最新发布；官方的 brew install opencode 公式由 Homebrew 团队维护，更新较慢。Windows 上官方推荐使用 WSL，性能更好且完全兼容；也可以用 Chocolatey（choco install opencode）、Scoop（scoop install opencode）或 npm。桌面应用可从官网下载页或 GitHub Releases 获取。

连接模型

在项目目录启动 opencode，输入 /connect，选择模型提供商并填入 API Key；凭据保存在 ~/.local/share/opencode/auth.json。不知道选哪个时可以选 OpenCode Zen（官方团队测试过的一组模型）。连接好之后，输入 /models 选择模型。官方说明模型很多且每周都有新模型，但真正擅长生成代码并调用工具的只有少数；官方文档列出了一些合适的模型，但那个清单随时间变化，以官方 Models 页为准。要设置默认模型，在配置里设置 model 键（格式 provider/model）。

build 与 plan

OpenCode 内置两个主智能体，按 Tab 键切换：Build 是默认的、启用所有工具的智能体，适合需要完整文件操作和系统命令权限的开发工作；Plan 是为规划和分析设计的受限智能体，默认文件编辑和 bash 命令都设为 ask，用于分析代码、提出改动建议或创建计划而不实际修改代码库。还有三个内置子智能体：General、Explore、Scout（见「智能体」页）。

初始化项目

在项目里运行 /init，OpenCode 会扫描仓库里的重要文件，必要时问几个有针对性的问题，然后创建或更新 AGENTS.md，写下对后续智能体会话最有用的项目指引（见「规则」页）。