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
| Metodo | Impostazione di Zed | Endpoint FreeLLMAPI | Chiave |
|---|---|---|---|
| Provider compatibile con OpenAI (consigliato) | language_models.openai_compatible | http://localhost:3001/v1 | Chiave unificata, nell'interfaccia delle impostazioni di Zed oppure in una variabile d'ambiente |
| Provider Ollama | language_models.ollama | http://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 | bashMetodo 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 settingsdalla 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'IDfreellmapi, il nome èFREELLMAPI_API_KEY. La variabile ha la precedenza sul portachiavi.
Chiave come variabile d'ambiente
export FREELLMAPI_API_KEY=<unified-key>
zedAggiunga 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.
- Nella dashboard di FreeLLMAPI, apra Keys, Agents.
- Imposti l'emulazione Ollama su
open-loopbackoppurekey-required. - Aggiunga il blocco qui sotto al
settings.jsondi Zed. - Apra il pannello agente e selezioni un modello.
settings.json di Zed
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}open-loopbacknon richiede chiave, ma solo per le richieste provenienti da questo computer.- Se FreeLLMAPI è in esecuzione in Docker,
open-loopbackrifiuta le richieste che arrivano attraverso una porta pubblicata. Usikey-requirede impostiOLLAMA_API_KEYcon 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. Imposticontext_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.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 richieste/min 1 req/min per model | Sì | No |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 richieste/min 40 RPM | Sì | Sì |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sì | Sì |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sì | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 richieste/min 50 richieste/giorno 50 req/day account-wide (1,000 after a $10 purchase) | Sì | Sì |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 richieste/min 50 richieste/giorno Shared rate limit | Sì | No |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 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.
/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 comeauto. 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:3001nel 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
| Problema | Causa | Soluzione |
|---|---|---|
401 "Invalid API key" (messaggio in inglese: chiave API non valida) | Zed non ha la chiave per il provider, oppure la chiave è errata | Imposti FREELLMAPI_API_KEY, oppure inserisca la chiave nelle impostazioni dell'agente |
| Etichetta "No tools" sul modello | Gli strumenti sono disattivati per il modello, oppure il modello non supporta le chiamate di strumenti | Imposti "tools": true e usi un modello dalla tabella |
| Il provider Ollama non mostra modelli | L'emulazione Ollama è disattivata in FreeLLMAPI | L'attivi in Keys, Agents |
| Le richieste Ollama da Docker sono rifiutate | open-loopback accetta solo peer di loopback | Usi key-required con la Sua chiave unificata |
| I prompt lunghi perdono contesto | num_ctx è 4096 token | Imposti 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 limite | Aggiunga chiavi di più provider, oppure attenda la fine dei periodi di attesa |
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
- AI gratuite in VS Code
- Continue con un'API LLM gratuita
- Cline, Roo Code e Kilo Code con un'API gratuita
- Migliori API gratuite per modelli di codice
- Base URL di API gratuite compatibili con OpenAI
Fonti
- Zed docs: use API access (OpenAI-compatible providers) (verificato il 20 November 2026)
- Zed docs: use a local model (Ollama) (verificato il 20 November 2026)
- Zed docs: agent panel (verificato il 20 November 2026)
- Zed docs: edit prediction (verificato il 20 November 2026)
- JetBrains AI Assistant: use custom models (verificato il 20 November 2026)
- JetBrains AI Assistant: bring your own key (verificato il 20 November 2026)
- FreeLLMAPI docs: Ollama clients (verificato il 20 November 2026)