## 一句话信息差 国内开发者聊起 AI 编码工具，翻来覆去就是 Cursor 和 Claude Code：前者按月订阅、后者绑死单一厂商。但海外开源圈这半年悄悄把票投给了另一个选项——OpenCode。截至 2026 年 10 月 9 日，它在 GitHub 上已收获约 21.2 万星（来源：[github.com/anomalyco/opencode](https://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 也走兼容协议，理论上都能接进来，不用再为“模型在墙外”发愁。 **第三，安装门槛极低。** 官方给了一键脚本： ```bash 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`。 工具本身没问题了，下面进入正题：八个大多数人不知道的暗招。 --- ## 暗招一：Tab 键双模式，先谋后动再动手 这是官方文档第一页就写了、但最多人无视的功能。OpenCode 有两个模式： - **Plan 模式**：AI 只分析、只出方案，**被禁止改动任何文件**； - **Build 模式**：真正动手写代码。 切换方式就一个键：**Tab**。切过去之后看终端**右下角的模式指示器**确认当前状态。 正确用法是把大功能拆成两步：先在 Plan 模式里描述需求（官方建议“像跟团队里的初级开发说话一样，把背景讲足”），让它给你实现路径；你看完方案、补充细节，确认没跑偏之后再 Tab 切到 Build 让它动手。 **适用场景**：凡是牵扯多文件的改动。直接放 Build 模式裸奔，改崩了再回滚，浪费的是你自己的 token 钱。 ## 暗招二：把截图直接拖进终端 很多人以为终端工具天然“看不了图”，错了。OpenCode 支持把图片**拖拽进终端窗口**，它会自动扫描图片内容并入 prompt。 官方文档里的示例用法很说明问题：你在 Plan 模式下描述完需求，补一句“按这张参考图的设计来做”，然后把设计稿截图拖进去——AI 拿到的就不止是文字描述，还有视觉规范。 **适用场景**：设计稿转代码、复刻某个 UI、把报错截图直接甩给它（比手打报错快十倍）。注意体验的前提是你用的是现代终端——官方点名支持 WezTerm、Alacritty、Ghostty、Kitty。还在用某些老古董终端的，先换终端再玩。 ## 暗招三：/undo /redo，消息级后悔药 AI 改崩了怎么办？多数人的第一反应是 `git checkout .`。OpenCode 给了更精细的一招：**`/undo`**。 它不是简单回滚文件，而是**把你带回到上一条消息发出之前**——代码改动被还原，同时你原来的 prompt 会重新出现在输入框里。这才是精髓：你可以**微调提示词再发一次**，而不是从零开始重新描述需求。反悔了想恢复？**`/redo`** 直接回去。 **操作节奏**：改 → 不满意 → `/undo` → 改两个词的 prompt → 重发。这个循环比“改崩了 git 回滚再重新组织语言”快一个量级。 ## 暗招四：/share，把整场开发过程变成一条链接 **`/share`** 会为当前对话生成一个链接并自动复制到剪贴板。对方点开，看到的是你和 AI 的完整协作过程——你问了什么、它怎么答的、改了哪些代码，全程可回放。 **适用场景**： - 代码评审时，别只贴 diff，把 /share 链接一起贴上，reviewer 能看到你的实现思路是怎么迭代出来的； - 遇到诡异 bug 求助社区，一条链接胜过十张截图； - 团队新人学习：老手把一次完整的功能开发会话分享出来，就是最好的教材。 ## 暗招五：/connect 接模型，两条路看你怎么选 配置模型入口是 TUI 里的 **`/connect`** 命令。官方给两条路： **路线 A（省事）**：选 opencode 官方的 **OpenCode Zen**——官方维护的精选模型列表，都是经过 OpenCode 团队实测验证的模型，兼容性坑最少。流程：`/connect` 选 opencode → 跳转 [opencode.ai/auth](https://opencode.ai/auth) 注册绑卡 → 拿到 API key → 粘贴回去。 **路线 B（自由）**：直接配任意第三方 provider 的 key。想用便宜的就接便宜的，想用国产模型就接国产模型，想跑本地就接本地推理服务。工具层的操作习惯完全不变。 **这就是价格差所在**：订阅制工具是“每月固定费 + 模型任厂商挑”，OpenCode 是“工具免费 + 模型市场竞价”。重度用户可以按任务分配模型——规划用强的、批量改动用便宜的。 ## 暗招六：/init，一次沉淀项目记忆 新项目第一次用，先跑 **`/init`**。它会分析你的项目结构，在根目录生成一份 **`AGENTS.md`**，把项目架构、代码规范写进去。之后每次会话，AI 都带着这份背景干活，不用你反复解释“我们用的是 monorepo”“错误处理统一走那个中间件”。 值得多说一句的是，`AGENTS.md` 正在成为跨工具通用的项目说明格式——也就是说这份文件不是写给 OpenCode 一个工具的，你换其他同样认这个标准的编码 agent，这份“项目说明书”可以带走复用。**给整个 AI 工具链做一次投入，长期收租。** ## 暗招七：自定义命令，把高频 prompt 固化成斜杠命令 官方文档在 Customize 一节明确列了 **custom commands**：把团队里反复出现的操作——比如“跑测试并只报告失败的用例”“按我们的规范写一个 API endpoint"——写成一个 Markdown 文件放进项目的配置目录，它就变成一条斜杠命令，敲 `/` 就能调用，团队所有人共享同一套。 **适用场景**：你发现自己第三次输入同样一段 prompt 的时候，就该把它固化了。个人提效是次要的，**团队统一 AI 的行为口径**才是大头——所有人都用同一个“写单测”命令，产出风格就不会一人一个样。 ## 暗招八：主题、键位、格式化器，把它调成你的形状 还是 Customize 那一节，官方一口气列了四件事：**换主题、自定义键位、配置代码格式化器、写自定义命令**。前三个听着像美化，其实是生产力： - **键位**：把你自己最高频的操作绑到顺手的位置； - **格式化器**：让 AI 改完的代码自动过一遍你团队既有的格式化工具，避免“AI 一改，lint 爆炸”； - **主题**：长时间结对编程，眼睛是成本。 另外补一个部署类技巧：**Docker 跑**（`docker run -it --rm ghcr.io/anomalyco/opencode`）。公司电脑没有 root、不让装全局包？Docker 里全套跑起来，用完即焚，环境隔离。 --- ## 工作流串起来长这样 八个暗招不是孤立功能，串起来是一套完整节奏： ```mermaid 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 模式先出方案，确认再动手 | --- ## 行动指南 今晚就能做完的三步： 1. **装上并接好模型**：`curl -fsSL https://opencode.ai/install | bash`（或 npm 装 `opencode-ai`），进 TUI 敲 `/connect`，要么走 OpenCode Zen，要么直接配你手上已有的模型 key； 2. **挑一个你正在做的真实项目，跑 `/init`**，花两分钟检查生成的 `AGENTS.md`，把官方没分析出来的团队规范手动补几条进去； 3. **强制自己走一周“Plan → Build → /undo”节奏**：任何超过两个文件的改动，先 Tab 进 Plan 模式过方案，满意再放行。一周后你会发现 `/undo` 的使用频率断崖式下降——那说明 Plan 模式真的在替你省钱。 --- ## 参考来源 1. OpenCode 官方文档（安装/命令/自定义功能均出自此）：https://opencode.ai/docs/ 2. GitHub 仓库（21.2 万星数据，2026-10-09）：https://github.com/anomalyco/opencode 3. 一键安装脚本：https://opencode.ai/install 4. OpenCode Zen 账号与 API key 入口：https://opencode.ai/auth --- > 本文由「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 等场景全覆盖。