OpenCode 是一款开源的 AI 编码代理(AI coding agent),由 AnomalyCo 出品,提供终端 TUI、桌面应用与 IDE 插件多种形态,官网为 opencode.ai。安装最简单的方式是一键脚本 curl -fsSL https://opencode.ai/install | bash;也可用 npm、Homebrew、Windows 包管理器等多种途径。本文按 macOS/Linux、Windows、其他三大场景,整理 7 类可兑现的安装命令与安装后的 API Key 配置。 OpenCode是什么(开源AI编码代理)
OpenCode 是一个开源的 AI 编码代理,可在终端里以类 Chat 的交互方式读写文件、执行命令、迭代调试,定位类似 Claude Code、Codex CLI,但代码完全开源。它支持三种使用形态:终端界面(TUI)、桌面应用、以及 IDE 扩展。工具本身免费,调用模型时走你自己的 LLM 服务商 API Key(按各家计费)。 安装前需要准备什么
在终端使用 OpenCode,只需两项前提:
- 现代终端模拟器:如 WezTerm、Alacritty(跨平台),或 Ghostty、Kitty(Linux/macOS);
- LLM 服务商的 API Key:OpenCode 不绑定单一模型,可接任意支持的供应商,配置好密钥即可用。
若不熟悉模型选择,官方提供 OpenCode Zen:一份由团队测试验证过的精选模型清单,新手可直接照用。
macOS与Linux怎么安装
macOS 与 Linux 有三类主流装法:
- 一键安装脚本(最简):curl -fsSL https://opencode.ai/install | bash;
- Node 系包管理器(需先装 Node.js):npm install -g opencode-ai,等价命令还有 bun install -g opencode-ai、pnpm install -g opencode-ai、yarn global add opencode-ai;
- Homebrew:brew install anomalyco/tap/opencode。官方建议用 OpenCode 自己的 tap 拿最新版;Homebrew 官方维护的
brew install opencode 公式更新频率较低。
Windows怎么安装
Windows 用户可选以下方式(Bun 安装仍在推进中):
- Chocolatey:choco install opencode;
- Scoop:scoop install opencode;
- npm:npm install -g opencode-ai(需 Node.js 环境);
- 直接取二进制:到 GitHub Releases 下载对应平台的可执行文件。
其他安装方式(Arch/Docker/Mise)
| | |
|---|
| | |
| | |
| | mise use -g github:anomalyco/opencode |
| | docker run -it --rm ghcr.io/anomalyco/opencode |
安装后如何配置与初始化
装好只是第一步,还要接上模型密钥才能用:
- 在 TUI 里执行 /connect,选择 OpenCode,按提示访问 opencode.ai/auth;
- 登录并填写账单信息,复制生成的 API Key 粘贴回终端;
- 也可改用其他 LLM 供应商,按各自文档配置密钥;
- 进入你的项目目录 cd /path/to/project,运行 opencode 启动;
- 执行 /init,OpenCode 会分析项目并生成根目录下的 AGENTS.md,帮助它理解项目结构与编码习惯。
关键提示:OpenCode 自身开源免费,但每次调用大模型按你所选供应商的 API 计费,费用与 OpenCode 无关,需在对应平台充值与管理额度。
安装注意事项与风险提示
- 认准官方渠道:安装脚本仅用 opencode.ai/install,二进制只从 GitHub Releases 取,谨防仿冒站点与篡改包。
- 优先用官方 tap:macOS/Linux 用 anomalyco/tap/opencode 拿最新版,官方 brew 公式更新较慢可能滞后。
- Node 版本:用 npm/pnpm/yarn/bun 安装前确认已装较新的 Node.js,旧版本可能导致全局安装失败。
- 权限问题:全局安装报权限错误时,用 sudo(包管理器)或配置 npm 全局前缀,避免随意提权。
- API Key 安全:密钥仅粘贴在本地终端,勿写入仓库或公开分享;不同供应商的额度、计费与限额以各家为准。
- 网络与墙:安装脚本与模型调用依赖联网,国内访问部分海外模型端点可能受限,按合规方式配置。
OpenCode安装常见问题
Q:OpenCode 是什么? A:开源 AI 编码代理,可在终端/桌面/IDE 里读写文件、跑命令、迭代调试,类似 Claude Code 但代码开源。 Q:安装需要什么前提? A:一个现代终端模拟器 + 你想用的 LLM 服务商 API Key;不绑定特定模型。
Q:最简单的安装方式? A:终端执行 curl -fsSL https://opencode.ai/install | bash 一键装好。
Q:没有 Node.js 能装吗? A:能。macOS/Linux 用 Homebrew,Windows 用 Chocolatey/Scoop,或直接从 Releases 下二进制。
Q:brew 和 tap 版有什么区别? A:brew install anomalyco/tap/opencode 更新最快;Homebrew 官方 brew install opencode 公式维护方不同、更新较慢。
Q:Windows 怎么装? A:choco install opencode 或 scoop install opencode,也可 npm install -g opencode-ai。
Q:安装后还要配置什么? A:在 TUI 里 /connect 选 OpenCode,去 opencode.ai/auth 登录拿 API Key 粘贴;再用 /init 初始化项目。
Q:OpenCode 要付费吗? A:工具本身开源免费;调用大模型按你所用供应商的 API 单独计费,与 OpenCode 无关。
Q:安装失败怎么办? A:先查网络、Node 版本与权限;全局安装报权限错用 sudo 或修正 npm 前缀;仍不行就从 GitHub Releases 取对应二进制。
OpenCode 的安装命令、支持平台与配置流程可能随版本更新而变动,本文命令引自 opencode.ai 官方文档;具体以 opencode.ai/docs 与 GitHub Releases 最新说明为准。各 LLM 供应商的 API 价格、额度与可用性请以对应官方为准。