作为 vibe coder,你只需要理解上层概念,看得懂就足够了。这一节只会简单介绍原理。
接下来我们开始配置这位也许会贯穿你编程生涯始终的伙伴(Agent)吧 :)
下面所有命令,都要敲在一个叫命令行的黑底窗口里(也叫终端)。
Command + 空格,屏幕中间会弹出一个搜索框(这叫 Spotlight)。Terminal(终端),回车。PowerShell,在结果里点 Windows PowerShell。Windows 上还有 cmd、WSL 等别的命令行。目前我们只用 PowerShell。
是不是打开后,有点黑客的感觉了?不要被唬住!这东西其实没你想象的那么复杂,就是个等你输入的框。它大概长下面这样,注意末尾那个闪动的光标:你复制一条命令,粘在光标后面,按一次回车,它就开始跑。一次粘一条,等这条跑完,再粘下一条。
这是一张示意图,不是真窗口。Mac 上提示符常以 % 或 $ 结尾,Windows 上常以 > 结尾,长得不完全一样没关系,认闪动的光标就行。
下面的命令块右上角有复制按钮。回到你刚打开的命令行,把命令粘进去、按回车。跑的时候它会刷很多字符出来,不需要动它,等它自己停下光标重新闪烁后,再粘下一条。
Mac 上最省事:在第 0 步打开的命令行里,粘下面这条官方脚本,按回车,等它自己跑完。
curl -fsSL https://opencode.ai/install | bash上面官方脚本失败,或你已经在用 Homebrew / Node,可换这两条之一(三选一,装一种即可):
用 Homebrew （要配置好proxy） :
brew install anomalyco/tap/opencode用 npm(要先去 nodejs.org 下载 LTS 版装好 Node,才有 npm):
npm i -g opencode-ai去官网下载 Windows 安装包(.msi),双击一路下一步。装好 Node,下一步才有 npm 命令可用。(具体安装步骤以官网为准)
Node 装好后,回到第 0 步打开的 PowerShell,粘下面这条、按回车。
npm i -g opencode-aiadded ... packages 之类的安装信息,然后停下、光标重新闪动。只要末尾没有一段红色的 error 字样,就算成功。如果你已经在用 WSL(Windows 里自带的一个 Linux 环境),可以在 WSL 里照 Mac/Linux 官方脚本装:
curl -fsSL https://opencode.ai/install | bash也有人用 choco 或 scoop 这类包管理器装,具体包名以 OpenCode 官方文档为准。新手不用碰这些,上面 npm 那条主路就够了。
去 opencode.ai/download 下载你系统的安装包:
.dmg),打开后把 OpenCode 图标拖进"应用程序"文件夹。装了桌面版,下面"敲 opencode --version 看版本号"那步可以跳过;你能把桌面版打开、看到它的界面,就说明装好了。
装完别急着关窗口,验一下它到底装上没。回到命令行,敲下面这条、按回车,要是它打印出一串版本号,那就是装好了。
opencode --version敲完,你看到的大概是下面这样(具体数字以你装到的版本为准):
看到单独一行版本号(类似 1.14.24),就对了。要是它回 command not found(找不到命令),说明这台命令行还没认到 OpenCode,看下面的"卡住了"那一段。
对着你真实的命令行窗口逐项核对,做到一项勾一项。四项都勾上,这一关就过。
Gate 1 · 安装自检卡
四项都对上了,这一关过,去下一节配账号。
勾上你确认的项,四项都勾上就过。
opencode --version 回了 command not found(找不到命令)。一般就是没装上,或者命令行还没认到它。先把命令行整个关掉、重新开一个再敲一遍,很多时候这一下就好;还不行,就把装 OpenCode 那条命令再跑一次,看看末尾是不是报错了。你敲 opencode --version 后,命令行回了一句 command not found。下面哪个是最可能的原因?
卡住了?命令报错、版本号没认出、装到一半不知道哪步错了,把报错的整段文字复制下来发到群里问问大家,或者直接向 Abel 或助教提问。这一节只管把 Agent 装上就算完成。具体的配置、如何进行第一次对话，接下来两章会逐步完成。