如何安装OpenCode：一步步用AI写代码
发布于:
阅读时间: 1 min
主题: 技术
作者: Leandro Valencia
本文教你安装OpenCode（CLI）、接入模型服务商，并在你的仓库里跑起第一个代码代理。附赠OpenCode Go 5美元信用额度的用法说明。这不是一篇价格评测文章。
目录
两个不能混淆的名字
- OpenCode： 那个CLI。装一次就行。它是自由软件，以
opencode命令运行。 - OpenCode Go： 订阅（首月约5美元，之后10美元），提供开放模型和使用上限。它是你可以接入的一个服务商，不是安装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美元的订阅和开放模型。用5美元额度链接创建账户，完成付款设置，然后在
/connect里接入Go。上限细节（5小时 / 周 / 月）在价格那篇里；这里只关心会话能通过验证。 - 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。 - 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都不需要。
5美元额度怎么拿？
用Go的链接注册。额度作用于使用上限。
总结
- 用官方v2的方式装CLI，别用某个博客里的brew命令。
/connect是最常被跳过的一步。- 在仓库里面启动
opencode。 - Go是可选的，用推荐额度试起来很便宜。
- 价格和上限：另外两篇文章。
如果你脑子里已经有那个代理，只差“让它在这台机器上跑起来”，你不需要又一篇对比评测。你需要一份官方文档目前仍然背书的安装方式。
— Leandro Valencia
Step-by-step guide
安装OpenCode CLI
npm、bun、pnpm、yarn或官方v2脚本。不支持Homebrew和Scoop。
验证能否运行
新开一个终端执行opencode，应打开TUI而不是报PATH错误。
接入服务商
在TUI里输入/connect。不想折腾API key，OpenCode Go是10美元的捷径。
进入真实仓库
cd到项目目录再启动opencode，代理只在该目录的文件上工作。
派发第一个任务
要求短小且可验证。改对了文件，说明安装成功。
Frequently asked questions
OpenCode和OpenCode Go是一回事吗？
不是。OpenCode是CLI/TUI（你安装的程序）。OpenCode Go是每月约10美元的订阅，提供开放模型供你在该CLI*内部*使用。你可以只装OpenCode，接入Anthropic、OpenAI或其他服务商，完全不买Go。
能用Homebrew或Scoop装吗？
官方v2文档说明，Homebrew、AUR、Windows包管理器和散装二进制均不受支持。请使用npm、bun、pnpm、yarn或`curl -fsSL https://opencode.ai/v2/install | bash`。
需要很强的GPU吗？
不需要。Go和云端服务商的模型都跑在你的机器之外。一台终端加稳定网络就够了。如果你要接本地模型（Ollama等），那才轮到硬件出场；这不是本教程的路线。
5美元额度怎么拿？
通过推荐链接注册OpenCode Go即可。额度作用于使用上限，不是现金。它差不多能覆盖第一个月——首月5美元，之后转为10美元。
相关文章
继续探索您可能感兴趣的相似内容
2026年真正值得使用的IDE和代码代理（以及为什么opencode赢得了它的地位）
2026年最佳IDE和代码代理的完整指南：opencode、Claude Code、Cursor、Cline、Kilo Code、Crush、Droid等。比较分析、价格和按开发者角色的推荐。
如何使用Z.ai（GLM）：注册、订阅与第一个提示词
上手指南：注册Z.ai、开通GLM Coding Plan、创建API key，并接入Claude Code、Cline或OpenCode。这是入门教程，不是价格评测。
OpenCode Zen 和 Go：每月 10 美元到底能做多少事
深度解析 OpenCode 的 Go 套餐：与 Zen 的对比、各模型的真实用量上限、每次代理式交互的实际成本，以及用 Claude 或 Grok 定规格、用 Go 来执行的完整工作流。
合作
我每天在用的工具，社区可以拿到更好的条件。