如果你只盯订阅制编码工具，大概率错过了它：OpenCode（https://github.com/sst/opencode ，官网 opencode.ai）。开源、免费、跑在终端里的 AI 编码 Agent——模型随便接（BYOK），你出 API Key 它出力气。别看国内社区总把它当「Claude Code 平替」一笔带过，海外那边它的分量重得多：Artificial Analysis 的 coding agents（harness）专项榜单上它名列前茅；26万星的现象级 harness 优化系统 ECC 点名支持它；小米开源的 MiMo-Code 直接拿它当底座做编排增强；连 Warp 终端都专门给它留了原生入口。换句话说，它不是平替，是海外开源 Agent 阵营的「公共底座」。
但多数人装完之后只会干一件事：打开输入框开始打字。这就像买了台手动挡性能车全程用一挡开。这篇文章挖它的 8 个隐藏关卡，全部免费，不需要任何订阅。
curl -fsSL https://opencode.ai/install | bash
# 或者走 npm
npm i -g opencode-ai
装完第一件事不是聊天，是绑模型：
opencode auth login
按提示选供应商、贴 API Key。Anthropic、OpenAI、OpenRouter、Google 都在列表里；国产阵营更友好——智谱 GLM 的官方开发者文档直接把 OpenCode 列为一等公民接入对象，Kimi、DeepSeek 这类 OpenAI 兼容端点也能配。模型注册表托管在 models.dev，接哪家都不用改代码。这一步就是它的核心卖点：订阅制工具锁定你，它让你货比三家。
下面进入正题。
怎么做：在 TUI 里按 Tab 键，左下角模式标识会在 Build 和 Plan 之间切换。
效果：Plan 模式下模型只读代码、只出方案，不碰你的文件；方案满意了再切回 Build 放手让它改。
场景：接手陌生仓库、要做大重构的时候。很多人翻车就是因为上来就让 Agent 动手——先让它交一份施工图，是成本最低的保险。这和 Claude Code 的权限逐级放权是两种哲学：OpenCode 把「想」和「做」做成了两个物理开关。
怎么做：在项目根目录启动 opencode，输入 /init。
效果：它会读你的代码结构，自动生成一份 AGENTS.md——项目规范、目录约定、构建命令全在里面，之后每次会话自动生效。
场景：给老项目立规矩。妙处在于 AGENTS.md 是开放标准，不是 OpenCode 的私有格式——其他主流编码 Agent 也认这个文件。也就是说你写一份宪法，几家 Agent 共用，迁移成本为零。手写 CLAUDE.md 时代可以翻篇了。
怎么做：在项目里建 .opencode/agent/ 目录，往里扔一个 Markdown 文件，frontmatter 写身份设定：
---
description: 只挑毛病不改代码的毒舌审稿人
mode: subagent
model: 按provider/model格式填你想要的模型
---
你是资深代码审查员。只输出问题清单，按严重度排序，禁止动手改代码。
效果：主 Agent 用 Tab 切换，子 Agent 在对话里 @名字 呼出。不同 Agent 可以绑不同模型——贵模型做规划、便宜模型跑腿，一份钱掰成两半花。
场景：给团队固定工作流建模。审稿人、测试员、文档员各一个，比在聊天框里反复粘贴同一段提示词体面得多。
怎么做：建 .opencode/command/review.md，正文直接写提示词模板：
审查 $ARGUMENTS 涉及的改动，输出问题清单，按严重度排序。
效果：以后对话里敲 /review src/api，$ARGUMENTS 自动替换成你传的参数，整套流程一键触发。
场景：所有你每周都在重复输入的话——发版检查、依赖体检、生成周报——都值得固化成一条命令。海外重度用户的经验是：命令库的厚度，约等于你的提效上限。
怎么做：让 AI 改完代码发现不对，直接输入 /undo；后悔当初撤销，/redo 找回来。
效果：OpenCode 在动手前自动做快照，回滚不靠你手动 git checkout。
场景：放手让它大改的时候。这是交互体验上被低估最多的一关——心里有了反悔按钮，你才敢真的放权。国内用户习惯性「改完自己 diff 一遍再手动还原」，这条能省掉整个仪式。
怎么做：会话中输入 /share，拿到一个官方托管的只读页面链接；敏感项目结束用 /unshare 关掉。
效果：完整的对话过程、代码改动、决策路径，别人打开链接全部可见。
场景：三个高频用法——问别人问题前先甩链接（不用截图拼图）；交接工作给同事；写技术博客时引用自己的决策过程。这是订阅制工具普遍没做好的「会话可分享性」，OpenCode 把它做成了一等公民。
怎么做：在你的服务器（公司跳板机、租的 GPU 盒子都行）上跑 opencode serve，它以无头服务模式待命；本地终端的 TUI 作为客户端接入即可继续干活。
效果：会话状态活在服务器上。白天在公司用台式机推进到一半，晚上回家笔记本接上接着聊，上下文一字不丢。
场景：代码在远程服务器、算力在远程、人在两地跑的人。client/server 架构是它和 Claude Code 在底层设计上最大的分野——前者天生为「Agent 常驻、人到处走」设计。
怎么做：
opencode run -m 你的provider/你的model "审查最近5个commit，找出没写测试的改动"
非交互模式，跑完即退，天然适合自动化。
效果：Agent 从「你敲它动」变成「定时自跑」——放进 crontab 每天早上给仓库做体检，或接进 GitHub Actions 在每次 PR 后自动跑检查。
场景：想从「用 AI 写码」进化到「养一个自动化工人」的人。海外独行侠开发者已经普遍这么干：交互式会话管创造性工作，run 模式管巡检杂活，两班倒。
/models：会话中途无缝切模型，聊一半发现任务变简单了？当场换便宜模型省钱；/compact：上下文快满时压缩会话，长任务续航；/sessions：翻旧会话，历史都是资产；flowchart TD
A["安装 opencode"] --> B["auth login 绑模型"]
B --> C["/init 生成 AGENTS.md"]
C --> D["Tab 切进 Plan 模式"]
D --> E{"方案满意吗"}
E -->|不满意| D
E -->|满意| F["Tab 切回 Build 动手改"]
F --> G["改砸了 /undo 反悔"]
G --> H["/share 生成只读链接"]
H --> I["进阶：serve 挂上服务器"]
H --> J["进阶：run 塞进 CI 定时跑"]
| 你以为的 | 实际上的 |
|---|---|
| OpenCode 只是 Claude Code 的平替 | 海外 harness 榜单常客，ECC、Warp、小米 MiMo-Code 全在接它，是开源阵营底座 |
| 用编码 Agent 必须先订阅 | BYOK 任接模型，国产 GLM/Kimi/DeepSeek 官方文档都有接入指引，本地 Ollama 也能上 |
| 改错了只能手动 git 还原 | 自动快照，/undo /redo 一键反悔 |
| 会话记录锁死在自己电脑里 | /share 一键生成只读链接，求助、交接、写作引用全靠它 |
| Agent 只能你敲一句它动一下 | serve 挂服务器常驻，run 塞进 CI 定时自跑，两班倒 |
平心而论，交互打磨度上订阅制产品仍有优势，开源工具的代价是配置要自己动手。但你得到的是：模型自由、数据自由、价格自由——对被单一订阅绑架这件事过敏的人，这三个自由就是全部理由。
auth login 绑上你手头已有的任何一家 API Key（没有的话，OpenRouter 一个 Key 通吃主流模型）；opencode run 给你的主仓库配一个每日自动体检，下周一把 /share 报告链接贴进周报。本文由「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 等场景全覆盖。