Source: https://aiprimetech.io/it/learn/use-claude-api-with-zed/

[Home](/it/) / [Impara](/it/learn/) / Collega Zed a Claude tramite il gateway 

# Collega Zed a Claude tramite il gateway 

Zed è veloce e il suo assistente è davvero utile, ma il modo in cui accetta un endpoint Claude personalizzato non si trova dove la maggior parte delle persone cerca inizialmente. Il provider Anthropic nativo non consente di personalizzare l'URL di base, quindi il percorso più semplice verso il gateway passa invece dal blocco openai_compatible di Zed. 

## Perché non usare il provider Anthropic 

Zed include un provider Anthropic nativo e l'istinto è quello di indirizzarlo al gateway. Il problema è che questo provider non dispone di un'impostazione api_url, quindi non esiste un campo supportato con cui reindirizzarlo dall'host Anthropic predefinito. 

Questa singola limitazione è il motivo per cui tante persone si bloccano. Anziché cercare di aggirarla, instrada Claude tramite il meccanismo generico openai_compatible, che espone l'URL di base ed è progettato proprio per gli endpoint di terze parti. 

È utile pensare al provider nativo come vincolato a una sola destinazione e al provider openai_compatible come a quello configurabile. Per un gateway multimodello, il percorso configurabile è comunque quello più adatto, perché lo stesso blocco può dare accesso a Claude e a qualsiasi altro modello offerto dal gateway tramite un unico api_url. In questo modo tutta la configurazione dei modelli dell'editor rimane in un solo posto, anziché essere suddivisa tra due meccanismi di provider con regole diverse. Questa singola decisione determina il resto della configurazione, quindi conviene comprenderla prima di modificare qualsiasi cosa. Una volta accettato che il blocco openai_compatible è il percorso supportato, resta solo da compilare i campi. 

## Aggiungi un blocco openai_compatible 

In settings.json, sotto language_models.openai_compatible, aggiungi un provider con un nome. Imposta il suo api_url sull'indirizzo del gateway con /v1 alla fine; Zed aggiunge /chat/completions a quel percorso, quindi a rispondere è l'interfaccia del gateway compatibile con OpenAI. 

Il nome che scegli è arbitrario e diventa l'etichetta nel menu dei modelli di Zed. Un blocco può servire diversi modelli Claude, ciascuno dichiarato nel passaggio successivo. 

Il suffisso /v1 è essenziale: Zed costruisce il percorso chat-completions direttamente sotto il valore fornito come api_url, quindi l'assenza di /v1 invia le richieste al percorso sbagliato e una barra finale può duplicare il percorso. Impostalo esattamente sull'host seguito da /v1 e l'instradamento funzionerà correttamente. Un rapido ricaricamento delle impostazioni dopo la modifica conferma che Zed ha interpretato il blocco senza errori. Se il provider non compare, la prima cosa da controllare è un errore di sintassi JSON nel blocco. 

## Dichiara available_models 

Zed non rileva automaticamente i modelli su un endpoint personalizzato, quindi elencali manualmente in available_models. Ogni voce richiede un name corrispondente all'ID del gateway, un display_name per il menu e un valore max_tokens adeguato al modello. 

Usa claude-sonnet-4-5 per l'assistenza quotidiana e aggiungi claude-opus-4-8 come seconda voce per le attività più complesse. Poiché li elenchi esplicitamente, il menu mostra esattamente l'insieme desiderato e nient'altro. 

Il campo name deve corrispondere all'ID del gateway carattere per carattere, mentre display_name è puramente estetico e può apparire nel menu come preferisci. Un valore name errato è la causa più comune di un modello che compare ma restituisce errori quando viene usato, quindi copia l'ID direttamente dal gateway anziché digitarlo a memoria. Elencare solo i modelli che usi davvero mantiene il menu breve e rende immediata la scelta nel lavoro quotidiano. Aggiungere un modello in seguito richiede la modifica di una sola riga, quindi non è necessario dichiarare tutto fin dall'inizio. 

## Dove viene conservata la chiave 

La chiave API non va in settings.json. Zed la memorizza nel portachiavi del sistema operativo o la legge da una variabile d'ambiente denominata in base al provider, come AIPRIME_API_KEY, mantenendo così il segreto fuori dalla configurazione sincronizzata. 

