Home / Guide / Usi modelli AI gratuiti in Zed

Usi modelli AI gratuiti in Zed

Zed è un editor di codice open source con un pannello agente. Può usare un provider compatibile con OpenAI oppure un server Ollama. Questa guida collega Zed a modelli gratuiti tramite FreeLLMAPI con uno dei due metodi. Una breve sezione alla fine tratta JetBrains AI Assistant.

Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.

Due modi per collegare Zed

MetodoImpostazione di ZedEndpoint FreeLLMAPIChiave
Provider compatibile con OpenAI (consigliato)language_models.openai_compatiblehttp://localhost:3001/v1Chiave unificata, nell'interfaccia delle impostazioni di Zed oppure in una variabile d'ambiente
Provider Ollamalanguage_models.ollamahttp://localhost:3001 (emulazione Ollama)Nessuna sul loopback, oppure la chiave unificata

Entrambi i metodi usano lo stesso router e lo stesso insieme di modelli gratuiti. Il metodo compatibile con OpenAI non richiede modifiche lato FreeLLMAPI. Il metodo Ollama richiede l'emulazione Ollama, che è disattivata per impostazione predefinita.

Prima installi FreeLLMAPI. Apra http://localhost:3001, aggiunga almeno due chiavi gratuite di provider nella pagina Keys e copi la Sua chiave unificata.

Installazione su macOS o Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Metodo 1: provider compatibile con OpenAI

Apra il Suo settings.json di Zed e aggiunga questo blocco. L'ID del provider è freellmapi. max_tokens è la finestra di contesto del modello.

settings.json di 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
            }
          }
        ]
      }
    }
  }
}

Non inserisca la chiave in settings.json. Usi uno di questi due metodi:

  • Esegua agent: open settings dalla palette dei comandi. Vada ai provider LLM, trovi il provider e inserisca la chiave. Zed la conserva nel portachiavi di sistema.
  • Imposti una variabile d'ambiente. Zed crea il nome dall'ID del provider in maiuscolo con trattini bassi, più _API_KEY. Per l'ID freellmapi, il nome è FREELLMAPI_API_KEY. La variabile ha la precedenza sul portachiavi.

Chiave come variabile d'ambiente

export FREELLMAPI_API_KEY=<unified-key>
zed

Aggiunga una voce in available_models per ogni modello che vuole nel menu dei modelli. Anche auto:smart e auto:fast sono nomi validi.

Metodo 2: emulazione Ollama

FreeLLMAPI può agire come server Ollama. Serve /api/tags, /api/chat, /api/generate, /api/show, /api/version e /api/embed. Lo streaming usa JSON delimitato da newline, come fa Ollama.

  1. Nella dashboard di FreeLLMAPI, apra Keys, Agents.
  2. Imposti l'emulazione Ollama su open-loopback oppure key-required.
  3. Aggiunga il blocco qui sotto al settings.json di Zed.
  4. Apra il pannello agente e selezioni un modello.

settings.json di Zed

{
  "language_models": {
    "ollama": {
      "api_url": "http://localhost:3001",
      "context_window": 128000
    }
  }
}
  • open-loopback non richiede chiave, ma solo per le richieste provenienti da questo computer.
  • Se FreeLLMAPI è in esecuzione in Docker, open-loopback rifiuta le richieste che arrivano attraverso una porta pubblicata. Usi key-required e imposti OLLAMA_API_KEY con la Sua chiave unificata, oppure la inserisca nell'interfaccia del provider.
  • Zed invia la dimensione del contesto come num_ctx. Il valore predefinito è 4096 token, troppo piccolo per il lavoro con agenti. Imposti context_window.

Scelga i modelli per il pannello agente

La documentazione di Zed dice che ogni modello e ogni provider devono supportare le chiamate di strumenti. Un modello senza supporto agli strumenti mostra l'etichetta "No tools" nel pannello agente. Usi modelli con chiamate di strumenti e una finestra di contesto ampia.

Modelli gratuiti per il pannello agente di Zed: chiamate di strumenti e contesto 128K+
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3UnoRouter1M1 richieste/min
1 req/min per model
SìNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 richieste/min
40 RPM
SìSì
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 richieste/min
50 richieste/giorno
Shared rate limit
SìNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 richieste/min
250 richieste/giorno
70,000 token/min
~6M
SìSì

