Skip to content

Ollama 工具和编辑器集成

Ollama 官方维护着一整份集成目录:终端编程 Agent、主流 IDE、桌面助手和自动化平台都能直接使用本地模型。

本章节我们将用 ollama launch 一键接入,或手动配置环境变量,把本地模型塞进你的日常工具链。

runoob1787989723995.png


集成生态全景

官方集成按使用场景分成三类,覆盖从写代码到日常助理的全部入口。

integration-tree.svg

所有集成本质上都走同一条路:把工具的模型请求指向 localhost:11434,或指向与 OpenAI、Anthropic 兼容的接口。


ollama launch:一键接入

launch 是集成的统一入口,交互式完成"选工具、选模型、写配置、启动"四步。

实例

bash

# 交互式选择要启动的集成

ollama launch

# 直接启动指定集成,并指定模型

ollama launch claude --model qwen3.5

# 只生成配置,不启动

ollama launch droid --config

脚本与 CI 等非交互场景用 --yes 跳过所有选择器,模型必须配合 --model 指定:

实例

bash

# 非交互模式:自动拉模型、自动配置、直接执行

# "--" 之后的参数原样传给 Claude Code 本体

ollama launch claude --model qwen3.5 --yes -- -p "这个仓库是做什么的?"

终端 Coding Agent

终端里的编程 Agent 是当前最活跃的集成类别,Ollama 通过各家的兼容协议接入它们。

工具说明
Claude CodeAnthropic 的编程 Agent,经 Anthropic 兼容接口接入,支持工具调用、子任务、联网搜索
OpenCode开源编程 Agent,编辑、运行、迭代代码
CodexOpenAI 的编程助手,含 CLI 与桌面形态
Copilot CLIGitHub 的命令行编程助手
DroidFactory 出品的 AI 编程 Agent
Goose开源自动化 Agent,支持 MCP 扩展
DeepSeek HarnessDeepSeek 开源的 Agent 框架,带子任务与联网搜索
Cline CLICline 的命令行形态

Claude Code 接入详解

以最有代表性的 Claude Code 为例,一键方式就是上面的 launch 命令;手动配置只需要两个环境变量:

实例

bash

# 把 Claude Code 的请求指向本地 Ollama

export ANTHROPIC_AUTH_TOKEN=ollama

export ANTHROPIC_API_KEY=""

export ANTHROPIC_BASE_URL=http://localhost:11434

# 用任意本地模型启动

claude --model qwen3.5

接入后,Claude Code 的对话、文件编辑、命令执行、视觉输入、联网搜索都能使用本地或云端 Ollama 模型。

跑编程 Agent 的硬性门槛是上下文窗口:工具返回和代码文件动辄上万 token。官方建议把上下文设到 64K 以上,本篇最后一节给出设置方法。


IDE 与编辑器

VS Code 官方扩展

Ollama 为 VS Code 提供了官方扩展,把本地模型接进 VS Code Chat。

三步完成接入:

第一步,在扩展市场安装 Ollama 扩展,它默认发现 localhost:11434 上的服务。

第二步,打开 Chat 面板,在输入框下方的模型选择器里找到 Ollama 分区,选择一个模型。

第三步,直接对话提问,本地模型即可参与编码答疑。

实例

bash

# 给 Chat 准备一个模型(未下载时先拉取)

ollama pull qwen3.5

# 云模型需要登录,本地模型无需任何账号

ollama signin

模型不出现在选择器里时,按顺序排查:确认 Ollama 在运行、确认 ollama list 能看到模型、执行命令面板里的 Ollama: Refresh Models,再用 Ollama: Diagnose Models 查看诊断输出。

其他编辑器

工具形态说明
JetBrains插件IntelliJ 系列 IDE 内使用 Ollama 模型
Cline / Roo CodeVS Code 插件Agent 式编码插件,支持自定义模型端点
Zed内置配置高性能编辑器,原生支持自定义模型提供方
Xcode内置配置Apple 平台开发工具接入本地模型

桌面助手与自动化

本地模型不只能写代码,还能充当日常助理与自动化引擎。

工具定位
Claude DesktopAnthropic 桌面助手,可接入本地与云端 Ollama 模型
OpenClaw接入消息软件的个人助理,处理日常事务
Hermes / Hermes Desktop开源 Agent,带自我改进技能与记忆能力
n8n可视化工作流平台,把 Ollama 嵌进自动化流程
Onyx企业知识库问答平台(RAG 场景)
Marimo反应式 Python Notebook,可在单元格中调用模型

Agent 场景的上下文调优

集成工具跑不动、答非所问,八成是上下文窗口太小。

工具返回的网页内容、整个代码文件的内容、多轮 Agent 历史,都会挤进上下文窗口,默认 4K 远远不够,官方对联网搜索、Agent、编码工具的建议值是至少 64000 token。

三种设置方式任选其一:

实例

bash

# 方式一:Ollama 应用设置页拖动上下文滑块(改完重启集成)

# 方式二:启动服务时全局设定

OLLAMA_CONTEXT_LENGTH=64000 ollama serve

# 方式三:用 Modelfile 固化到专用模型

PARAMETER num_ctx 65536

设置后用 ollama ps 的 CONTEXT 列验证是否生效,再观察 PROCESSOR 列确认显存还装得下。


经典开源生态现状

除官方集成目录外,社区生态里还有一批与 Ollama 配合广泛的开源项目。

项目定位现状
LangChain / LlamaIndexLLM 应用开发框架,内置 Ollama 集成类社区维护,RAG 开发常用
Open WebUI自建类 ChatGPT 网页界面,一键连本地 Ollama社区维护,团队内部分享常用
Continue开源 AI 代码助手插件社区维护,支持自定义模型端点

AI 思考中...

Ollama 编程语言调用

Ollama 环境变量与服务配置

基于 VitePress 构建,部署于 GitHub Pages