Skip to main content
Claude Code è lo strumento CLI di Anthropic per il coding agentico. Questa guida ti mostra come eseguirlo tramite Venice per l’accesso anonimizzato e pay-per-token ai modelli Claude.

Paga per token

Nessun abbonamento. Paghi solo per ciò che usi

Modelli Claude

Accedi ai modelli Opus, Sonnet e Fable attuali tramite Venice

Prompt caching

Il caching di Venice funziona insieme a Claude Code

​
Perché serve un router

Claude Code si connette direttamente all’API di Anthropic per impostazione predefinita. Per usarlo con Venice, hai bisogno di claude-code-router, un proxy locale open source che:

Intercetta

Cattura le richieste in uscita di Claude Code prima che raggiungano Anthropic

Trasforma

Converte le richieste Anthropic Messages nel formato chat OpenAI-compatibile di Venice

Reindirizza

Inoltra le richieste a api.venice.ai/api/v1/chat/completions

​
Prerequisiti

Account Venice

Con crediti Venice

Node.js

v22 o superiore

Claude Code

Installato via npm

​
Configurazione

1

Installa o aggiorna Claude Code

Installa l’ultima versione della CLI Claude Code:
2

Installa Claude Code Router

3

Ottieni la tua API key

Genera una chiave da venice.ai/settings/api. La aggiungerai a CCR nel prossimo passaggio.
4

Aggiungi Venice come provider

Avvia l’interfaccia di gestione di CCR:
Nella pagina Providers, scegli Add provider e poi Other / custom API endpoint. Inserisci:
  • Nome: Venice
  • Endpoint API: https://api.venice.ai/api/v1
  • API key: la tua API key Venice
CCR dovrebbe rilevare automaticamente OpenAI Chat. In caso contrario, apri Advanced settings, disattiva il rilevamento automatico del protocollo e seleziona OpenAI Chat.Usa Search models o Custom models per aggiungere i modelli Claude che desideri, quindi esegui Check Connection e salva il provider. La verifica della connessione invia una richiesta reale con un limite di output di un token.
5

Crea un profilo Claude Code

In Agent Config, scegli Add profile e poi Claude Code:
  • Assegna al profilo il nome Claude Code - Venice.
  • Mantieni Effect scope impostato su Only opened from CCR durante i test.
  • Scegli CLI only o CLI & APP.
  • Imposta Model su un modello Venice come Venice/claude-opus-4-8.
  • Per mantenere ogni livello di Claude Code su Venice, imposta anche i campi opzionali dei modelli Fable, Opus, Sonnet e Haiku su modelli Venice.
Salva il profilo.
6

Avvia e verifica

Avvia il profilo per nome:
In Claude Code:
  1. Esegui /context e conferma che la finestra di contesto corrisponda al modello selezionato. Per claude-opus-4-8, dovrebbe mostrare 1M.
  2. Esegui /model se vuoi passare a un altro modello Venice; le varianti 1M sono contrassegnate con 1M context.
  3. Invia un messaggio di prova, poi controlla i Request logs in CCR per confermare che sia stato usato Venice.

​
Modelli supportati

Il catalogo cambia nel tempo. Usa Search models in CCR o GET /models?type=text per l’elenco e i limiti aggiornati.
Claude Code è ottimizzato per i modelli Claude. Sebbene altri modelli disponibili tramite Venice (GPT, DeepSeek, Grok, ecc.) possano funzionare, non possiamo garantire un’esperienza equivalente poiché Claude Code si basa su funzionalità specifiche di Claude come l’extended thinking. Per altri modelli, considera l’uso dell’API standard di Venice.

​
Aggiornare un’installazione esistente

Aggiorna CCR prima di risolvere i problemi di un’installazione esistente:
Le versioni attuali di CCR memorizzano la configurazione attiva in ~/.claude-code-router/config.sqlite. Un vecchio config.json viene importato quando il database non esiste. Dopo la migrazione, apporta le modifiche tramite ccr ui invece di continuare a modificare config.json. Se un processo in background è ancora in esecuzione dopo un aggiornamento, riavvialo:

​
Prompt caching

Il prompt caching di Venice funziona con i marker di cache nativi di Claude Code. Nessun transformer di cache aggiuntivo è necessario per la configurazione normale.

​
Risoluzione dei problemi

  1. Aggiorna CCR con npm install -g @musistudio/claude-code-router@latest.
  2. Avvia una nuova sessione di Claude Code dal profilo CCR.
  3. Esegui /model e seleziona la voce Venice contrassegnata con 1M context.
  4. Esegui /context e conferma che la finestra sia 1M, non 200K.
Le versioni più vecchie di CCR potrebbero non esporre a Claude Code la finestra di contesto o l’utilizzo dei token corretti.
Conferma Node.js 22 o più recente e aggiorna CCR:
Usa ccr serve per l’esecuzione in primo piano ed esporre l’errore di avvio originale. Uno stack Cannot read properties of undefined (reading 'error') proveniente da server.logger.error indica un’installazione di CCR obsoleta; aggiornala prima di indagare oltre.
Avvia il gateway e verificane lo stato di salute:
Un controllo di salute fallito significa che il gateway locale di CCR non è disponibile; la richiesta non ha raggiunto Venice.
Apri ccr ui ed effettua lì la modifica. Le versioni attuali di CCR memorizzano la configurazione in config.sqlite; config.json è solo una fonte di migrazione per le installazioni più vecchie.

​
Risorse

Documentazione API Venice

Riferimento completo dell’API

claude-code-router

Codice sorgente e issue

Release di CCR

Versioni attuali e note di rilascio