开源 AI 编程助手 OpenCode 安装与配置指南
为什么选择 OpenCode?
先说痛点:
你是不是也遇到过这些问题?
- ❌ 用 AI 编程工具必须绑定某个厂商的生态
- ❌ 想换更便宜的模型,结果工具不支持
- ❌ 工具闭源,不知道它到底在后台干了什么
- ❌ 想在终端里用,结果只有网页版
OpenCode 就是来解决这些问题的:
- ✅ 100% 开源 — 代码完全透明,想怎么改就怎么改
- ✅ 模型无关 — 支持 Claude、OpenAI、Google,甚至本地模型
- ✅ 专注终端 — 由 neovim 用户打造,TUI 体验丝滑
- ✅ 双 Agent 设计 — build(完全访问)+ plan(只读分析),安全又高效
- ✅ 手机远程控制 — 客户端/服务器架构,电脑跑服务,手机远程操作
安装篇
前置要求:
- Node.js 16+
- 基本的命令行操作能力(会 cd、ls、npm 就够了)
方法 1:一键安装(推荐)
curl -fsSL https://opencode.ai/install | bash
注意:
如果之前装过 0.1.x 之前的版本,先卸载旧版本 安装脚本会自动选择路径:$OPENCODE_INSTALL_DIR → $XDG_BIN_DIR → $HOME/bin → $HOME/.opencode/bin
方法 2:包管理器安装
macOS / Linux (Homebrew,推荐) brew install anomalyco/tap/opencode
npm(任何系统) npm i -g opencode-ai@latest
Windows (Scoop) scoop install opencode
Windows (Chocolatey) choco install opencode
Arch Linux paru -S opencode-bin
任何系统 (mise) mise use -g opencode
方法 3:桌面应用(适合不喜欢终端的同学)
去 opencode.ai/download 下载对应平台的安装包:
- macOS (Apple Silicon / Intel)
- Windows (.exe)
- Linux (.deb / .rpm / AppImage)
配置篇(10 分钟配置 API)
装好了,但还不能直接用 — 需要先配置 AI 模型的 API Key。
步骤 1:选择你的 AI 模型提供商
OpenCode 支持多种模型,这里推荐三个方案:
方案 A:Claude(Anthropic)
适合人群:追求代码质量 成本:中等


