Harness 与 Agent 工程 · AI研发与测试工程 · 2026-07-01

在 OpenCode 中接入本地模型:Ollama 部署与配置完全指南

本文带你15分钟搞定Ollama本地模型部署,让OpenCode真正跑起来,解决模型配置和API Key设置的难题。

核心内容:

  1. Ollama本地模型部署与启动步骤
  2. OpenCode安装与Ollama服务配置
  3. 模型选择与关键参数注意事项

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 的配置文件有两个位置:

推荐用全局配置,省得每个项目都配一遍。

方式一:手动配置(推荐,更可控)

编辑 ~/.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…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/OpenSourceLLM/2026070197304.html