OpenCode 完全指南：终端中的 AI 编程助手

OpenCode 是一款开源 AI 编程代理，主打终端体验，也提供桌面端和 IDE 扩展。如果你之前只把它当成“终端聊天工具”，现在值得重新看一眼：它的工作流和生态在 2026 年已经明显更成熟。

OpenCode 界面截图

先看最新进展（2026-03）

根据官网、文档和 GitHub Releases 的最新信息，目前可以关注这几件事：

最新稳定版本已到 v1.3.0（本文写作时刚发布）
官方 npm 包 opencode-ai 同步到 1.3.0
安装渠道更完善，Node.js 运行支持已补齐（不再强依赖 Bun）
桌面版 Beta 持续迭代，支持 macOS / Windows / Linux
文档（含中文）最近仍在活跃更新

一句话总结：OpenCode 已经从“好玩的开源项目”进化到“可以纳入日常开发流程”的工具。

什么是 OpenCode？

OpenCode 的定位是“开源、可扩展、提供商无关”的 AI 编程代理。核心能力包括：

原生终端界面（TUI）
自动 LSP 支持（让模型理解项目语言上下文）
多会话并行（同一项目里同时跑多个任务）
会话分享（便于协作和复盘）
多模型与多提供商支持（含本地模型）
隐私优先（官方声明不存储你的代码与上下文）

安装 OpenCode（推荐方式）

方式 1：官方安装脚本（最省事）

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

方式 2：Node 生态安装

npm install -g opencode-ai
# 或 bun / pnpm / yarn

方式 3：系统包管理器

# macOS / Linux（推荐官方 tap，通常更新更快）
brew install anomalyco/tap/opencode

# Arch Linux
sudo pacman -S opencode        # stable
paru -S opencode-bin           # latest

# Windows
choco install opencode
scoop install opencode

安装完成后先验证：

opencode --version

首次配置与初始化（新手最容易漏）

进入你的项目目录后：

cd /path/to/project
opencode

然后建议按这个顺序走：

/connect：连接模型提供商（可选 OpenCode Zen，也可接 OpenAI/Anthropic 等）
/init：让 OpenCode 扫描项目并生成 AGENTS.md
把 AGENTS.md 提交到仓库，作为团队约定的一部分

为什么要做 /init？因为它会把项目结构、约束和偏好固化下来，后续对话更稳、更少跑偏。

高效工作流：Plan -> Build -> Review

OpenCode 内置两种常用代理模式：

build：默认模式，可直接修改代码
plan：偏分析，不直接改代码（适合先规划再实施）

推荐流程：

先切到 plan，让它拆任务、列风险
确认方案后切回 build 执行
用 Review 功能看改动，再决定是否采纳

这套流程在中大型需求上，比“直接让它改”稳定很多。

你会反复用到的命令

/connect   # 连接或切换模型提供商
/init      # 初始化项目上下文并生成 AGENTS.md
/undo      # 撤销上一轮修改
/redo      # 重做撤销的修改
/share     # 生成会话分享链接

一个实战提示词模板

下面这段我自己测试下来比较稳，适合让 OpenCode 少走弯路：

请先进入 plan 模式，不要改代码。
目标：为 /api/user 增加基于 JWT 的鉴权。
约束：
1) 保持现有返回结构不变
2) 复用 @src/middleware/auth.ts 的风格
3) 补齐单元测试
请先给我：
- 变更文件清单
- 风险点
- 回滚方案

当计划确认后，再补一句：

计划通过，请切回 build 模式并实施。

桌面端与 IDE：什么时候用？

终端重度用户：优先 TUI
需要可视化 review 和多项目切换：试桌面版 Beta
想在现有编辑器里无缝协作：用 IDE 扩展

同一套上下文可以跨终端、桌面和 IDE 使用，这是 OpenCode 的一个实际优势。

进阶：把 oh-my-opencode 接入你的工作流

如果你已经能熟练使用原生 OpenCode，可以进一步接入 oh-my-opencode。在 OpenCode 官方生态系统页面中，它被归类为插件，定位是：

提供后台代理能力（Background Agents）
提供预构建的 LSP / AST / MCP 工具组合
提供一组可直接上手的精选代理配置
强调与 Claude Code 使用习惯的兼容体验

