在 Zed 中使用免费 AI 模型
Zed 是一款带有智能体面板的开源代码编辑器。它可以使用兼容 OpenAI 的服务商,也可以使用 Ollama 服务器。本指南使用其中任一方式,通过 FreeLLMAPI 将 Zed 连接到免费模型。末尾的简短部分介绍 JetBrains AI Assistant。
代码、模型名称和目录中的实时标签以英文显示。
连接 Zed 的两种方式
| 方式 | Zed 设置 | FreeLLMAPI 端点 | 密钥 |
|---|---|---|---|
| 兼容 OpenAI 的服务商(推荐) | language_models.openai_compatible | http://localhost:3001/v1 | 统一密钥,可在 Zed 设置界面或环境变量中填写 |
| Ollama 服务商 | language_models.ollama | http://localhost:3001(Ollama 模拟) | 本机回环地址无需密钥,或使用统一密钥 |
两种方式使用相同的路由器和相同的免费模型池。兼容 OpenAI 的方式无需更改 FreeLLMAPI 端的设置。Ollama 方式需要启用 Ollama 模拟,该功能默认关闭。
首先安装 FreeLLMAPI。打开 http://localhost:3001,在密钥页面至少添加两个免费服务商的密钥,然后复制你的统一密钥。
在 macOS 或 Linux 上安装
curl -fsSL https://freellmapi.co/install.sh | bash方式 1:兼容 OpenAI 的服务商
打开 Zed 的 settings.json,并添加以下代码块。服务商 ID 为 freellmapi。max_tokens 是该模型的上下文窗口。
Zed settings.json
{
"language_models": {
"openai_compatible": {
"freellmapi": {
"api_url": "http://localhost:3001/v1",
"available_models": [
{
"name": "auto",
"display_name": "FreeLLMAPI Auto",
"max_tokens": 128000,
"max_output_tokens": 8192,
"capabilities": {
"tools": true,
"images": false,
"parallel_tool_calls": false,
"prompt_cache_key": false,
"chat_completions": true
}
}
]
}
}
}
}不要将密钥写入 settings.json。请使用以下两种方法之一:
- 从命令面板运行
agent: open settings。进入 LLM providers,找到该服务商并输入密钥。Zed 会将其保存在系统钥匙串中。 - 设置环境变量。Zed 会根据服务商 ID 生成变量名:大写蛇形命名加上
_API_KEY。对于 IDfreellmapi,变量名为FREELLMAPI_API_KEY。该变量的优先级高于钥匙串。
以环境变量形式设置密钥
export FREELLMAPI_API_KEY=<unified-key>
zed为你希望出现在模型菜单中的每个模型,在 available_models 中添加一个条目。auto:smart 和 auto:fast 也是有效名称。
方式 2:Ollama 模拟
FreeLLMAPI 可以充当 Ollama 服务器。它提供 /api/tags、/api/chat、/api/generate、/api/show、/api/version 和 /api/embed。流式输出使用换行分隔的 JSON,与 Ollama 相同。
- 在 FreeLLMAPI 控制台中,打开 Keys, Agents。
- 将 Ollama 模拟设置为
open-loopback或key-required。 - 将下方代码块添加到 Zed 的
settings.json。 - 打开智能体面板并选择一个模型。
Zed settings.json
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}open-loopback不需要密钥,但仅接受来自本机的请求。- 如果 FreeLLMAPI 在 Docker 中运行,
open-loopback会拒绝通过已发布端口发来的请求。请使用key-required,并将OLLAMA_API_KEY设置为你的统一密钥,或在服务商界面中输入该密钥。 - Zed 以
num_ctx的形式发送上下文大小。默认值为 4096 tokens,对智能体工作而言太小。请设置context_window。
为智能体面板选择模型
Zed 文档指出,每个模型和服务商都必须支持工具调用。不支持工具的模型会在智能体面板中显示“No tools”标签。请使用支持工具调用且上下文窗口较大的模型。
| 模型 | 免费提供方 | 上下文 | 免费额度(最优惠) | 工具 | 视觉 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 请求/分钟 1 req/min per model | 是 | 否 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 请求/分钟 40 RPM | 是 | 是 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 是 | 是 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 是 | 否 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 请求/分钟 50 请求/天 50 req/day account-wide (1,000 after a $10 purchase) | 是 | 是 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 请求/分钟 50 请求/天 Shared rate limit | 是 | 否 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 请求/分钟 250 请求/天 70,000 令牌/分钟 ~6M | 是 | 是 |
显示 10 个(共 109 个匹配的免费模型)。 查看所有模型.
数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。
免费额度有每分钟和每天的限制。当某个服务商返回 429 错误时,FreeLLMAPI 会尝试你的备用链中的下一个模型。进行长时间的智能体会话时,请添加四个或更多服务商的密钥。
/v1/completions 端点。FreeLLMAPI 同时支持这两种方式。Zed 编辑预测文档中,这两个服务商均未显示 API 密钥字段。我们尚未验证这种组合与 FreeLLMAPI 的兼容性,因此在依赖它之前请先进行测试。JetBrains AI Assistant
JetBrains AI Assistant 可以使用兼容 OpenAI 的服务商,也可以使用本地 Ollama 服务器。打开 Settings, Tools, AI Assistant, Providers & API keys。有两个选项:
- 自带密钥,兼容 OpenAI:输入 base URL
http://localhost:3001/v1、你的统一密钥,以及模型 ID,例如auto。JetBrains 文档指出,BYOK 无需 JetBrains AI 订阅即可用于智能体。 - Ollama:在 Third-party AI providers 中选择 Ollama。在 URL 字段中输入
http://localhost:3001,然后点击 Test Connection。接着在 Models Assignment 中分配模型。请先在 FreeLLMAPI 中开启 Ollama 模拟。
JetBrains 文档对本地模型给出了限制:智能体无法使用它们,AI Assistant 也无法通过它们调用 MCP 工具。行内补全和下一步编辑建议默认使用 JetBrains 模型。进行智能体工作时,请使用 BYOK 选项。
故障排除
| 问题 | 原因 | 解决方法 |
|---|---|---|
401 “Invalid API key” | Zed 没有该服务商的密钥,或密钥错误 | 设置 FREELLMAPI_API_KEY,或在智能体设置中输入密钥 |
| 模型上显示“No tools”标签 | 该模型未启用工具,或该模型不支持工具调用 | 设置 "tools": true,并使用表格中的模型 |
| Ollama 服务商不显示模型 | FreeLLMAPI 中未启用 Ollama 模拟 | 在 Keys, Agents 中将其开启 |
| 来自 Docker 的 Ollama 请求被拒绝 | open-loopback 只接受回环地址的请求 | 使用 key-required,并配合你的统一密钥 |
| 长提示丢失上下文 | num_ctx 为 4096 tokens | 在 Ollama 设置中设置 context_window |
| “All models rate-limited after N attempts” | 所有密钥都已达到限制 | 添加更多服务商的密钥,或等待冷却期结束 |
常见问题
我能在 Zed 中使用自定义 LLM 吗?
可以。在 settings.json 的 language_models 中添加一个 openai_compatible 服务商,并设置 api_url 和 available_models。Zed 也支持带有自定义 api_url 的 Ollama 服务商。
如何在 Zed 中使用免费 AI 模型?
将兼容 OpenAI 的服务商指向 FreeLLMAPI 的 http://localhost:3001/v1。网关会将每个请求发送到免费服务商额度,因此推理费用为 $0。
Zed 将自定义服务商的 API 密钥保存在哪里?
Zed 会将你在智能体设置中输入的密钥保存在系统钥匙串中。你也可以设置以服务商 ID 命名的环境变量,例如 FREELLMAPI_API_KEY。
JetBrains AI Assistant 能与免费模型一起使用吗?
可以。使用兼容 OpenAI 的 base URL 并选择“自带密钥”,或使用 Ollama 服务商。JetBrains 文档指出,智能体无法使用本地模型,因此进行智能体工作时请使用 BYOK。
相关指南
- VS Code 中的免费 AI 模型
- 在 Continue 中使用免费 LLM API
- Cline、Roo Code 和 Kilo Code 使用免费 API
- 最佳免费编程模型 API
- 免费兼容 OpenAI 的 API Base URL
来源
- Zed docs: use API access (OpenAI-compatible providers) (检查于 20 November 2026)
- Zed docs: use a local model (Ollama) (检查于 20 November 2026)
- Zed docs: agent panel (检查于 20 November 2026)
- Zed docs: edit prediction (检查于 20 November 2026)
- JetBrains AI Assistant: use custom models (检查于 20 November 2026)
- JetBrains AI Assistant: bring your own key (检查于 20 November 2026)
- FreeLLMAPI docs: Ollama clients (检查于 20 November 2026)