OpenCode 完整安装指南：3 分钟在终端跑起开源 AI 编程助手
【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode
OpenCode 安装本身只有两条命令的事。它是一个开源的 AI 编程代理（coding agent），跑在你的终端里，负责读写代码、执行命令、管理会话，并且模型可以自选——Anthropic、OpenAI、Google 或本地模型都接。装完之后，你在任意项目目录敲一个词，就能把重复的编码工作交给它。
⚡ 三分钟跑起来
最快路径是官方安装脚本。它会检测你的系统和架构，下载对应的二进制，装进~/.opencode/bin，并帮你写好 PATH。
curl -fsSL https://opencode.ai/install | bash等十几秒，看到下载完成的提示就好。接着打开新终端，在项目目录执行：
opencode预期看到 TUI 界面弹出，说明安装链路全部通了。
🧭 安装方式怎么选
先对照这张表，决定走哪条路，再往下翻详细步骤。
| 方式 | 适用系统 | 核心命令 | 适合谁 |
|---|---|---|---|
| 官方安装脚本 | Linux / macOS / Windows (WSL) | curl -fsSL https://opencode.ai/install \| bash | 绝大多数人，想最快可用 |
| npm / bun / pnpm | 任意装了 Node 的系统 | npm i -g opencode-ai@latest | 依赖用 JS 包管理器管的人 |
| Homebrew | macOS / Linux | brew install anomalyco/tap/opencode | Mac 和 Linux 用户，要持续自动更新 |
| 发行版包管理器 | Arch 等 | sudo pacman -S opencode | 系统级集成、走 APT 风格管理的人 |
| mise / nix | 任意系统 | mise use -g opencode | 多版本工具链、可复现环境 |
| 桌面应用（Beta） | macOS / Windows / Linux | 直接下载安装包 | 不想碰终端的用户 |
| 源码运行 | 任意（需 Bun 1.3+） | git clone+bun dev | 开发者、贡献者 |
🔧 各方式详细操作
一键安装脚本
脚本按OPENCODE_INSTALL_DIR→XDG_BIN_DIR→~/bin→~/.opencode/bin的顺序决定装哪，默认落在最后一档，属于用户级安装，不需要 root 权限。
curl -fsSL https://opencode.ai/install | bash执行后终端会打印版本号，二进制出现在~/.opencode/bin/opencode。
要装到系统级目录或指定版本，把参数拼在前面：
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash curl -fsSL https://opencode.ai/install | bash -s -- --version 1.0.180npm / bun / pnpm / yarn
把 OpenCode 当作一个全局 npm 包来装，好处是和项目依赖走同一套更新机制。
npm i -g opencode-ai@latest装完全局PATH里会多出opencode命令，直接可用。bun、pnpm、yarn 用户把命令换成bun add -g、pnpm add -g、yarn global add即可，效果相同。
Homebrew
macOS 和 Linux 上推荐用 tap 源，公式更新勤，基本始终跟得上最新版本。
brew install anomalyco/tap/opencode几分钟后brew list opencode能列出安装内容，即成功。
其他包管理器与桌面版
Arch 有稳定仓库和 AUR 两条路：
sudo pacman -S opencode paru -S opencode-bin桌面应用目前是 Beta，按平台下载安装包即可：macOS 用.dmg（区分 Apple Silicon 和 Intel），Windows 用.exe，Linux 有.deb、.rpm、.AppImage三种。macOS 用户也可以直接brew install --cask opencode-desktop。
从源码运行
想跑最新代码或者提交 PR，走这条路线。前提只有两个：Bun 1.3+和 Git。
git clone https://gitcode.com/GitHub_Trending/openc/opencode cd opencode bun install bun devbun dev会直接在当前终端拉起 TUI，等价于装好的opencode命令，只是走本地代码。要针对别的目录运行，追加参数即可：bun dev <directory>。
想出一个独立可执行文件：
./packages/opencode/script/build.ts --single产物在packages/opencode/dist/opencode-<平台>/bin/opencode，拷走就能用。
✅ 首次启动自检
装完别急着开项目，先做三步最小配置。
第一步，确认版本。
opencode --version打印出语义化版本号即安装成功。
第二步，接入一个模型。进入 TUI 后按提示完成首次配置：选择供应商、粘贴 API Key，或者直接连本地模型。
第三步，发一句测试。随便让它读一个文件，能正常返回说明模型链路通了。到这一步就可以开工了，更多配置项见 packages/docs/essentials/settings.mdx。
🖥️ 平台兼容一览
| 平台 | x64 | arm64 | 备注 |
|---|---|---|---|
| macOS | 支持 | 支持（推荐） | Rosetta 下会自动按 arm64 取包 |
| Linux | 支持 | 支持 | Alpine / musl 环境自动切换 musl 构建 |
| Windows | 支持（WSL） | — | 原生走桌面应用；CLI 建议在 WSL 内用 |
| 桌面应用（Beta） | macOS / Windows 全支持 | macOS 全支持 | Linux 提供 deb / rpm / AppImage |
不支持的组合（比如 Linux 32 位）脚本会直接报错退出，不会装出坏包。
🚑 排错指南
问：装好了却提示opencode: command not found？脚本默认把二进制放进~/.opencode/bin，这个目录还没进你的 PATH。把下面一行加进 shell 配置文件，再开新终端：
echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc（zsh 用户把~/.bashrc换成~/.zshrc。）
问：装的时候报端口或权限冲突，或者行为怪异？多半是 0.1.x 之前的旧版本残留，先卸载再重装：
npm uninstall -g opencode-ai && curl -fsSL https://opencode.ai/install | bash问：公司终端不让动 shell 配置文件，能装吗？可以，安装时加--no-modify-path，脚本就不会碰你的 rc 文件，之后 PATH 由你自己配：
curl -fsSL https://opencode.ai/install | bash -s -- --no-modify-path问：装到哪个目录我能控制吗？能，OPENCODE_INSTALL_DIR优先级最高，直接指过去就行：
OPENCODE_INSTALL_DIR=/opt/opencode curl -fsSL https://opencode.ai/install | bash问：跑起来之后选哪个模型？没有标准答案。长上下文和复杂推理选旗舰模型，日常小改动选便宜的快模型即可，模型随时可切，不绑定供应商。
📌 收尾
- 普通开发者：一键脚本足矣，别在选型上花时间。
- macOS / Linux 用户：走 Homebrew tap 源，更新省心。
- Node 栈团队：
npm i -g opencode-ai@latest，和现有工具链统一管理。 - 想尝鲜的贡献者：
git clone下来跑bun dev，直接站在最新代码上。
下一步：进入你的第一个项目目录，执行opencode，配好一个 API Key，把今天最烦手的那段活儿丢给它。
【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
