如何快速给Zero接入25+模型提供商：OpenAI、Claude、Ollama本地模型3分钟配置教程

Zero是一款运行在你本地终端的 AI 编码智能体（coding agent），核心卖点之一就是“模型由你做主”：它内置了25+ 模型提供商目录，一条命令即可接入 OpenAI、Anthropic Claude、Google Gemini、Groq、DeepSeek、Mistral 等云端 API，也支持 Ollama、LM Studio 等本地模型。本文将带你用 3 分钟完成 Zero 的模型提供商配置。

为什么 Zero 能接入 25+ 模型提供商 🧩

Zero 把所有支持的提供商收敛成一个统一的提供商目录，每个提供商预置了：

• 默认 API 地址（Base URL）与默认模型
• 对应的 API 密钥环境变量名
• 传输协议类型（OpenAI 兼容、Anthropic 兼容、Google 原生等）

你几乎不需要手写配置，只需“选一个提供商 + 给一把密钥”即可。目录定义在 internal/providercatalog/catalog.go，运行时的协议适配实现在 internal/providers/factory.go。

主要支持的提供商一览（完整列表用zero providers catalog查看）：

第一步：安装 Zero（1 分钟）📦

任选一种方式，完整说明见 docs/INSTALL.md：

# 方式 A：npm 全局安装（推荐） npm install -g @gitlawb/zero # 方式 B：安装脚本（Linux / macOS） curl -fsSL https://gitcode.com/gh_mirrors/zero55/zero/raw/main/scripts/install.sh | bash # 方式 C：源码构建（需要 Go 1.26.6+） git clone https://gitcode.com/gh_mirrors/zero55/zero cd zero go run ./cmd/zero

安装完成后运行zero，首次启动会自动进入设置向导。

3 分钟配置：三种最快接入方式 ⚡

方式一：交互式向导（最简单）

zero setup

向导会列出内置的提供商目录，你选择 OpenAI 或 Anthropic 等，粘贴 API 密钥（或先设置环境变量），再选择模型即可。向导结束后配置自动生效，详见 internal/cli/provider_onboarding.go 中的引导流程。

方式二：命令行一键添加 OpenAI / Claude

先设置 API 密钥环境变量，再用zero providers add添加并设为激活：

# 接入 OpenAI export OPENAI_API_KEY=sk-... zero providers add openai --set-active # 接入 Anthropic Claude export ANTHROPIC_API_KEY=... zero providers add anthropic --set-active # 接入 Google Gemini export GEMINI_API_KEY=... zero providers add google --set-active

add支持--model、--base-url、--api-key-env、--set-active等参数覆盖目录默认值，例如指定 GPT-4.1 之外的模型：

zero providers add openai --model gpt-4.1 --set-active

方式三：本地模型 Ollama / LM Studio 自动探测 🏠

想让 Zero 免费跑本地模型？只要本地推理服务在运行，Zero 就能自动探测：

# 1. 启动本地推理服务（示例：Ollama） ollama serve # 2. 让 Zero 探测本地运行时 zero providers detect

detect会探测 Ollama、LM Studio、Atomic Chat 三类本地运行时，并直接打印出可复制的 add 命令（含已加载的模型 ID），例如：

zero providers add ollama --model llama3.1 --set-active

探测逻辑实现在 internal/cli/provider_detect.go。本地提供商默认端点：Ollama 为http://localhost:11434/v1，LM Studio 为http://localhost:1234/v1。

常用zero providers命令速查表 🧰

命令帮助文本可在 internal/cli/command_center.go 中找到。在 TUI 会话中，还可以随时用/model和/provider斜杠命令切换模型与提供商，无需重启。

验证配置是否成功：用zero doctor一键体检 ✅

配置完成后，建议做一次体检：

zero doctor # 检查配置、密钥与连通性 zero providers check --connectivity zero models list # 确认模型注册表可用

一切就绪后，直接用zero exec发个任务验证：

zero exec "用一句话解释 internal/agent/loop.go"

如果输出正常流式返回，说明提供商已接入成功 🎉

进阶玩法：任意兼容端点与 OAuth 登录 🔑

• 自定义 OpenAI 兼容端点：任何 OpenAI 兼容网关（含国内大模型 API）都可以用custom-openai-compatible接入，例如：

zero providers add custom-openai-compatible \ --name my-gateway --model my-model \ --base-url https://your-endpoint/v1 \ --api-key-env MY_API_KEY --set-active

• OAuth 登录：部分提供商（如 OpenRouter、Hugging Face、xAI、ChatGPT 订阅）支持应用内 OAuth 登录，无需手动填密钥：

zero auth # 打开浏览器完成 OAuth 登录

订阅类 OAuth 的方案细节见 docs/oauth-subscriptions.md。

常见问题快速排查 🩺

相关文档与源码路径 📚

• 安装文档：docs/INSTALL.md
• 提供商目录定义：internal/providercatalog/catalog.go
• 提供商运行时工厂：internal/providers/factory.go
• 本地运行时探测：internal/cli/provider_detect.go
• 提供商/模型命令实现：internal/cli/command_center.go
• 项目总览：README.md

现在你已经掌握了 Zero 模型提供商的三种快速接入路径：向导、命令、探测。接下来，挑一个最顺手的模型，开始用 Zero 写代码吧！