你听说过 OpenCode 吗？

就是那个 GitHub 15 万星、号称「终端里的 AI 编程助手」的开源工具。支持 75+ 模型，Claude、GPT、Gemini 随意换，关键是免费、开源、不锁平台。

听起来挺香的对吧？但你试过安装它吗？

网上的教程要么太旧，要么太散，对新手很不友善。所以今天这篇，我来帮你 5 分钟搞定 OpenCode——从安装到跑起来，一条水都不走。

---

01 先确认你的电脑能跑

OpenCode 支持三个平台：

• macOS ✅
• Linux ✅
• Windows ✅（推荐用 WSL）

安装前确保你有：

• 一个现代终端（iTerm2、Windows Terminal、WezTerm 都行）
• 网络连接（下载安装包）
• 可选：AI 模型的 API Key（不想花钱可以先跳过）

就这些，没别的了。

---

02 五种安装方式，总有一款适合你

方式一：一条命令搞定（推荐）

macOS 和 Linux 用户，用这个最快：

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

Windows 用户提议用 WSL，或者看下面的包管理器方式。

脚本会自动检测你的系统，下载对应版本，加到 PATH 里。装完验证一下：

opencode --version

看到版本号就说明装好了。

方式二：npm / bun（前端选手首选）

如果你有 Node.js，直接：

npm install -g opencode-ai
# 或者
bun add -g opencode-ai

需要 Node.js 18 以上。

方式三：Homebrew（macOS / Linux 用户）

macOS 有 Homebrew 的：

brew install anomalyco/tap/opencode

Linux 有 Homebrew 也可以用同样的命令。

方式四：Windows 用户——Scoop 或 Chocolatey

不想装 WSL？用 Scoop：

scoop install opencode

或者用 Chocolatey：

choco install opencode

两个包管理器会自动配好 PATH。

方式五：Go 安装（适合开发者）

装了 Go 的���学：

go install github.com/opencode-ai/opencode@latest

确保 $GOPATH/bin 在你的 PATH 里。

---

03 配置 AI 模型（可以先跳过）

装完 OpenCode，你还需要一个 AI 模型来驱动它。

免费方案：不配 API Key

OpenCode 内置了一些免费模型的接入点，不想花钱可以先跳过这步，直接用内置的免费模型跑。

推荐方案：配置 API Key

如果你想用更好的模型（GPT-5、Gemini、Claude），需要配置 API Key：

方式 A：交互式配置

opencode

进入后输入：

/connect

按提示选择 provider（OpenAI / Anthropic / Google），然后它会打开浏览器让你登录复制 API Key。

方式 B：环境变量

不想走交互？直接设置环境变量：

# OpenAI
export OPENAI_API_KEY="sk-xxxx"

# 或者 Anthropic
export ANTHROPIC_API_KEY="sk-ant-xxxx"

把这些加到 ~/.zshrc 或 ~/.bashrc 里，下次开终端自动生效。

方式 C：OpenCode 自带余额

访问 opencode.ai/auth，登录后充值或获取免费额度，用 /connect 接入。

---

04 第一次跑起来

随意找个项目目录：

cd ~/projects/my-app
opencode

看到 TUI 界面就说明成功了。

第一次运行，OpenCode 会问你配置 provider（如果你没配环境变量的话）。选好之后，你就能看到输入框了。

试试这些命令：

• 「解释一下这个项目」
• 「找到所有 TODO」
• 「帮我写个函数验证邮箱格式」

---

05 初始化项目上下文（重大！）

刚装好的 OpenCode 还不了解你的项目。运行这个：

/init

它会分析整个项目结构，生成一个 AGENTS.md 文件存在项目根目录。这个文件记录了：

• 项目用什么技术栈
• 代码风格规范
• 团队约定

下次再开 OpenCode，它会自动加载这个文件，「记得」你的项目。

这一步很重大，提议每次新项目都跑一下。

---

06 常用快捷键

OpenCode TUI 里这些快捷键会用得上：

快捷键	作用
Tab	切换 Plan / Build 模式
Ctrl+C	撤销当前操作
Ctrl+D	退出 OpenCode
↑/↓	切换历史命令

---

07 常见问题

Q：Windows 上装完提示「命令找不到」

检查一下 PATH 有没有包含安装目录。Windows 用户提议装 WSL，体验好许多。

Q：装好了但跑不起来，报错「Permission denied」

Linux/macOS 上：

chmod +x /usr/local/bin/opencode

或者你安装到了其他路径，找到那个二进制文件改权限。

Q：API Key 填了但还是报错认证失败

确认 Key 没复制错、没有多余的空格。或者试试用 /connect 重新走一遍交互流程。

Q：不想用 WSL，Windows 原生能跑吗？

能，用 Scoop 或者 Chocolatey 装。但某些功能可能不如 Linux/macOS 完善。OpenCode 官方文档也说了，Windows 提议用 WSL。

---

写在最后

5 分钟过完了，你目前应该已经：

• ✅ 安装好了 OpenCode
• ✅ 配置了 AI 模型（可选）
• ✅ 跑起了第一个会话
• ✅ 初始化了项目上下文

接下来干什么？

我的提议是：找一个小项目，列如给 README 加个目录、给代码加个注释，用 OpenCode 跑一遍。你会发现它不只是一个「问答机器人」，而是真的能帮你写代码、改文件、跑命令的工具。

下一期可以写写 OpenCode 的进阶玩法——多会话并行、模式切换、AGENTS.md 优化。

有什么问题评论区见。

---

P.S. 如果你用的是 Claude Code 或者 Cursor，OpenCode 的用法大同小异，可以直接上手试试。