国内开发者聊起 AI 编码工具，翻来覆去就是 Cursor 和 Claude Code：前者按月订阅、后者绑死单一厂商。但海外开源圈这半年悄悄把票投给了另一个选项——OpenCode。截至 2026 年 10 月 9 日，它在 GitHub 上已收获约 21.2 万星（来源：github.com/anomalyco/opencode）。它完全开源、终端运行、模型随便插。更关键的是：大多数人装上之后只会拿它当聊天框，白白浪费了官方藏在文档里的七八个高效开关。这篇把它们一次性挖出来。
OpenCode 官方对自己的定义只有一句："The open source AI coding agent"。拆开看有三个特点，每一个都踩在国内用户的痛点上：
第一，形态齐全。 它不是一个 TUI 那么简单，官方文档写明它同时提供终端界面、桌面应用、IDE 扩展三种形态。你在公司用 IDE 插件，回家开终端，同一套操作习惯。
第二，模型随便换。 官方原话："With OpenCode you can use any LLM provider by configuring their API keys"——配置好 API key，任何大模型服务商都能接。这意味着工具本身零订阅费，你的成本就是模型 API 调用费，用多少花多少。国内主流模型的 API 也走兼容协议，理论上都能接进来，不用再为“模型在墙外”发愁。
第三，安装门槛极低。 官方给了一键脚本：
curl -fsSL https://opencode.ai/install | bash
也可以 npm install -g opencode-ai（国内配个 npm 镜像就能拉下来），macOS/Linux 还有 brew install anomalyco/tap/opencode，Arch 用户直接 sudo pacman -S opencode。连 Docker 镜像都有：ghcr.io/anomalyco/opencode。
工具本身没问题了，下面进入正题：八个大多数人不知道的暗招。
这是官方文档第一页就写了、但最多人无视的功能。OpenCode 有两个模式：
切换方式就一个键：Tab。切过去之后看终端右下角的模式指示器确认当前状态。
正确用法是把大功能拆成两步：先在 Plan 模式里描述需求（官方建议“像跟团队里的初级开发说话一样，把背景讲足”），让它给你实现路径；你看完方案、补充细节，确认没跑偏之后再 Tab 切到 Build 让它动手。
适用场景：凡是牵扯多文件的改动。直接放 Build 模式裸奔，改崩了再回滚，浪费的是你自己的 token 钱。
很多人以为终端工具天然“看不了图”，错了。OpenCode 支持把图片拖拽进终端窗口，它会自动扫描图片内容并入 prompt。
官方文档里的示例用法很说明问题：你在 Plan 模式下描述完需求，补一句“按这张参考图的设计来做”，然后把设计稿截图拖进去——AI 拿到的就不止是文字描述，还有视觉规范。
适用场景：设计稿转代码、复刻某个 UI、把报错截图直接甩给它（比手打报错快十倍）。注意体验的前提是你用的是现代终端——官方点名支持 WezTerm、Alacritty、Ghostty、Kitty。还在用某些老古董终端的，先换终端再玩。
AI 改崩了怎么办？多数人的第一反应是 git checkout .。OpenCode 给了更精细的一招：/undo。
它不是简单回滚文件，而是把你带回到上一条消息发出之前——代码改动被还原，同时你原来的 prompt 会重新出现在输入框里。这才是精髓：你可以微调提示词再发一次，而不是从零开始重新描述需求。反悔了想恢复？/redo 直接回去。
操作节奏：改 → 不满意 → /undo → 改两个词的 prompt → 重发。这个循环比“改崩了 git 回滚再重新组织语言”快一个量级。
/share 会为当前对话生成一个链接并自动复制到剪贴板。对方点开，看到的是你和 AI 的完整协作过程——你问了什么、它怎么答的、改了哪些代码，全程可回放。
适用场景： - 代码评审时，别只贴 diff，把 /share 链接一起贴上，reviewer 能看到你的实现思路是怎么迭代出来的； - 遇到诡异 bug 求助社区，一条链接胜过十张截图； - 团队新人学习：老手把一次完整的功能开发会话分享出来，就是最好的教材。
配置模型入口是 TUI 里的 /connect 命令。官方给两条路：
路线 A（省事）：选 opencode 官方的 OpenCode Zen——官方维护的精选模型列表，都是经过 OpenCode 团队实测验证的模型，兼容性坑最少。流程：/connect 选 opencode → 跳转 opencode.ai/auth 注册绑卡 → 拿到 API key → 粘贴回去。
路线 B（自由）：直接配任意第三方 provider 的 key。想用便宜的就接便宜的，想用国产模型就接国产模型，想跑本地就接本地推理服务。工具层的操作习惯完全不变。
这就是价格差所在：订阅制工具是“每月固定费 + 模型任厂商挑”，OpenCode 是“工具免费 + 模型市场竞价”。重度用户可以按任务分配模型——规划用强的、批量改动用便宜的。
新项目第一次用，先跑 /init。它会分析你的项目结构，在根目录生成一份 AGENTS.md，把项目架构、代码规范写进去。之后每次会话，AI 都带着这份背景干活，不用你反复解释“我们用的是 monorepo”“错误处理统一走那个中间件”。
值得多说一句的是，AGENTS.md 正在成为跨工具通用的项目说明格式——也就是说这份文件不是写给 OpenCode 一个工具的，你换其他同样认这个标准的编码 agent，这份“项目说明书”可以带走复用。给整个 AI 工具链做一次投入，长期收租。
官方文档在 Customize 一节明确列了 custom commands：把团队里反复出现的操作——比如“跑测试并只报告失败的用例”“按我们的规范写一个 API endpoint"——写成一个 Markdown 文件放进项目的配置目录，它就变成一条斜杠命令，敲 / 就能调用，团队所有人共享同一套。
适用场景：你发现自己第三次输入同样一段 prompt 的时候，就该把它固化了。个人提效是次要的，团队统一 AI 的行为口径才是大头——所有人都用同一个“写单测”命令，产出风格就不会一人一个样。
还是 Customize 那一节，官方一口气列了四件事：换主题、自定义键位、配置代码格式化器、写自定义命令。前三个听着像美化，其实是生产力：
另外补一个部署类技巧：Docker 跑（docker run -it --rm ghcr.io/anomalyco/opencode）。公司电脑没有 root、不让装全局包？Docker 里全套跑起来，用完即焚，环境隔离。
八个暗招不是孤立功能，串起来是一套完整节奏：
flowchart TD
A["安装 OpenCode"] --> B["/init 生成 AGENTS.md"]
B --> C["/connect 配好模型"]
C --> D["Tab 切入 Plan 模式"]
D --> E{"方案满意？"}
E -->|不满意| F["拖图补细节继续迭代"]
F --> E
E -->|满意| G["Tab 切回 Build 模式"]
G --> H["Agent 动手改代码"]
H --> I{"改动合心意？"}
I -->|不满意| J["/undo 回滚调 prompt"]
J --> H
I -->|满意| K["格式化器自动收尾"]
K --> L["/share 生成链接"]
L --> M["贴进 PR 或群里存档"]
| 你以为的 | 实际上 |
|---|---|
| 终端 AI 编码工具都得订阅，还锁厂商 | OpenCode 开源免费，任意 provider 插 key 即用 |
| 换个模型就要重新学一套工具 | 一套操作习惯，模型层随便换 |
| AI 改崩了只能 git 回滚重来 | /undo 回到消息级，微调 prompt 再发 |
| 终端工具看不了设计图 | 截图直接拖进终端进 prompt |
| 分享 AI 开发过程靠截图拼图 | /share 一条链接全量回放 |
| 项目背景每次会话重讲一遍 | /init 沉淀 AGENTS.md，一次投入长期用 |
| 大功能直接让 AI 裸改 | Tab 切 Plan 模式先出方案，确认再动手 |
今晚就能做完的三步：
curl -fsSL https://opencode.ai/install | bash（或 npm 装 opencode-ai），进 TUI 敲 /connect，要么走 OpenCode Zen，要么直接配你手上已有的模型 key；/init，花两分钟检查生成的 AGENTS.md，把官方没分析出来的团队规范手动补几条进去；/undo 的使用频率断崖式下降——那说明 Plan 模式真的在替你省钱。本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生（微信ID: gprshome201101）维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。