Dopo aver salvato, apri l'assistente, scegli il provider dal menu e inserisci la chiave quando richiesto. Da quel momento Zed usa il portachiavi per l'autenticazione e il file delle impostazioni rimane privo di credenziali. 

Questa separazione è davvero utile se sincronizzi le impostazioni di Zed tra più computer o le includi in un repository di dotfile: la configurazione può essere trasferita liberamente perché non contiene segreti e ogni computer fornisce la propria chiave tramite il portachiavi o l'ambiente. È una soluzione più pulita rispetto agli strumenti che incorporano la chiave nel file di configurazione. È anche il motivo per cui condividere una configurazione di Zed con un collega è sicuro: userà la propria chiave e la tua non verrà mai trasferita. Lo stesso vale per il commit delle impostazioni in un repository di dotfile. 

## Il percorso nativo tramite ACP 

Se desideri specificamente il comportamento nativo di Anthropic anziché l'interfaccia compatibile con OpenAI, Zed supporta l'Agent Client Protocol con Claude Code. Esegui Claude Code come agente e Zed comunica con esso tramite ACP. 

In questa configurazione, Claude Code dispone del proprio ANTHROPIC_BASE_URL indirizzato al gateway, quindi Zed non ha mai bisogno di un api_url Anthropic proprio. È il modo più semplice per ottenere il comportamento realmente nativo di Messages all'interno dell'editor. 

Il compromesso è che ACP offre il ciclo operativo completo dell'agente di Claude Code anziché l'assistente integrato più leggero di Zed: è più potente, ma anche più impegnativo da usare. Scegli il percorso openai_compatible per un aiuto inline rapido e il percorso ACP quando vuoi un agente completo che gestisca modifiche in più passaggi dall'interno dell'editor. La maggior parte delle persone inizia con il percorso più leggero e adotta ACP solo quando desidera un agente completo nell'editor. Puoi mantenerli entrambi disponibili e usare quello più adatto all'attività. 

Copia

```
// Zed settings.json
{
  "language_models": {
    "openai_compatible": {
      "aiprime": {
        "api_url": "https://aiprimetech.io/v1",
        "available_models": [
          { "name": "claude-sonnet-4-5",
            "display_name": "Claude Sonnet",
            "max_tokens": 200000 }
        ]
      }
    }
  }
}
// Key goes in the keychain / AIPRIME_API_KEY env var, NOT this file.
```

## Domande frequenti 

 Perché non posso impostare un URL di base di Claude in Zed?

Il provider Anthropic nativo di Zed non dispone di un campo api_url. Usa il blocco openai_compatible, che espone api_url, e indirizzalo a https://aiprimetech.io/v1. Dove inserisco api_url?

Sotto language_models.openai_compatible.<name>.api_url, con /v1 alla fine. Zed aggiunge /chat/completions a quel percorso. Dove va la chiave API?

Non in settings.json: Zed la conserva nel portachiavi del sistema operativo o in una variabile d'ambiente denominata in base al provider, come AIPRIME_API_KEY. Come ottengo il comportamento nativo di Anthropic?

Usa ACP con Claude Code come agente; Claude Code usa ANTHROPIC_BASE_URL per collegarsi al gateway, quindi Zed non ha bisogno di un api_url Anthropic.  

Inizia a usare Claude in pochi minuti

Ottieni una chiave API: non servono un account Anthropic né una lista d'attesa.[Ottieni la tua chiave API](/register) 

AI Prime Tech è un gateway API indipendente. Non è affiliato ad Anthropic, non è approvato da Anthropic e non è un suo rivenditore. Claude e i nomi dei modelli correlati sono marchi dei rispettivi proprietari.    

## Altre guide all'API di Claude

