OpenCode 2 上手：免费模型跑通、权限与 AGENTS.md、子智能体、MCP 与 CI 自动化
按 OpenCode 2 官方文档（@opencode/cli 2.1.4 实测）：不注册、不填 Key，用自带免费模型让开源编程智能体改代码并跑通测试，再配好 opencode.jsonc 权限、AGENTS.md、自定义模型、只读审查子智能体、斜杠命令、MCP 服务器和 JSON 输出自动化，附 V1 迁移对照。
入门·3 课时·69 分钟·图文实操
免费学习无需登录
你将学会
- 安装 OpenCode 2 并用免费模型跑通任务
- 用 opencode run 改代码、写测试、续会话
- 用 permissions 有序规则管住命令执行
- 用 AGENTS.md 让智能体遵守项目规矩
- 写只读审查子智能体与自定义斜杠命令
- 接入 MCP 服务器并用 JSON 输出做自动化
适合谁
- 想在终端用开源 AI 编程智能体的开发者
- 从 OpenCode V1 或 Claude Code 迁移的用户
- 想把 AI 编程放进脚本或 CI 的团队
课前准备
- 会用终端与 Git 基本命令
- 本机装好 uv（第 1 课跑 pytest）
- 第 3 课 MCP 演示需要 Node.js
课程目录
3 课时 · 69 分钟- 01安装 OpenCode 2，用免费模型改代码并跑通测试用一键脚本、Homebrew 或 npm 安装 V2，用 opencode models 查看免费模型，在练习仓库里让 OpenCode 先只读解释代码、再加 median 函数和 pytest 测试并自己跑通，学会 -c 续会话、session list，以及免费额度用完时的报错和三种出路。图文22 分钟开始本课
- 02opencode.jsonc 权限、AGENTS.md 与接入自己的模型弄清配置合并顺序，写 opencode.jsonc 固定默认模型、让命令先询问并禁止 git push，写 AGENTS.md 让智能体自动补中文 docstring，实测 deny 与 ask 在 opencode run 里的不同结果，再学会 policies、external_directory，以及接入 OpenAI 兼容接口和本地 Ollama。图文23 分钟开始本课
- 03子智能体、斜杠命令、MCP 与 CI 自动化认识 build、plan、general、explore 四个内置智能体，写只读 reviewer 子智能体抓出方差公式 bug，写 /test 斜杠命令，用 opencode mcp add 接入 server-everything 并确认 connected，用 --format json 在脚本里判错，最后对照 V1 到 V2 的字段迁移表。图文24 分钟开始本课
课程说明
OpenCode 是开源（MIT）的 AI 编程智能体，在终端里就能读代码、改文件、跑命令。2026 年 9 月发布的 OpenCode 2 改动不小：npm 包名换成 @opencode/cli，所有终端默认共用一个后台服务，权限改成有序规则数组，MCP 服务器统一放到 mcp.servers 下。网上不少教程还停留在 V1 的写法。
本课按 OpenCode 2 官方文档（https://opencode.ai/v2/docs/ ）整理。2026-10-26 在 Linux 上用 @opencode/cli 2.1.4 和 OpenCode 自带的免费模型逐条实跑，「对照结果」都是真实输出。只有全屏界面里的交互操作（如 /connect、/undo）取自官方文档描述，课内会单独注明。不需要注册，也不需要填 API Key，就能跟着做完前两课。共 3 课时：
| 课时 | 你会做完的事 | 需要什么 |
|---|---|---|
| 1 | 安装 V2，查看免费模型，让 OpenCode 解释代码、改代码、写 pytest 并自己跑通，学会续会话和应对额度用完 | 终端、Git、uv |
| 2 | 写 opencode.jsonc 固定模型和权限，写 AGENTS.md 约束行为，实测 deny 和 ask 的区别，接入自定义 OpenAI 兼容接口或本地 Ollama | 同上 |
| 3 | 写只读审查子智能体和 /test 命令，接入 MCP 服务器，用 --format json 放进脚本和 CI，对照 V1 迁移字段 | Node.js（MCP 演示用） |
适合
- 想在终端里用开源 AI 编程智能体的开发者
- 正在从 OpenCode V1 升级、或从 Claude Code 和 Codex CLI 转过来的用户
- 想把 AI 编程放进脚本或 CI 的团队
先修
- 会用终端和 Git 基本命令
- 本机装好 uv，第 1 课用它跑 pytest
- 第 3 课的 MCP 演示需要 Node.js
官方来源：
- OpenCode 2 文档首页（安装）：https://opencode.ai/v2/docs/
- CLI：https://opencode.ai/v2/docs/cli/
- Config：https://opencode.ai/v2/docs/config/
- Providers：https://opencode.ai/v2/docs/providers/
- Models：https://opencode.ai/v2/docs/models/
- Agents：https://opencode.ai/v2/docs/agents/
- Commands：https://opencode.ai/v2/docs/commands/
- Permissions：https://opencode.ai/v2/docs/permissions/
- Instructions：https://opencode.ai/v2/docs/instructions/
- MCP servers：https://opencode.ai/v2/docs/mcp-servers/
- Snapshots：https://opencode.ai/v2/docs/snapshots/
- Migrate from V1：https://opencode.ai/v2/docs/migrate-v1/
- OpenCode Go：https://opencode.ai/v2/docs/console/go/
- Zen 模型与价格：https://opencode.ai/docs/zen/
- 源码仓库：https://github.com/anomalyco/opencode
绑定工具： OpenCode（/tools/opencode/）