安装（双轨）
第一次装备好你的宝可梦(配置好你的 Agent)。
回头一题
这道题不考这一节，考前面学过的。想不起来就回去翻一眼再答——记不住的东西，真用的时候一样会卡。
这门课说的「玻璃箱」，最接近下面哪个意思？
作为 vibe coder,你只需要理解上层概念，看得懂就足够了。这一节只会简单介绍原理。
- OpenCode:本课默认的 Agent 工具。当然如果动手能力强，也强力推荐claudecode和codex。
- Node(Node.js):把它想象成"底座"基础设施。很多开发工具不是独立软件，而是跑在 Node 上、靠它自带的 npm 命令来安装。本训练营的 OpenCode 以及各位开发过程中的很多工具，都会使用到它。在 Windows 上我们推荐用 Node 安装 OpenCode,所以 Windows 要先装它;Mac 走官方脚本则用不到。关于 Node，把它当成装别的工具前要先铺好的地基。
接下来我们开始配置这位也许会贯穿你编程生涯始终的伙伴(Agent)吧 :)
第 0 步：打开命令行
下面所有命令，都要敲在一个叫命令行的黑底窗口里(也叫终端)。
- 按
Command+ 空格，屏幕中间会弹出一个搜索框(这叫 Spotlight)。 - 输入
Terminal(终端),回车。 - 跳出一个黑底或白底的窗口，里面有一行字、末尾一个闪动的小方块，这就是命令行，光标在等你输入。
- 点屏幕左下角的开始菜单(Windows 图标)。
- 直接输入
PowerShell,在结果里点 Windows PowerShell。 - 跳出一个深蓝或黑色窗口，末尾有个闪动的光标在等你输入。
Windows 上还有 cmd、WSL 等别的命令行。目前我们只用 PowerShell。
是不是打开后，有点黑客的感觉了？不要被唬住！这东西其实没你想象的那么复杂，就是个等你输入的框。它大概长下面这样，注意末尾那个闪动的光标：你复制一条命令，粘在光标后面，按一次回车,它就开始跑。一次粘一条，等这条跑完，再粘下一条。
这是一张示意图，不是真窗口。Mac 上提示符常以 % 或 $ 结尾,Windows 上常以 > 结尾，长得不完全一样没关系，认闪动的光标就行。
根据系统进行安装
下面的命令块右上角有复制按钮。回到你刚打开的命令行，把命令粘进去、按回车。跑的时候它会刷很多字符出来，不需要动它，等它自己停下光标重新闪烁后，再粘下一条。
装 OpenCode(推荐官方脚本)
Mac 上最省事：在第 0 步打开的命令行里，粘下面这条官方脚本，按回车，等它自己跑完。
curl -fsSL https://opencode.ai/install | bash进阶可选：另外两种装 OpenCode 的办法
上面官方脚本失败，或你已经在用 Homebrew / Node,可换这两条之一(三选一，装一种即可):
用 Homebrew （要配置好proxy） :
brew install anomalyco/tap/opencode用 npm(要先去 nodejs.org 下载 LTS 版装好 Node,才有 npm):
npm i -g opencode-ai第 1 步：装 Node
去官网下载 Windows 安装包(.msi),双击一路下一步。装好 Node,下一步才有 npm 命令可用。(具体安装步骤以官网为准)
第 2 步：装 OpenCode
Node 装好后，回到第 0 步打开的 PowerShell,粘下面这条、按回车。
npm i -g opencode-aiadded ... packages 之类的安装信息，然后停下、光标重新闪动。只要末尾没有一段红色的 error 字样,就算成功。进阶可选：用 WSL / choco / scoop 装
如果你已经在用 WSL(Windows 里自带的一个 Linux 环境),可以在 WSL 里照 Mac/Linux 官方脚本装:
curl -fsSL https://opencode.ai/install | bash也有人用 choco 或 scoop 这类包管理器装，具体包名以 OpenCode 官方文档为准。新手不用碰这些，上面 npm 那条主路就够了。
OpenCode 有cli版（命令行界面）和桌面版(desktop,图形界面，目前还是 beta)。两个版本都可以满足本训练营的使用。不过，考虑到cli的插件等安装更容易更容易拓展，推荐优先装cli版。
如果要安装桌面版(命令行操作太难了！)
去 opencode.ai/download 下载你系统的安装包:
- Mac:下载 macOS 版(一般是
.dmg),打开后把 OpenCode 图标拖进"应用程序"文件夹。 - Windows:下载 Windows 版安装包，双击一路下一步。
装了桌面版，下面"敲 opencode --version 看版本号"那步可以跳过；你能把桌面版打开、看到它的界面，就说明装好了。
装完自检
装完别急着关窗口，验一下它到底装上没。回到命令行，敲下面这条、按回车，要是它打印出一串版本号,那就是装好了。
opencode --version敲完，你看到的大概是下面这样(具体数字以你装到的版本为准):
看到单独一行版本号(类似 1.14.24),就对了。要是它回 command not found(找不到命令),说明这台命令行还没认到 OpenCode,看下面的"卡住了"那一段。
动手自检清单
对着你真实的命令行窗口逐项核对，做到一项勾一项。四项都勾上，这一关就过。
Gate 1 · 安装自检卡
四项都对上了，这一关过，去下一节配账号。
勾上你确认的项，四项都勾上就过。
- 敲
opencode --version回了 command not found(找不到命令)。一般就是没装上，或者命令行还没认到它。先把命令行整个关掉、重新开一个再敲一遍，很多时候这一下就好；还不行，就把装 OpenCode 那条命令再跑一次，看看末尾是不是报错了。 - 装的时候末尾冒出一段红字。那是它在报错了。别一遍遍重跑，把那段红字整段复制下来，发群里或者告诉 Abel、助教。
- 命令跑了半天不动，或者报 timeout / connection / 无法连接之类的。这一节要从境外的
opencode.ai、nodejs.org下东西，八成是网络的问题，不是你装错了。先确认 0.3 那关的科学上网真的开着、能用，再重跑一遍。别一直在重装这条路上耗——症状看着像没装上，病根在网络。
小测：装完了怎么确认
你敲 opencode --version 后，命令行回了一句 command not found。下面哪个是最可能的原因？
卡住了？命令报错、版本号没认出、装到一半不知道哪步错了，把报错的整段文字复制下来发到群里问问大家，或者直接向 Abel 或助教提问。这一节只管把 Agent 装上就算完成。具体的配置、如何进行第一次对话，接下来两章会逐步完成。