把 OpenCode 用明白
从安装到实战一次讲透

这是一份面向中文用户的 OpenCode 入门站点。基于 2026 年官方文档整理，覆盖 终端版、桌面版、IDE 扩展，以及 /connect、/models、/init、plan/build agent 等最新工作流。

开始阅读指南 先看安装与配置

最新版安装路线

支持安装脚本、npm、Homebrew、Chocolatey、Scoop、Docker，也支持桌面版与 IDE 扩展。

官方推荐工作流

先 /connect 连接模型，再用 /models 选模型，进入项目后执行 /init 生成 AGENTS.md。

多模型 + MCP 扩展

OpenCode 通过 provider、model、mcp 和 .opencode 目录实现高度定制。

选择适合你的起点

我是普通人 / 零基础

从“AI 超级实习生”这个比喻开始，先建立正确认知，再学会下达可执行需求。

从零开始

我从 Cursor / Copilot 来

重点理解“补全工具”和“编码代理”的差异，快速迁移到 plan/build agent 的工作方式。

快速上手

中国大陆用户

优先介绍 DeepSeek、Qwen、Moonshot、Ollama 等更适合国内环境的接入路线。

国内优化

推荐学习顺序

1

先安装

先确认自己适合脚本安装、包管理器、桌面版还是 WSL 路线。

2

再连接模型

学会 /connect、/models、model 与 small_model 的区别。

3

初始化项目

在项目里运行 /init，让 OpenCode 生成 AGENTS.md 理解代码库。

4

升级工作流

学会 plan/build agent、@ 文件引用、/undo、MCP、agents 与 commands。