OpenCode 是一个 100% 开源的 AI 编程 agent，功能上对标 Claude Code，但不绑定任何单一 provider——可接入 Anthropic、OpenAI、Google、本地模型等 75+ 个 LLM。本页介绍从安装到第一次提交代码的完整流程：安装 OpenCode、配置 API Key、初始化项目（/init）、用 Plan mode 规划再切 Build mode 执行，以及如何撤销修改。

OpenCode 快速开始

OpenCode 是一个完全开源的 AI 编程 agent，支持终端 TUI、桌面 App 和 IDE 扩展三种使用方式。相比 Claude Code，OpenCode 最大的特点是不绑定任何 provider：可以接入 Anthropic、OpenAI、Google Gemini、本地 Ollama 模型等 75+ 个 LLM 提供商。

---

安装

一键脚本（推荐）

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

包管理器

Node.js（npm / bun / pnpm / yarn）

npm install -g opencode-ai
# 或者
bun install -g opencode-ai
# 或者
pnpm install -g opencode-ai

Homebrew（macOS / Linux）

brew install anomalyco/tap/opencode

推荐用 OpenCode 官方 tap，更新频率更高。brew install opencode 是 Homebrew 社区维护的 formula，更新相对滞后。

Arch Linux

sudo pacman -S opencode           # 稳定版
paru -S opencode-bin              # 最新版（AUR）

Windows 安装

推荐使用 WSL：Windows 上体验最佳的方式是通过 WSL（Windows Subsystem for Linux），兼容性更好、功能更完整。

# 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 下载二进制文件。

---

配置 LLM Provider

OpenCode 支持使用任意 LLM provider，只需配置对应的 API Key。

如果你是第一次接触 LLM provider，推荐先试试 OpenCode Zen——这是 OpenCode 团队精选的一批经过验证的模型，开箱即用。

1. 在 TUI 中运行 /connect 命令，选择 opencode，然后访问 opencode.ai/auth

   /connect

2. 登录并填写付款信息，复制你的 API Key

3. 粘贴 API Key 完成配置

除了 OpenCode Zen，你也可以选择其他 provider（Anthropic、OpenAI、Google 等）。

---

初始化项目

配置好 provider 后，进入你的项目目录并启动 OpenCode：

cd /path/to/project
opencode

然后在 TUI 中运行初始化命令：

/init

这会让 OpenCode 分析你的项目并在根目录生成一个 AGENTS.md 文件。

建议把 AGENTS.md 提交到 Git。 这个文件帮助 OpenCode 理解项目结构和编码规范，每次启动都会读取。

---

基本用法

提问

你可以直接问 OpenCode 关于代码库的问题：

How is authentication handled in @packages/functions/src/api/index.ts

提示：输入 @ 可以模糊搜索项目中的文件，自动将文件内容添加到对话中。

开发新功能（推荐先用 Plan mode）

OpenCode 内置 Plan mode，在这个模式下 AI 只做分析规划，不会真正修改代码。

1. 按 Tab 键切换到 Plan mode（右下角会出现模式标识）

2. 描述你想做的事：

   When a user deletes a note, we'd like to flag it as deleted in the database.
   Then create a screen that shows all the recently deleted notes.

3. AI 给出方案后，你可以继续给反馈，甚至拖入设计图参考

4. 满意后再按 Tab 切回 Build mode，让 AI 真正执行

直接修改代码

对于简单明确的任务，不用走 Plan mode，直接说清楚就行：

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

撤销修改

如果 AI 做的改动不满意，用 /undo 撤销：

/undo

OpenCode 会恢复文件并把你原来的 prompt 显示出来，方便你调整后重试。

需要项目是 Git 仓库，撤销底层依赖 Git 快照。

可以多次 /undo 撤回多步操作，也可以用 /redo 重做。

---

分享对话

和团队分享某次对话，用 /share：

/share

这会生成一个链接并复制到剪贴板。对话默认不公开，只有你分享后才能被别人看到。

---

下一步

• TUI 终端界面完整指南 — 学习所有命令和快捷键
• Agents 配置 — 配置 Plan/Build/自定义 agent
• 模型与 Provider — 选择和配置 LLM
• MCP 扩展工具 — 接入外部工具

常见问题

Q: OpenCode 和 Claude Code 有什么区别？

A: 两者功能类似，核心差异是：OpenCode 100% 开源、不绑定 provider（可用 Claude/GPT/Gemini/本地模型），内置 LSP 支持，专注终端 TUI 体验，且支持 client/server 架构（可以远程驱动）。Claude Code 是 Anthropic 官方产品，深度集成 Claude 模型。

Q: 在国内访问 opencode.ai/auth 有问题怎么办？

A: 可以直接在 opencode.json 里手动配置 provider API Key，不必通过网页认证。详见配置文档。

Q: /init 生成的 AGENTS.md 有什么用？

A: 它是 OpenCode 理解你项目结构和规范的"记忆文件"，类似 Claude Code 的 CLAUDE.md。记录项目技术栈、编码风格、测试规范等，让每次对话都有上下文。