如何安装OpenCode：一步步用AI写代码

目录

• 两个不能混淆的名字
• 分步教程

  • 1. 安装OpenCode CLI
  • 2. 验证能否运行
  • 3. 接入服务商
  • 4. 进入真实仓库
  • 5. 派发第一个任务
• 如果出问题了
• 常见问题

  • OpenCode和OpenCode Go是一回事吗？
  • 能用Homebrew或Scoop装吗？
  • 需要很强的GPU吗？
  • OpenCode Go 多少钱？
• 总结

我之前写的OpenCode文章都是关于价格和使用上限的：10美元的Go和Zen对比Go。这篇不是。这篇讲的是怎么把程序装好、让它在你的仓库里开口干活。

OpenCode是住在终端里的代码代理（TUI）。它不是IDE，不取代VS Code。它是那个打开项目、读文件、用你接入的模型提出修改的部件。

如果使用 OpenCode Go，从第一个月起就是每月 10 美元。需要更多额度时，Go Plus 是每月 40 美元。首月 5 美元和推荐额度都没有了。订阅在 opencode.ai/go。

更新于2026年9月30日。

两个不能混淆的名字

• OpenCode： 那个CLI。装一次就行。它是自由软件，以opencode命令运行。
• OpenCode Go： 每月 10 美元的订阅（Go Plus 为 40 美元），附带开放模型和使用上限。它是你可以接入的一个服务商，不是安装 CLI 的必要条件。

你今天就可以装OpenCode，然后接入Anthropic、Z.ai或其他API。Go只是帮你省去管理十把API key的捷径。

分步教程

1. 安装OpenCode CLI

官方v2文档给出了这些方式。选一种：

npm install -g @opencode/cli

bun install -g --trust @opencode/cli

pnpm add -g --allow-build=@opencode/cli @opencode/cli

yarn global add @opencode/cli

curl -fsSL https://opencode.ai/v2/install | bash

npm包使用一个受信任的postinstall脚本下载你平台的原生二进制文件。这就是bun和pnpm需要--trust / --allow-build标志的原因。

根据同一份文档，不要用这些方式：Homebrew、AUR、Scoop、Chocolatey，或从镜像站下载的散装.exe。那些写着brew install opencode的2025年教程，对v2来说已经过时了。

Docker也有（ghcr.io/anomalyco/opencode，带版本tag），如果你的流程是容器化的。第一天，npm或官方脚本就够。

2. 验证能否运行

关掉终端再重开（PATH有时不会刷新）。然后：

opencode

应该打开TUI，而不是command not found。如果curl脚本把程序装到了你的shell不加载的目录，开个新会话，或者对你的.bashrc / .zshrc执行source。

不需要GPU。也不需要opencode tui这种神奇子命令：不带参数直接运行二进制就会启动界面。

3. 接入服务商

在TUI里，命令是：

/connect

在这里选择服务商。合理的几条路：

• OpenCode Go： 如果你想要每月 10 美元（或 Go Plus 的 40 美元）和开放模型。在 opencode.ai/go 创建账户、完成付款，然后在 /connect 里接入 Go。上限细节在价格那篇；这里只关心会话能通过验证。
• Z.ai / GLM： 如果你已有Coding Plan，把它作为自定义服务商接入，用coding端点。别混用通用聊天的key。
• Anthropic、OpenAI或其他： /connect然后粘贴key。OpenCode内置了好几家。

没有服务商，TUI就是个空壳。第一天的典型错误不是“装不上”，而是打开了opencode却什么都没接。

4. 进入真实仓库

cd /你的项目路径
opencode

代理看到的是这个目录下的文件。如果你在$HOME里启动，它会想对你整个磁盘发表意见。别这么干。

如果项目里已有AGENTS.md或opencode.json，它遵循之。没有的话以后再初始化，不阻塞第一个提示词。

5. 派发第一个任务

让它做一件不用靠信仰就能验证的事：

• “src/auth.ts是干什么的？”
• “给这个函数写个测试，其他文件别动。”

如果它改对了文件、diff说得通，安装就算完成。到这一步才值得聊MCP、插件和主题——customize文档是留给第二天的。

如果出问题了

• command not found： PATH问题。重开终端。npm全局安装时，Windows的PATH里有时缺npm前缀。
• npm的postinstall卡住了： 那是下载二进制的脚本。bun/pnpm必须带上--trust / --allow-build。
• 其他安装错误： postinstall没跑、不存在的brew install、Windows的PATH，每一个的解法都在OpenCode常见安装错误与解决方法里。
• TUI打开了但模型没响应： 不是安装问题，是/connect。检查key和服务商。
• Go下午就耗尽了： 那是使用上限，不是CLI的bug。上限那篇有解释。

常见问题

OpenCode和OpenCode Go是一回事吗？

不是。一个是CLI，一个是模型订阅。不用Go也能用CLI。

能用Homebrew或Scoop装吗？

v2文档说不能。用npm/bun/pnpm/yarn或opencode.ai/v2/install脚本。

需要很强的GPU吗？

用Go或云端API都不需要。

OpenCode Go 多少钱？

从第一次扣费起每月 10 美元。Go Plus 每月 40 美元。上限细节在价格那篇。没有推荐额度。

总结

• 用官方v2的方式装CLI，别用某个博客里的brew命令。
• /connect是最常被跳过的一步。
• 在仓库里面启动opencode。
• Go 是可选的：每月 10 美元，Go Plus 为 40 美元。
• 价格和上限：另外两篇文章。

如果要订阅，去 OpenCode Go。

如果你正在搭建自己的AI编程工具箱，要支付许可证或订阅费用，在Eneba用我的链接可以享受5%折扣。这是联盟链接：你买得更便宜，我也多一份支持来维持这个博客。如果是给团队用的，我在这里讲解了如何在Eneba买便宜的软件许可证。5% 折扣需通过该链接进入，并在结账时输入优惠码 CreaCosas。

---

如果你脑子里已经有那个代理，只差“让它在这台机器上跑起来”，你不需要又一篇对比评测。你需要一份官方文档目前仍然背书的安装方式。

— Leandro Valencia