GitHub 16万星的OpenCode到底怎么用？从安装到写出第一行AI代码，保姆级教程

OpenCode 在 GitHub 上有 160,000 颗星。 900 多个贡献者，13,000 次提交，每月 750 万开发者在使用。
但我上周问了一圈身边写代码的朋友——6 个人里 4 个没听说过。
不奇怪。AI 编程工具这个赛道过去一年卷得太快了：Cursor、Copilot、Claude Code、Codex、Windsurf、Aider……眼花缭乱。一个新工具冒出来，还没来得及试，又出了三个竞品。
但 OpenCode 不一样。它不是一个"也还行"的备选——它是目前唯一一个同时满足这四个条件的 AI 编程工具：开源、免费、支持 75+ 模型、能用自然语言操控外部工具。

OpenCode 到底能做什么：不是代码补全，是编程 Agent

大多数 AI 编程工具的工作方式是"你写代码，它补全"。好用，但天花板低——只能帮你写得更快，不能帮你做决策。
OpenCode 的思路完全不同。它把自己定位成一个编程智能体——能读文件、执行命令、搜代码、管 Git、改文件。像一个坐在你旁边的开发者同事，不是自动补全插件。
具体来说，它能做的事：
→ 读项目：用 /init 分析你的项目结构、编码风格和约定，生成 AGENTS.md 文件存到 Git 里——以后每次打开项目它都"记得"你的代码风格
→ 改代码："给 /settings 路由加认证中间件，参考 @auth.ts 的实现"
→ 跑命令：!npm run test !git log --oneline -10——直接在对话里执行
→ 连外部工具：MCP 协议支持，插 WordPress 就能操控网站，插数据库就能查数据
→ 并行干活：同一项目开多个 Agent 会话，把一个 3 小时的任务拆成 3 个并行的 1 小时
关键区别： Cursor 让你写得更快，OpenCode 让 AI 替你写。
[内链建议：Cursor vs OpenCode vs Copilot——三款AI编程工具实测对比]

CLI 快速上手：6 步从安装到写出第一段代码

我说实话——OpenCode 最强大的使用方式在终端（TUI）。图形界面舒服，但终端版才是完全体。下面是保姆级步骤。

第一步：安装

# macOS / Linux 一键安装
curl -fsSL https://opencode.ai/install | bash

# 或者 npm
npm install -g opencode-ai

# 或者 Homebrew
brew install anomalyco/tap/opencode

Windows 用户推荐用 WSL，或者 npm install -g opencode-ai、choco install opencode。也可以用 Docker。

第二步：配 API Key

# 进入项目目录，启动 OpenCode
cd /path/to/your/project
opencode

# 在 TUI 中输入
/connect
# → 新手选 "opencode" 用内置 Zen 免费额度
# → 或选 "OpenAI Compatible"，填你的 DeepSeek / OpenAI Key

如果你已经有 GitHub Copilot 或 ChatGPT Plus/Pro 订阅——直接用对应账户登录，复用已有额度，一毛钱不用多花。

第三步：初始化项目

/init

这一步 OpenCode 会扫描你的项目代码，理解结构、编码规约，生成 AGENTS.md。把这个文件提交到 Git 仓库——团队其他人拉下来之后，OpenCode 自动适配你们项目的风格。

第四步：开始写代码

在 TUI 里直接输入：

帮我写一个用户登录接口，JWT认证，参考 @auth.ts 的实现方式

OpenCode 会读取 auth.ts、理解你的认证逻辑、生成匹配风格的代码。

# 引用模糊搜索到的文件
@utils.ts 里有哪些重复逻辑？帮我提取成公共函数

# 执行 Shell 命令
!npm run test
!git diff HEAD~1

第五步：撤销 / 重做

/undo         # Ctrl+X U — 撤销，可连续回退
/redo         # Ctrl+X R — 重做

OpenCode 底层用 Git 管理变更——撤销非常可靠。改崩了？连按几次 /undo 回到安全状态。

第六步：非交互模式（脚本自动化用）

# 快速提问
opencode run "解释这段代码的线程安全问题"

# 接续上次会话
opencode run -c "继续完成刚才没写完的单元测试"

# 指定模型
opencode run -m anthropic/claude-sonnet-4 "重构这个模块"

这六个步骤走完——安装、配 Key、init、写代码、撤销、run——你就已经会用 OpenCode 了。

CLI 命令速查（最常用的 7 条）

桌面客户端：不会命令行照样用

不喜欢终端？OpenCode 桌面客户端支持 macOS、Windows、Linux，去 opencode.ai/download 下对应版本就行。
桌面端最大的亮点是标签页管理：
→ 每个标签页打开不同项目，同时维护 3 个项目不串
→ Ctrl+Tab 快速切换，不关会话随时恢复
→ 原生系统通知——AI 干完活弹窗提醒你
CLI 版适合日常开发（快、轻、能写脚本），桌面端适合多项目切换。两者功能一样，看你习惯哪个。
另外 OpenCode 还有 VS Code、Cursor、Zed、Windsurf 的 IDE 扩展——直接在插件商店搜 "OpenCode" 安装，在你熟悉的编辑器里用全部功能。

7 条最佳实践（第 3 条我现在每天都用）

用了两周 OpenCode，这几条是血的教训——分享给刚开始的人，少走弯路。
1. 复杂任务先用 Plan 模式。 按 TAB 切到 Plan 模式，让 OpenCode 先出方案给你审，确认了再切 Build 执行。别上来就让 AI 放手改——你都不知道它要改什么。
2. 多用 @ 引用文件。 "帮我优化"和"帮我优化 @utils.ts 里的 parseResponse 函数"的效果天差地别。给越具体的上下文，输出越靠谱。
3. AGENTS.md 必须提交到 Git。 这条我现在每个项目都做。/init 生成的 AGENTS.md 是 AI 理解你项目的"说明书"，提交后每次打开会话自动加载，省掉大量解释成本。团队共享后效率翻倍。
4. 大任务拆成多个并行会话。 一个重构 + 写测试 + 写文档的任务——别串行，开三个会话同时跑。OpenCode 的设计天然支持这个用法。
5. 对话要详细，把它当新人同事。 "给这个功能加单元测试"不够，要说"给 @auth.ts 里的 JWT 验证逻辑加单元测试，用 Jest，覆盖正常 token、过期 token、无效签名三种情况"。
6. 直接拖图片进终端。 有这个功能但很多人不知道——把设计稿或截图拖进终端窗口，OpenCode 能读取图片内容，按视觉效果写前端代码。
7. 善用 /compact。 对话长了 token 消耗大，Ctrl+X C 压缩上下文，保留关键信息、丢掉冗余——省钱 + 提速。

现在装一个，5 分钟后你就懂为什么它火了

curl -fsSL https://opencode.ai/install | bash
cd 你的项目
opencode
/connect
/init
"帮我看看这个项目的入口文件在哪里"

五条命令，五分钟。
160K 星不是刷出来的。750 万月活用户不是营销数据。一个开源工具能在这个 AI 编程红海里杀出来——因为它是目前唯一一个"开源 + 免费 + 多模型 + 桌面端 + MCP"全都要的选手。
今天装，今天就写第一行 AI 代码。没什么比亲手试一次更有说服力。
[内链建议：OpenCode + DeepSeek + WordPress MCP——零成本AI运营网站的终极方案]