Início / Guias / Use modelos de IA gratuitos no Zed

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étodoConfiguração do ZedEndpoint do FreeLLMAPIChave
Provedor compatível com OpenAI (recomendado)language_models.openai_compatiblehttp://localhost:3001/v1Chave unificada, na interface de configurações do Zed ou em uma variável de ambiente
Provedor Ollamalanguage_models.ollamahttp://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 | bash

Mé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 settings na 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 ID freellmapi, 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>
zed

Adicione 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.

  1. No painel do FreeLLMAPI, abra Keys, Agents.
  2. Defina a emulação do Ollama como open-loopback ou key-required.
  3. Adicione o bloco abaixo ao settings.json do Zed.
  4. 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-loopback não precisa de chave, mas aceita apenas requisições deste computador.
  • Se o FreeLLMAPI roda no Docker, open-loopback recusa requisições por uma porta publicada. Use key-required e defina OLLAMA_API_KEY com 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. Defina context_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.

Modelos gratuitos para o painel de agente do Zed: chamada de ferramentas e contexto de 128K+
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
SimNão
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
SimSim
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSimNão
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSimSim
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/dia
Shared rate limit
SimNão
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/dia
70,000 tokens/min
~6M
SimSim

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.

Previsões de edição: o Zed pode enviar previsões de edição para um servidor Ollama ou para um endpoint /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, como auto. 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:3001 no 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

ProblemaCausaSolução
401 "Invalid API key"O Zed não tem chave para o provedor, ou a chave está erradaDefina FREELLMAPI_API_KEY, ou digite a chave nas configurações do agente
Rótulo "No tools" no modeloAs ferramentas estão desativadas para o modelo, ou o modelo não tem chamada de ferramentasDefina "tools": true e use um modelo da tabela
O provedor Ollama não mostra modelosA emulação do Ollama está desativada no FreeLLMAPIAtive-a em Keys, Agents
Requisições do Ollama recusadas pelo Dockeropen-loopback aceita apenas pares de loopbackUse key-required com a sua chave unificada
Prompts longos perdem contextonum_ctx é 4096 tokensDefina context_window nas configurações do Ollama
"Todos os modelos com limite de taxa após N tentativas"Todas as chaves atingiram o limiteAdicione chaves de mais provedores, ou aguarde o fim dos períodos de espera
Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

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

Fontes

Todos os guias · Ver todos os modelos gratuitos