1. opencode 是什么
这是什么：opencode = SST 团队开源的 AI 编码 agent（能自己读文件、改代码、跑命令的 AI 助手），有终端、桌面、IDE 三种形态。
为什么用：模型选谁、装在哪、能不能自己改，这三件事决定了 AI 编码助手好不好用；选错了，要么被锁死在一家供应商的围墙里，要么接不上自己的私有模型。
如何用：本章先说清它的定位和干活流程，再把三种形态摆开对比，最后看清它的能力边界。
1.1 它是一个「能动手」的 AI
只会聊天的 AI 写不了代码。编码 agent 的本事在于能动手：翻你的代码库、改文件、跑测试、看报错、再改一遍——像坐在你旁边的初级程序员。
opencode 出自 SST（服务器端框架 SST 的开发团队），源码公开，npm 包名 opencode-ai。关键一点：它自己不带模型，只负责把「模型」接进「你的项目」，再让它按 agent 的方式干活。
你：给用户表加一个软删除字段，并写迁移
↓
opencode 读上下文（AGENTS.md、相关文件）
↓
规划 → 改文件 → 跑测试 → 看报错 → 再改
↓
给你一份改动说明这正是你在 智能体 Agent 学过的循环：思考 → 调工具 → 看结果 → 再思考，只是工具换成了「读文件 / 写文件 / 跑命令」。
1.2 三种形态，装哪都行
| 形态 | 怎么用 | 适合谁 |
|---|---|---|
| 终端 TUI（终端用户界面） | opencode |
敲命令顺手、习惯 SSH 远程开发的人 |
| 桌面应用 | 单独下载安装 | 想要图形界面、多开窗口 |
| IDE 扩展 | 装进 VS Code 等编辑器 | 已经在编辑器里写代码 |
| 网页界面 | opencode web |
想在浏览器或手机上翻会话 |
它们共用同一份配置和同一批会话数据，所以换形态不用重新配一遍环境。具体能共享到什么程度（比如网页端能否直接续上命令行里开的会话），以你所用版本的实测为准。
# 终端里最常见的入口：先进项目目录，再启动
cd my-project
opencode
你会看到（示意）：
opencode v1.19.3
project: /home/me/my-project
>1.3 为什么很多人选它
| 对比项 | opencode | 闭源订阅制助手 |
|---|---|---|
| 模型 | 75+ 提供商：OpenAI、Anthropic、本地模型都能接 | 通常只给自家模型 |
| 花费 | 按各厂商 API 实际用量付费 | 固定月费 |
| 源码 | 公开，可读可改可自己编译 | 闭源 |
| 配置 | 纯文本 opencode.json，能进 Git |
多藏在 GUI 设置里 |
| 扩展 | 原生 MCP + 插件 + Skills | 各家各有一套 |
还有一点很讨喜：兼容 Claude Code 的文件约定。项目根目录没有 AGENTS.md 时，opencode 会退而读 CLAUDE.md，老用户迁移几乎零成本。
1.4 它的能力边界
| 能做 | 不能替你做 |
|---|---|
| 读写文件、执行 shell 命令 | 替你决定用哪个模型 |
| 跑测试、读报错、自己迭代 | 自动猜出你的项目规范（得靠 AGENTS.md 告诉它） |
| 多会话并行、子 agent 分工 | 断网就用不了（模型在云端） |
| 接 MCP 外部工具、装插件 | 替你承担 API 费用 |
动手改
- 在终端里跑一次
opencode --version，确认命令已经装好（没装也没关系，下一章就装）。 - 用一句话写下你项目里最烦人的一件重复劳动，比如「每次发版都要手动改三处版本号」——这就是你第一个该交给 opencode 的任务。
- 找 3 个你没用过的 AI 编码助手，各写一句评价：opencode 相比它们，最吸引你的是哪一点？
小结
- opencode = SST 开源的 AI 编码 agent，npm 包
opencode-ai，自己不提供模型 - 核心是 agent 循环：读上下文 → 改文件 → 跑命令 → 看报错 → 再改
- 终端 / 桌面 / IDE / 网页四种形态，共用一套配置与数据
- 优势是模型自由、纯文本配置、原生 MCP；代价是 API 费用自理、模型要自己挑
下一章：安装与模型配置 🐸