OpenCode 快速上手指南
OpenCode 是一款开源的 AI 编程助手,支持接入 75+ 种模型。相比闭源工具,它提供了更灵活的本地化部署和免费模型接入能力,是 Claude Code 的优秀替代方案。
安装方式
根据使用习惯,可以选择桌面端、命令行或 IDE 插件三种方式。
桌面客户端(新手推荐)
不习惯命令行操作?直接下载桌面版即可。它相当于带 GUI 界面的 Claude Code,交互简单直观。
访问 opencode.ai/download 下载对应系统的安装包(macOS、Windows、Linux 均有)。双击安装后打开即可使用。
macOS 用户也可以通过 Homebrew 安装:
brew install --cask opencode-desktop
目前桌面版处于 Beta 阶段,但日常功能已足够稳定。类似于 Cursor 的 Agent 模式,纯对话交互,只需告诉 AI 你的需求。

命令行 CLI
如果你已经习惯了终端操作,CLI 版本会更高效。按系统选择对应的安装命令。
macOS 和 Linux:
# 官方脚本(推荐)
curl -fsSL https://opencode.ai/install | bash
# Homebrew 安装
brew install opencode
# 或者使用官方 tap,更新更快
brew install anomalyco/tap/opencode
Windows:
# Scoop(推荐)
scoop bucket add extras
scoop install extras/opencode
# Chocolatey
choco install opencode
如果环境已有 Node.js,也可以使用 npm 全局安装:
npm install -g opencode-ai
# 或使用 pnpm / yarn / bun
安装完成后重启终端并验证版本:
opencode --version
看到版本号即表示成功。用法与 Claude Code 一致,输入 opencode 启动对话即可。

IDE 插件
VS Code、Cursor、Windsurf 等主流编辑器均支持官方插件。
在扩展商店搜索 "OpenCode" 安装,安装完成后通过快捷键唤起:
- macOS:
Cmd + Esc - Windows/Linux:
Ctrl + Esc








