Use modelos de IA gratuitos no Zed
Zed é um editor de código de código aberto com um painel de agente. Ele pode usar um provedor compatível com OpenAI ou um servidor Ollama. Este guia conecta o Zed a modelos gratuitos por meio do FreeLLMAPI, com qualquer um dos dois métodos. Uma seção curta no final trata do JetBrains AI Assistant.
O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.
Duas formas de conectar o Zed
| Método | Configuração do Zed | Endpoint do FreeLLMAPI | Chave |
|---|---|---|---|
| Provedor compatível com OpenAI (recomendado) | language_models.openai_compatible | http://localhost:3001/v1 | Chave unificada, na interface de configurações do Zed ou em uma variável de ambiente |
| Provedor Ollama | language_models.ollama | http://localhost:3001 (emulação do Ollama) | Nenhuma em loopback, ou a chave unificada |
Os dois métodos usam o mesmo roteador e o mesmo conjunto de modelos gratuitos. O método compatível com OpenAI não precisa de nenhuma mudança no lado do FreeLLMAPI. O método Ollama precisa da emulação do Ollama, que vem desativada por padrão.
Primeiro, instale o FreeLLMAPI. Abra http://localhost:3001, adicione pelo menos duas chaves gratuitas de provedores na página Keys e copie a sua chave unificada.
Instale no macOS ou no Linux
curl -fsSL https://freellmapi.co/install.sh | bashMétodo 1: provedor compatível com OpenAI
Abra o settings.json do seu Zed e adicione este bloco. O ID do provedor é freellmapi. max_tokens é a janela de contexto do modelo.
settings.json do Zed
{
"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
}
}
]
}
}
}
}Não coloque a chave em settings.json. Use um destes dois métodos:
- Execute
agent: open settingsna paleta de comandos. Vá até os provedores de LLM, encontre o provedor e digite a chave. O Zed a guarda no chaveiro do sistema. - Defina uma variável de ambiente. O Zed cria o nome a partir do ID do provedor em maiúsculas com underscores, mais
_API_KEY. Para o IDfreellmapi, o nome éFREELLMAPI_API_KEY. A variável tem prioridade sobre o chaveiro.
Chave como variável de ambiente
export FREELLMAPI_API_KEY=<unified-key>
zedAdicione uma entrada em available_models para cada modelo que você quer no menu de modelos. auto:smart e auto:fast também são nomes válidos.
Método 2: emulação do Ollama
O FreeLLMAPI pode funcionar como um servidor Ollama. Ele atende /api/tags, /api/chat, /api/generate, /api/show, /api/version e /api/embed. O streaming usa JSON delimitado por quebra de linha, como o Ollama.
- No painel do FreeLLMAPI, abra Keys, Agents.
- Defina a emulação do Ollama como
open-loopbackoukey-required. - Adicione o bloco abaixo ao
settings.jsondo Zed. - Abra o painel de agente e selecione um modelo.
settings.json do Zed
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}open-loopbacknão precisa de chave, mas aceita apenas requisições deste computador.- Se o FreeLLMAPI roda no Docker,
open-loopbackrecusa requisições por uma porta publicada. Usekey-requirede definaOLLAMA_API_KEYcom a sua chave unificada, ou digite-a na interface do provedor. - O Zed envia o tamanho do contexto como
num_ctx. O padrão é 4096 tokens, pequeno demais para trabalho com agente. Definacontext_window.
Escolha modelos para o painel de agente
A documentação do Zed diz que cada modelo e cada provedor precisam suportar chamada de ferramentas. Um modelo sem suporte a ferramentas mostra o rótulo "No tools" no painel de agente. Use modelos com chamada de ferramentas e uma janela de contexto grande.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Sim | Não |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Sim | Sim |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sim | Sim |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sim | Não |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Sim |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/dia Shared rate limit | Sim | Não |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/dia 70,000 tokens/min ~6M | Sim | Sim |
Mostrando 10 de 109 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
As camadas gratuitas têm limites por minuto e por dia. Quando um provedor envia um erro 429, o FreeLLMAPI tenta o próximo modelo da sua cadeia. Adicione chaves de quatro ou mais provedores para sessões longas de agente.
/v1/completions compatível com OpenAI. O FreeLLMAPI atende os dois. A documentação de previsões de edição do Zed não mostra um campo de chave de API para esses dois provedores. Não confirmamos esta combinação com o FreeLLMAPI, então teste antes de depender dela.JetBrains AI Assistant
O JetBrains AI Assistant pode usar um provedor compatível com OpenAI ou um servidor Ollama local. Abra Settings, Tools, AI Assistant, Providers & API keys. Há duas opções:
- Use a sua própria chave, compatível com OpenAI: digite a base URL
http://localhost:3001/v1, a sua chave unificada e um ID de modelo, comoauto. A documentação da JetBrains diz que o BYOK funciona com agentes sem uma assinatura do JetBrains AI. - Ollama: em Third-party AI providers, selecione Ollama. Digite
http://localhost:3001no campo de URL e clique em Test Connection. Depois, atribua os modelos em Models Assignment. Ative a emulação do Ollama no FreeLLMAPI primeiro.
A documentação da JetBrains indica limites para modelos locais: os agentes não podem usá-los, e o AI Assistant não consegue chamar ferramentas MCP com eles. Sugestões de completação em linha e de próxima edição usam modelos da JetBrains por padrão. Para trabalho com agente, use a opção BYOK.
Solução de problemas
| Problema | Causa | Solução |
|---|---|---|
401 "Invalid API key" | O Zed não tem chave para o provedor, ou a chave está errada | Defina FREELLMAPI_API_KEY, ou digite a chave nas configurações do agente |
| Rótulo "No tools" no modelo | As ferramentas estão desativadas para o modelo, ou o modelo não tem chamada de ferramentas | Defina "tools": true e use um modelo da tabela |
| O provedor Ollama não mostra modelos | A emulação do Ollama está desativada no FreeLLMAPI | Ative-a em Keys, Agents |
| Requisições do Ollama recusadas pelo Docker | open-loopback aceita apenas pares de loopback | Use key-required com a sua chave unificada |
| Prompts longos perdem contexto | num_ctx é 4096 tokens | Defina context_window nas configurações do Ollama |
| "Todos os modelos com limite de taxa após N tentativas" | Todas as chaves atingiram o limite | Adicione chaves de mais provedores, ou aguarde o fim dos períodos de espera |
Perguntas frequentes
Posso usar um LLM personalizado no Zed?
Sim. Adicione um provedor openai_compatible com api_url e available_models em language_models no settings.json. O Zed também oferece um provedor Ollama com uma api_url personalizada.
Como uso modelos de IA gratuitos no Zed?
Aponte um provedor compatível com OpenAI para o FreeLLMAPI em http://localhost:3001/v1. O gateway envia cada requisição para camadas gratuitas de provedores, então a inferência custa US$ 0.
Onde o Zed guarda a chave de API de um provedor personalizado?
O Zed guarda, no chaveiro do sistema, a chave que você digita nas configurações do agente. Você também pode definir uma variável de ambiente com o nome do ID do provedor, por exemplo FREELLMAPI_API_KEY.
O JetBrains AI Assistant funciona com modelos gratuitos?
Sim. Use Bring your own key com uma base URL compatível com OpenAI, ou o provedor Ollama. A documentação da JetBrains diz que os agentes não podem usar modelos locais, então use BYOK para trabalho com agente.
Guias relacionados
- Modelos de IA gratuitos no VS Code
- Continue com uma API gratuita de LLM
- Cline, Roo Code e Kilo Code com uma API gratuita
- Melhores APIs gratuitas de modelos para código
- URLs base de APIs gratuitas compatíveis com OpenAI
Fontes
- Zed docs: use API access (OpenAI-compatible providers) (verificado em 20 November 2026)
- Zed docs: use a local model (Ollama) (verificado em 20 November 2026)
- Zed docs: agent panel (verificado em 20 November 2026)
- Zed docs: edit prediction (verificado em 20 November 2026)
- JetBrains AI Assistant: use custom models (verificado em 20 November 2026)
- JetBrains AI Assistant: bring your own key (verificado em 20 November 2026)
- FreeLLMAPI docs: Ollama clients (verificado em 20 November 2026)