Mostrati 10 di 109 modelli gratuiti corrispondenti. Vedi tutti i modelli.

Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.

I livelli gratuiti hanno limiti al minuto e al giorno. Quando un provider invia un errore 429, FreeLLMAPI prova il modello successivo della Sua catena. Aggiunga chiavi di quattro o più provider per sessioni lunghe con l'agente.

Previsioni di modifica: Zed può inviare le previsioni di modifica a un server Ollama oppure a un endpoint /v1/completions compatibile con OpenAI. FreeLLMAPI serve entrambi. La documentazione di Zed sulle previsioni di modifica non mostra un campo per la chiave API per questi due provider. Non abbiamo verificato questa combinazione con FreeLLMAPI, quindi la provi prima di farvi affidamento.

JetBrains AI Assistant

JetBrains AI Assistant può usare un provider compatibile con OpenAI oppure un server Ollama locale. Apra Settings, Tools, AI Assistant, Providers & API keys. Ci sono due opzioni:

  • Porti la Sua chiave, compatibile con OpenAI: inserisca il base URL http://localhost:3001/v1, la Sua chiave unificata e un ID di modello come auto. La documentazione di JetBrains dice che BYOK funziona con gli agenti senza un abbonamento JetBrains AI.
  • Ollama: in Third-party AI providers, selezioni Ollama. Inserisca http://localhost:3001 nel campo URL e faccia clic su Test Connection. Poi assegni i modelli in Models Assignment. Attivi prima l'emulazione Ollama in FreeLLMAPI.

La documentazione di JetBrains indica limiti per i modelli locali: gli agenti non possono usarli, e AI Assistant non può chiamare gli strumenti MCP con essi. Il completamento inline e i suggerimenti della modifica successiva usano per impostazione predefinita i modelli JetBrains. Per il lavoro con agenti, usi l'opzione BYOK.

Risoluzione dei problemi

ProblemaCausaSoluzione
401 "Invalid API key" (messaggio in inglese: chiave API non valida)Zed non ha la chiave per il provider, oppure la chiave è errataImposti FREELLMAPI_API_KEY, oppure inserisca la chiave nelle impostazioni dell'agente
Etichetta "No tools" sul modelloGli strumenti sono disattivati per il modello, oppure il modello non supporta le chiamate di strumentiImposti "tools": true e usi un modello dalla tabella
Il provider Ollama non mostra modelliL'emulazione Ollama è disattivata in FreeLLMAPIL'attivi in Keys, Agents
Le richieste Ollama da Docker sono rifiutateopen-loopback accetta solo peer di loopbackUsi key-required con la Sua chiave unificata
I prompt lunghi perdono contestonum_ctx è 4096 tokenImposti context_window nelle impostazioni di Ollama
"All models rate-limited after N attempts" (messaggio in inglese: tutti i modelli hanno raggiunto il limite dopo N tentativi)Tutte le chiavi sono al limiteAggiunga chiavi di più provider, oppure attenda la fine dei periodi di attesa
Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

Domande frequenti

Posso usare un LLM personalizzato in Zed?

Sì. Aggiunga un provider openai_compatible con api_url e available_models a language_models in settings.json. Zed supporta anche un provider Ollama con un api_url personalizzato.

Come uso modelli AI gratuiti in Zed?

Indirizzi un provider compatibile con OpenAI verso FreeLLMAPI su http://localhost:3001/v1. Il gateway invia ogni richiesta ai livelli gratuiti dei provider, quindi l'inferenza costa 0 $.

Dove conserva Zed la chiave API per un provider personalizzato?

Zed conserva nel portachiavi di sistema la chiave che Lei inserisce nelle impostazioni dell'agente. Può anche impostare una variabile d'ambiente con il nome derivato dall'ID del provider, per esempio FREELLMAPI_API_KEY.

JetBrains AI Assistant funziona con modelli gratuiti?

Sì. Usi BYOK (Bring your own key) con un base URL compatibile con OpenAI, oppure il provider Ollama. La documentazione di JetBrains dice che gli agenti non possono usare modelli locali, quindi usi BYOK per il lavoro con agenti.

Guide correlate

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti