Ollama 使用编码代理

Ollama 可以通过 ollama launch 把本地模型直接接进编码代理（coding agent），让你在熟悉的开发工具里用本地大模型辅助写代码。当前官方支持 Claude Code / Codex / OpenCode 等代理。

版本基线 v0.40.12；可用代理列表以官方文档与本地 ollama launch 交互菜单为准。

一、交互式启动

直接运行 ollama launch，会弹出可连接的代理列表，用方向键选择后用本地模型启动：

## 启动交互菜单，选择要使用的编码代理
ollama launch

二、直接指定代理

也可以把代理名作为参数，跳过选择直接启动：

## 启动 Claude Code 并接入本地模型
ollama launch claude

## 启动 Codex 并接入本地模型
ollama launch codex

## 启动 OpenCode 并接入本地模型
ollama launch opencode

三、工作原理（简述）

ollama launch 的本质是：让编码代理把推理请求指向本地 Ollama 服务（http://localhost:11434），从而用你本机运行的模型替代云端模型。代理自身仍需单独安装并登录。

## 启动前确认本地服务与模型都已就绪
ollama ps                 # 确认服务在跑
ollama ls                 # 确认本地已有可使用的模型

四、失败处理

• ollama launch 没有目标代理：确认代理工具已安装；ollama launch 的可用列表会随版本更新，以官方文档为准。
• 代理连不上本地模型：确认 Ollama 后台服务在运行、localhost:11434 可达；模型已 ollama pull 到本地。
• 代理要求登录：ollama launch 只负责桥接模型，代理账号需你自行登录。

五、动手试

1. 运行 ollama launch，看交互菜单里有哪些可用代理。
2. 选一个你已安装的代理（如 ollama launch codex），在它里面用本地模型完成一次代码补全。
3. 想让模型在更多应用里跑，见 1.4 Ollama 连接桌面应用 与 1.6 Ollama 运行个人助手。