OpenCode 完整教程

欢迎来到 OpenCode 完整教程。本教程基于 OpenCode 官方文档 与开源项目 anomalyco/opencode 整理,帮助你从零掌握这款开源、多模型、隐私优先的 AI 编程 Agent。


教程目录

基础篇

  1. OpenCode 简介 — 定位、产品矩阵、与 Codex / Claude Code 对比
  2. 安装与配置 — 多平台安装、Provider 连接、OpenCode Zen
  3. 快速上手 — TUI、Plan/Build 模式、/init 与第一个任务

原理篇

  1. 架构与运行机制 — Agent 循环、多会话、配置合并优先级

定制篇

  1. AGENTS.md 与项目初始化/init、指令文件、@ 文件引用
  2. Agent 与权限系统 — Build/Plan、Subagent、permission 细粒度控制

扩展篇

  1. MCP 与 LSP — 外部工具接入、语言服务器诊断反馈

运维篇

  1. 配置与 CLI 参考opencode.jsonrun / serve、环境变量

实践篇

  1. 实战案例 — 功能开发、Code Review、CI 自动化
  2. 资源与延伸阅读 — 官方文档与社区

学习路径

阶段目标章节
第 1 天安装并跑通 TUI简介 → 安装 → 快速上手
第 2–3 天理解 Build/Plan 与权限架构 → Agent 与权限
第 1 周团队规范与扩展AGENTS.md → MCP/LSP → 配置
持续自动化与规模化CLI 参考 → 实战案例

前置知识

  • 终端与 Git 基础
  • 至少一个 LLM Provider 的 API Key(或 OpenCode Zen 账号)
  • 熟悉任意一门编程语言