[Come ottenere una chiave API di Claude](/it/learn/how-to-get-a-claude-api-key/)[I prezzi dell'API Claude, spiegati](/it/learn/claude-api-pricing-explained/)[Il modo più economico per usare l'API Claude](/it/learn/cheapest-way-to-use-claude-api/)[Cursor illimitato con l'API Claude](/learn/use-claude-api-with-cursor/)[Accesso illimitato a Claude Code](/it/learn/use-claude-api-with-claude-code/)[Gateway API Claude e accesso diretto ad Anthropic a confronto](/it/learn/claude-api-vs-anthropic-direct/)[Usare Claude tramite un'API compatibile con OpenAI](/it/learn/openai-compatible-claude-api/)[I modelli Claude spiegati: un confronto tra Claude Opus, Sonnet, Haiku e Fable — tutti i modelli API Claude, i nomi dei modelli Anthropic e i prezzi (2026)](/it/learn/claude-api-models-compared/)[Pagare l'API Claude con criptovalute](/it/learn/claude-api-with-crypto-payment/)[Accesso all'API Claude senza lista d'attesa](/it/learn/claude-api-without-waitlist/)[Come ridurre l'utilizzo dei token di Claude](/it/learn/how-to-reduce-claude-token-usage/)[Cline illimitato con l'API Claude](/it/learn/use-claude-api-with-cline/)[Roo Code illimitato con l'API Claude](/it/learn/use-claude-api-with-roo-code/)[Claude illimitato negli IDE JetBrains](/it/learn/use-claude-api-with-jetbrains/)[Aider senza limiti con l'API di Claude](/it/learn/use-claude-api-with-aider/)[Claude illimitato in VS Code](/it/learn/use-claude-api-with-vscode/)[Configurazione di OpenCode per Claude: impostazione di opencode.json, modelli ed errori comuni](/it/learn/use-claude-api-with-opencode/)[Eseguire un agente Hermes senza limiti su Claude](/it/learn/run-hermes-agent-with-claude-api/)[Eseguire OpenClaw senza limiti con Claude](/it/learn/run-openclaw-with-claude-api/)[Cosa significa un'API compatibile con Anthropic](/it/learn/anthropic-compatible-api/)[Chiave API di Claude Code — ANTHROPIC_API_KEY: come ottenerla, configurarla e quando usare invece claude setup-token](/it/learn/claude-code-api-key-setup/)[Costi dell'API di Claude Code — Prezzi e come ridurli](/it/learn/claude-code-api-costs/)[Gli errori dell'API Claude spiegati: errore del server 500, sovraccarico 529, limite di frequenza 429, richiesta non valida 400 — e la soluzione per ciascuno](/it/learn/claude-api-errors-troubleshooting/)[Come acquistare crediti per l'API di Claude e perché un credito Claude conviene più di qualsiasi offerta per «acquistare un account Claude»](/it/learn/buy-claude-api-credits/)[API Claude gratuita: esiste una chiave API di Claude gratuita e che cosa è davvero gratuito nel 2026?](/it/learn/claude-api-free-trial/)[API Claude e abbonamento Claude Pro/Max a confronto — Quale scegliere](/it/learn/claude-api-vs-subscription/)[Eseguire la CLI di Codex su Claude](/it/learn/use-claude-api-with-codex/)[Collegare Claude a n8n](/it/learn/use-claude-api-with-n8n/)[Instradare LiteLLM verso Claude](/it/learn/use-claude-api-with-litellm/)[Usare Claude in Kilo Code](/it/learn/use-claude-api-with-kilo-code/)[Integrare Claude in GitHub Copilot](/it/learn/use-claude-api-with-github-copilot/)[Collega Cherry Studio a Claude](/it/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: importazione, base_url, streaming, strumenti ed errori](/it/learn/use-claude-api-with-langchain/)[SDK Python di Anthropic: installazione, configurazione di base_url, streaming e gestione degli errori](/it/learn/anthropic-python-sdk/)[Claude con Vercel AI SDK: baseURL di createAnthropic, streaming e soluzioni ai problemi](/it/learn/use-claude-api-with-vercel-ai-sdk/)[Esegui Factory Droid con Claude](/it/learn/use-claude-api-with-factory-droid/)[L'API di Claude Code spiegata](/it/learn/claude-code-api/)[Integrare l'API di Claude nella tua applicazione](/it/learn/claude-api-integration/)[Come ottenere un utilizzo illimitato di Claude e perché non esiste un «Claude Code craccato»](/it/learn/get-unlimited-claude-usage/)