Source: https://aiprimetech.io/it/learn/run-hermes-agent-with-claude-api/ [Home](/it/) / [Impara](/it/learn/) / Hermes Agent con Claude tramite un gateway: configurazione del provider personalizzato, controlli dei costi e correzioni # Hermes Agent con Claude tramite un gateway: configurazione di un provider personalizzato, controllo dei costi e soluzioni ai problemi Hermes Agent conserva i segreti in ~/.hermes/.env e tutto il resto in ~/.hermes/config.yaml. Il modo affidabile per eseguirlo con Claude tramite un gateway è usare un provider personalizzato con nome che utilizzi il formato Anthropic Messages. La scorciatoia, provider: anthropic con un URL di base diverso, sembra corretta ma invia le richieste ad Anthropic per qualsiasi host che non riconosce. ## Installazione Linux / macOS / WSL2Copia ``` curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` WindowsCopia ``` iex (irm https://hermes-agent.nousresearch.com/install.ps1) ``` hermes setup esegue l'intera procedura guidata; hermes model gestisce solo provider e modello; hermes doctor verifica un'installazione esistente. ## Aggiungi il gateway come provider personalizzato ~/.hermes/.envCopia ``` AIPRIME_API_KEY=your_gateway_key ``` ~/.hermes/config.yamlCopia ``` providers: aiprime: api: https://aiprimetech.io/v1 key_env: AIPRIME_API_KEY transport: anthropic_messages catalog_provider: anthropic model: provider: custom:aiprime default: claude-sonnet-5 ``` | Chiave | Motivo | transport: anthropic_messages | Usa il formato Messages di Anthropic. Senza questa impostazione, Hermes ripiega sul formato Chat Completions di OpenAI | key_env | Il nome della variabile in .env che contiene la chiave | catalog_provider: anthropic | I modelli Claude del gateway ereditano i metadati di Anthropic relativi al contesto e alla visione | provider: custom:aiprime | Seleziona il provider con il nome indicato; /model custom:aiprime: consente di cambiarlo all'interno di una chat La procedura guidata fa lo stesso: hermes model, poi **Endpoint personalizzato**, quindi la modalità API **Anthropic Messages**. Se invece scegli Chat Completions, mantieni /v1 nell'URL. ## Perché provider: anthropic con un URL di base non funziona Impostare provider: anthropic e base_url: https://aiprimetech.io sembra corretto ma non ha effetto: nel codice sorgente attuale di Hermes, la sostituzione dell'URL di base del provider Anthropic integrato viene accettata solo per host Anthropic, Claude e Azure, quindi le richieste continuano a essere inviate ad Anthropic. Usa il provider personalizzato con nome indicato sopra. ANTHROPIC_BASE_URL è documentato come un'impostazione che sostituisce l'URL di base di Anthropic, ma un bug di Hermes ancora aperto fa sì che il selettore dei modelli lo ignori. Il provider personalizzato evita entrambi i problemi. ## Cosa determina il consumo di token e quali impostazioni lo limitano Hermes esegue attività oltre alla conversazione che vedi, e tutte vengono addebitate alla stessa chiave, a meno che tu non le instradi altrove. | Origine del consumo | Impostare | Subagents (delegation) | delegation.max_concurrent_children (valore predefinito 10), delegation.max_iterations (valore predefinito 250), delegation.max_spawn_depth (valore predefinito 1); un delegation.model | Revisione in background della memoria e delle competenze dopo ogni turno | auxiliary.background_review.enabled: false, oppure un valore inferiore di max_input_tokens | Attività ausiliarie (compressione, titoli, visione) | auxiliary..provider e .model per inviarle a un modello più economico | Attività pianificate | cron.model per tutte le attività; hermes cron pause o hermes pause | Gateway di messaggistica (Telegram, Discord e altri) | Elenchi di elementi consentiti come TELEGRAM_ALLOWED_USERS; evita GATEWAY_ALLOW_ALL_USERS=true ~/.hermes/config.yaml (aggiunte)Copia ``` delegation: max_concurrent_children: 3 model: claude-haiku-4-5 auxiliary: background_review: enabled: false cron: model: claude-haiku-4-5 ``` hermes prompt-size mostra il costo fisso di ogni chiamata; /usage e /compress sono utili durante una sessione lunga. ## Accesso con Claude Pro o Max al posto di una chiave Hermes può accedere a un account Claude, ma la sua documentazione indica che questa modalità funziona solo con un piano Max e crediti acquistati per l'utilizzo extra, e che gli abbonati Pro non possono usarla. Con una chiave API di un gateway non c'è alcuna finestra di utilizzo legata all'abbonamento; l'utilizzo viene addebitato per token sul tuo saldo. ## Modelli | ID del modello | Usalo per | claude-sonnet-5 | Scelta predefinita per programmazione e attività degli agenti: veloce, potente, di fascia media. | claude-opus-5-5 | Ragionamenti più complessi, refactoring estesi, esecuzioni prolungate degli agenti. | claude-fable-5-1 | Il più capace e il più costoso; riservalo alle attività più difficili. | claude-haiku-4-5 | Economico e rapido: titoli, riepiloghi, classificazione, piccoli passaggi. Hermes richiede una finestra di contesto di almeno 64K token; ogni modello della tabella soddisfa questo requisito. ## Risoluzione dei problemi | Che cosa vedi | Causa | Soluzione | HTTP 400 alla prima esecuzione | Il nome del modello non corrisponde a un ID di modello del gateway | Usa un ID della tabella qui sopra | Le richieste vengono inviate ad Anthropic oppure falliscono con un errore di autenticazione di Anthropic | provider: anthropic con un URL di base di terze parti | Usa il provider personalizzato con nome | Risposte incomprensibili o vuote | Trasporto errato per l'URL | transport: anthropic_messages per Claude | Lunghezza del contesto superata | Sessione più grande della finestra configurata | Imposta model.context_length; /compress | 403 Your request was blocked | Un firewall davanti all'endpoint rifiuta il client | Aggiungi extra_headers con uno User-Agent simile a quello di un browser | Impostazioni mancanti dopo un aggiornamento | Lo schema di configurazione è cambiato | hermes config check, quindi hermes config migrate | Il bot non risponde su Telegram o Discord | Il gateway non è in esecuzione o il mittente non è autorizzato | hermes gateway status; controlla ~/.hermes/logs/gateway.log Stai confrontando i framework per agenti? Consulta la [guida alla configurazione di OpenClaw](/it/learn/run-openclaw-with-claude-api/). ## Domande frequenti Come posso usare Hermes Agent con un endpoint Claude personalizzato? Aggiungi un provider con nome in ~/.hermes/config.yaml con api impostato sull'URL del gateway, key_env che punta a una variabile in ~/.hermes/.env e transport: anthropic_messages, quindi imposta model.provider: custom:. Perché Hermes ignora il mio base_url di Anthropic? Con provider: anthropic, Hermes accetta un URL di base alternativo solo per gli host Anthropic, Claude e Azure, quindi un URL di terze parti viene scartato. Usa invece un provider personalizzato con nome. Come posso ridurre il consumo di token di Hermes Agent? Limita i sottoagenti tramite le impostazioni di delega, instrada le attività ausiliarie e i job cron verso un modello più economico, disattiva la revisione in background e controlla hermes prompt-size. Hermes Agent può usare un abbonamento Claude Pro? Secondo la documentazione di Hermes, no: il metodo di accesso tramite Claude funziona solo con Max e crediti per l'utilizzo extra. Una chiave API evita del tutto i limiti dell'abbonamento. 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/)[Usa Claude con l'SDK OpenAI: endpoint compatibile con OpenAI, streaming, strumenti e limiti](/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 con Claude tramite un gateway: ANTHROPIC_API_BASE, file di configurazione, modalità architect e soluzioni ai problemi](/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 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/)[Codex CLI con un provider personalizzato: config.toml, modelli GPT e Claude, estensione IDE e soluzioni ai problemi](/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/)[GitHub Copilot Chat con Claude tramite un gateway: configurazione di Custom Endpoint, modalità agente e soluzioni ai problemi](/it/learn/use-claude-api-with-github-copilot/)[Collega Zed a Claude tramite il gateway](/it/learn/use-claude-api-with-zed/)[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/)