首页 / 指南 / 在 Zed 中使用免费 AI 模型

在 Zed 中使用免费 AI 模型

Zed 是一款带有智能体面板的开源代码编辑器。它可以使用兼容 OpenAI 的服务商,也可以使用 Ollama 服务器。本指南使用其中任一方式,通过 FreeLLMAPI 将 Zed 连接到免费模型。末尾的简短部分介绍 JetBrains AI Assistant。

代码、模型名称和目录中的实时标签以英文显示。

连接 Zed 的两种方式

方式Zed 设置FreeLLMAPI 端点密钥
兼容 OpenAI 的服务商(推荐)language_models.openai_compatiblehttp://localhost:3001/v1统一密钥,可在 Zed 设置界面或环境变量中填写
Ollama 服务商language_models.ollamahttp://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。对于 ID freellmapi,变量名为 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 相同。

  1. 在 FreeLLMAPI 控制台中,打开 Keys, Agents。
  2. 将 Ollama 模拟设置为 open-loopback 或 key-required。
  3. 将下方代码块添加到 Zed 的 settings.json。
  4. 打开智能体面板并选择一个模型。

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”标签。请使用支持工具调用且上下文窗口较大的模型。

适用于 Zed 智能体面板的免费模型:支持工具调用,上下文 128K 以上
模型免费提供方上下文免费额度(最优惠)工具视觉
GLM 5.3UnoRouter1M1 请求/分钟
1 req/min per model
是否
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 请求/分钟
40 RPM
是是
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota是是
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowance是否
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit是是
Gemini 3.7 FlashGoogle AI Studio1M10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit是是
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 请求/分钟
50 请求/天
50 req/day account-wide (1,000 after a $10 purchase)
是是
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 请求/分钟
50 请求/天
Shared rate limit
是否
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 请求/分钟
250 请求/天
70,000 令牌/分钟
~6M
是是

显示 10 个(共 109 个匹配的免费模型)。 查看所有模型.

数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。

免费额度有每分钟和每天的限制。当某个服务商返回 429 错误时,FreeLLMAPI 会尝试你的备用链中的下一个模型。进行长时间的智能体会话时,请添加四个或更多服务商的密钥。

编辑预测:Zed 可以将编辑预测发送到 Ollama 服务器,或兼容 OpenAI 的 /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”所有密钥都已达到限制添加更多服务商的密钥,或等待冷却期结束
通过一个密钥使用以上每一个模型。 FreeLLMAPI 是一个开源的自托管路由器。它将所有这些免费套餐放在一个兼容 OpenAI 的端点之后,并在某个套餐被限速时自动切换。 浏览目录 或 立即开始.

常见问题

我能在 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。

相关指南

来源

全部指南 · 浏览所有免费模型