OpenCode 这玩意儿最近挺火。GitHub 上 17 万星,月活 750 万,支持 75 种以上模型提供商。但很多人装完之后卡在第一步:模型怎么配?API Key 往哪放?
这篇文章不扯概念,只说步骤。目标是让你在 15 分钟内,用 Ollama 跑起本地模型,让 OpenCode 真正干活。
一、Ollama:先把本地模型跑起来
Ollama 是目前最流行的本地大模型部署工具,能把模型打包成标准的 OpenAI 兼容接口。说白了就是让你在本地跑 Llama、Qwen、DeepSeek 这些开源模型,不用掏钱买 API。
1.1 安装 Ollama
各系统命令不一样:
macOS
brew install ollama
Linux
curl -fsSL https://ollama.com/install.sh | sh
Windows:去官网下载安装包,或者用 WSL2 跑 Linux 那套。
装完之后验证一下:
ollama --version
1.2 拉取模型
Ollama 的模型仓库里东西不少。挑一个适合你硬件的:
## 7B 参数级别,8GB 显存差不多够用ollama pull qwen3.5# 或者 Llama 系列ollama pull llama3.2# 代码专用ollama pull codellama:7b
OpenCode 对上下文长度有硬性要求——至少 64k。拉模型的时候留意一下这个参数,太小的话 OpenCode 用不了。
下载完成后确认一下:
ollama list
1.3 启动服务
Ollama 安装后会默认在后台跑着,监听 http://localhost:11434。不放心的话手动启一下:
ollama serve
默认端口是 11434,后面配置 OpenCode 的时候要用到。
二、OpenCode:安装与配置
2.1 安装 OpenCode
前提:Node.js 18 及以上。
三种装法,挑一个:
npm 全局安装(推荐)
npm install -g opencode-ai
一键脚本
curl -fsSL https://opencode.ai/install | bash
Homebrew(macOS/Linux)
brew install sst/tap/opencode
验证:
opencode --version
2.2 配置 Ollama 作为模型提供方
OpenCode 的配置文件有两个位置:
- 项目级:项目根目录下的
opencode.json - 全局级:
~/.config/opencode/opencode.json
推荐用全局配置,省得每个项目都配一遍。
方式一:手动配置(推荐,更可控)
编辑 ~/.config/opencode/opencode.json:
{ "$schema": "https://opencode.ai/config.json","provider": { "ollama": { "npm": "@ai-sdk/openai-compatible", "name": "Ollama", "options": { "baseURL": "http://localhost:11434/v1" }, "models": { "qwe…