OpenCode 中文教程

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
准备团队使用	安全、分享与团队使用	控制权限、分享、密钥、网络和项目级配置边界