开源 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）

适合人群：追求代码质量成本：中等