简单理解：原生 OpenCode 偏“通用底座”，而 oh-my-opencode 更像“开箱即用的高阶编排层”。

什么时候值得用

你经常做多步骤任务（先调研、再改代码、再回归测试）
你希望把常见流程固化成可复用编排
你想减少手动切换上下文和重复提示词

推荐接入方式

第一步，先保持原生 OpenCode 可用：

opencode --version

第二步，安装使用

你只需要将下述的提示词在opencode中发送给你的agent，将所有相关的任务交给agent，只需要根据提示完成相关的配置即可。

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

第三步，重启opencode就可以看到不同的agent选项了，使用tab进行选择不通过的agent。

相关特性：

	特性	功能说明
🤖	自律军团 (Discipline Agents)	Sisyphus 负责调度 Hephaestus、Oracle、Librarian 和 Explore。一支完整的 AI 开发团队并行工作。
⚡	`ultrawork` / `ulw`	一键触发，所有智能体出动。任务完成前绝不罢休。
🚪	IntentGate 意图门	真正行动前，先分析用户的真实意图。彻底告别被字面意思误导的 AI 废话。
🔗	基于哈希的编辑工具	每次修改都通过 `LINE#ID` 内容哈希验证、0% 错误修改。灵感来自 oh-my-pi。马具问题 →
🛠️	LSP + AST-Grep	工作区级别的重命名、构建前诊断、基于 AST 的重写。为 Agent 提供 IDE 级别的精度。
🧠	后台智能体	同时发射 5+ 个专家并行工作。保持上下文干净，随时获取成果。
📚	内置 MCP	Exa (网络搜索)、Context7 (官方文档)、Grep.app (GitHub 源码搜索)。默认开启。
🔁	Ralph Loop / `/ulw-loop`	自我引用闭环。达不到 100% 完成度绝不停止。
✅	Todo 强制执行	Agent 想要摸鱼？系统直接揪着领子拽回来。你的任务，必须完成。
💬	注释审查员	剔除带有浓烈 AI 味的冗余注释。写出的代码就像老练的高级工程师写的。
🖥️	Tmux 集成	完整的交互式终端支持。跑 REPL、用调试器、用 TUI 工具，全都在实时会话中完成。
🔌	Claude Code 兼容	你现有的 Hooks、命令、技能、MCP 和插件？全都能无缝迁移过来。
🎯	技能内嵌 MCP	技能自带其所需的 MCP 服务器。按需开启，不会撑爆你的上下文窗口。
📋	Prometheus 规划师	动手写代码前，先通过访谈模式做好战略规划。
🔍	`/init-deep`	在整个项目目录层级中自动生成 `AGENTS.md`。不仅省 Token，还能大幅提升 Agent 理解力。

一个实战场景（比只用原生更省心）

你可以把“需求实现”拆成三个阶段：

规划：分析改动范围和风险
实施：在明确边界后修改代码
校验：执行测试并输出变更总结

在原生模式下，这三步通常要多轮手动提示；结合 oh-my-opencode 后，可以更稳定地走编排流程，并减少上下文丢失。

使用前的两个注意点

先确认插件文档与当前 OpenCode 版本兼容，尤其是大版本更新后。
初次接入建议先在个人项目试跑，再推广到团队仓库。

常见问题与避坑

1) Windows 体验一般，怎么办？

官方文档更推荐在 WSL 中使用，终端兼容性通常更好。

2) 为什么回答不稳定？

先跑 /init
在 AGENTS.md 里明确代码规范
把需求写成“目标 + 约束 + 验收标准”

3) 模型越贵越好吗？

不一定。很多日常任务先用中等模型就够了，把高性能模型留给复杂重构和跨文件改动。

结语

如果你正在寻找一个开源、可控、能融入现有开发流程的 AI 编程代理，OpenCode 已经是非常值得长期关注的选项。

建议你今天就做两件事：

安装并在一个小项目跑通 /connect + /init
用 “Plan -> Build -> Review” 完成一次真实需求

只要这两步跑顺，你会明显感受到它和普通 AI 聊天工具的差别。