OpenCode 中文教程

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
OpenCode 教程	tutorial	从原理到官方手册全套。
两条线	two tracks	理解篇打底，官方篇查细节。
按需进入	entry	按目标选先读哪条线。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你按目标决定先读 OpenCode 的理解篇还是官方篇。

你是 OpenCode 教程导航顾问。

【角色】
OpenCode 教程导航顾问，按最小够用、安全优先的原则给可落地方案，每条结论都落到能照做的步骤或示例，不停留在空泛建议。

【输入】
- 我的目标：___
- 对 OpenCode 的了解：___
- 最想解决的问题：___
- 可投入时间：___
- 经验水平：___

【工作流程】
1. 按目标区分两条线用途
2. 给先读哪条的建议
3. 排推荐顺序
4. 标出可跳读的
5. 给第一步

【输出规范】
▌一、两条线用途
▌二、先读哪条
▌三、推荐顺序
▌四、按需跳读 + 第一步

【硬约束】
- 按目标选线不强行通读
- 先理解后查手册
- 贴合经验水平
- 不要替我臆测情况或编造不存在的功能，信息不全先问清
- 不确定的配置或接口一律以官方文档为准，禁止照搬过时写法

OpenCode 是一个开源 AI coding agent。它可以跑在终端 TUI、CLI、桌面应用、IDE 扩展和 Web/server 里，也可以通过 SDK、GitHub/GitLab 集成、ACP、MCP、LSP、Plugin 和 Skill 接到更大的开发流程里。

这个中文教程解决两个问题：第一，帮你快速查到官方功能怎么用；第二，帮你理解 OpenCode 适合放在什么工作流里。读完以后，你应该能判断什么时候用 OpenCode、怎么连接模型、怎么配置项目规则、哪些能力可以交给 agent，哪些动作必须继续人工确认。

先给结论：如果你只是第一次打开 OpenCode，先走“官方教程中文版”；如果你已经能跑起来，但不知道怎么把 rules、commands、agents、skills、MCP 和权限体系连成长期工作流，再读“从原理到实战”。

两条互补路径

flowchart LR
    Start["OpenCode 中文教程"] --> Official["官方教程中文版"]
    Start --> Understanding["从原理到实战"]
    Official --> Lookup["安装 / CLI / TUI / 配置 / 工具 / 权限"]
    Understanding --> Judgment["定位 / 工作流 / 模型策略 / 团队边界"]

    style Start fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Official fill:#dcfce7,stroke:#22c55e
    style Understanding fill:#fef3c7,stroke:#f59e0b

接下来去哪

官方教程中文版

按官方文档功能分类，适合查命令、配置项和入口位置。

从原理到实战

8 篇中文讲解，理解 OpenCode 的定位、配置体系和团队使用边界。

安装、连接模型与第一次运行

第一次使用时，先跑通安装、provider、只读和低风险写入。

安全、分享与团队使用

进入真实项目或团队流程前，先收紧权限、密钥、分享和网络边界。

怎么选择阅读路径

第一次接触 OpenCode，不要从复杂配置开始。先把安装、模型连接和第一轮只读任务跑通，再进入 agent、skill、plugin、MCP、LSP 和团队配置。

你的状态	先读什么	目标
还没安装	官方教程中文版	找到安装方式、启动 TUI、完成 provider 连接
能打开 TUI，但不会稳定使用	安装、连接模型与第一次运行	跑通一个低风险任务，确认能读项目、能解释、能受控修改
已经日常使用，但配置很散	配置、Rules 与自定义命令	把重复提醒沉淀成项目规则和 slash command
想接更多工具	工具、MCP、LSP 与格式化器	判断什么应该用内置工具，什么才值得接 MCP 或 LSP
准备团队使用	安全、分享与团队使用	控制权限、分享、密钥、网络和项目级配置边界