OpenCode CLI · 安装
v1.18.5GitHub
适用场景
用一个客户端连接多种官方、第三方或本地模型供应商
面向读者
想自由组合模型的开发者;想在本地跑 Ollama 或低成本试 DeepSeek 的用户
TL;DR
查看 OpenCode 官方安装方式 → 核对发布域名 → opencode --version 验证
CLI 与桌面版配置共享
~/.config/opencode/opencode.json,但安装入口不同。桌面版安装见 OpenCode 桌面版 · 安装。
支持哪些供应商?
OpenCode 可通过内置适配和自定义 provider 连接多种服务;具体列表会随版本变化,应以 OpenCode 官方 Providers 文档 为准:
| 类别 | 示例 |
|---|---|
| 模型厂商与云平台 | Anthropic、OpenAI、Google Vertex AI、Amazon Bedrock、Azure OpenAI 等;以官方 Providers 列表为准 |
| 其他服务商 | DeepSeek、Groq、Together AI、OpenRouter、Ollama 等 |
| 自定义兼容端点 | 自建 API Gateway 或经双方文档确认的兼容接口 |
| 本地模型运行时 | Ollama 等;是否离线取决于模型、工具和其他已启用功能 |
可按 OpenCode 官方文档在 opencode.json 的 provider 字段配置端点和 Key;也可选择第三方 CC Switch 生成配置,但应先查看它准备写入的内容并备份原文件。
系统要求
安装
OpenCode 官方文档列出的安装脚本会检测平台并安装当前版本:
curl -fsSL https://opencode.ai/install | bash安装结束后按脚本输出更新 PATH,或打开一个新终端;不要盲目 source 不属于当前 shell 的配置文件。
npm i -g opencode-ai@latest注意包名是 opencode-ai,不是 opencode。
官方仓库当前优先推荐的 tap:
brew install anomalyco/tap/opencode或直接:
brew install opencodeScoop:
scoop install opencodeChocolatey:
choco install opencode官方仓库:
sudo pacman -S opencodeAUR(社区构建二进制):
paru -S opencode-bin验证
opencode --version
# 输出示例:1.18.5能输出版本号即装好。下一步配 API:
资料来源:OpenCode 官方文档 · anomalyco/opencode Releases(2026-07-26 核对)