IT ▾

HomeGuida

Proxy Claude Code: usa un'API LLM compatibile con OpenAI

Un proxy Claude Code è un piccolo server che si posiziona tra la CLI e l'API del modello e traduce le richieste. Ne hai bisogno perché Claude Code parla il formato Anthropic e questa API parla il formato OpenAI.

Una scatola traduttrice tra un terminale e un server, che mostra un proxy che converte le richieste tra due formati API

Punti chiave

  1. Claude Code invia richieste in stile Anthropic; questa API accetta richieste in stile OpenAI
  2. Un proxy di traduzione come LiteLLM si posiziona nel mezzo e mappa i nomi dei modelli
  3. Il modello sottostante è un modello a pesi aperti, non Claude, quindi provalo sui tuoi task
  4. Una sessione di codifica con 30 richieste di 20.000 token in input e 800 in output ciascuna costa circa $0,10

Cosa fa il proxy

Un proxy Claude Code è qualsiasi server che esegui tra la CLI di codifica di Anthropic e il modello che risponde. Claude Code legge una variabile d'ambiente per l'indirizzo API e invia le sue richieste lì. Se quell'indirizzo è un proxy, il proxy decide cosa succede realmente: può registrare il traffico, aggiungere regole o inoltrare la chiamata a un modello diverso.

Il dettaglio chiave è il formato di trasmissione. Claude Code utilizza il formato Messages di Anthropic. L'API su https://api.claudecodeproxyapi.com/v1 utilizza il formato Chat Completions di OpenAI, con model ID uncensored. I due sono simili nello spirito ma non intercambiabili, quindi non puoi incollare il nostro URL direttamente in Claude Code. Uno strato di traduzione deve riscrivere ogni richiesta e ogni risposta, inclusi i chunk in streaming e le chiamate di strumenti.

Cosa si trova dove

ParteParlaCompito
Claude Code CLIFormato Anthropic MessagesPianifica le modifiche, chiama gli strumenti, mostra le diff
Proxy di traduzione (locale)Entrambi i formatiConverte richieste e flussi, mappa i nomi dei modelli
Questa APIOpenAI Chat CompletionsEsegue il modello a pesi aperti, fattura per token

I progetti della community gestiscono la parte centrale. Il proxy di LiteLLM e claude-code-router sono due esempi documentati pubblicamente per questo scopo. Entrambi sono software di terze parti, quindi controlla la loro documentazione attuale per le versioni e i flag supportati prima di farci affidamento. Se qualcosa fallisce lungo il percorso, la guida alla risoluzione dei problemi del proxy è il punto di partenza, e questo sito ha anche un articolo separato con una configurazione passo-passo.

Prima di configurarlo: sii onesto sul modello

Claude Code è stato costruito intorno ai modelli stessi di Anthropic. Sostituire con un modello diverso cambia il comportamento e nessun proxy può nasconderlo. Il modello qui è un modello a pesi aperti gestito da un provider indipendente e ottimizzato per rispondere senza rifiuti di contenuti per l'uso adulto lecito. Non è Claude e non è un'API ufficiale di Anthropic o di qualsiasi altro vendor.

Ciò che ti offre per il lavoro in stile agent:

  • Chiamata di funzioni con tools, tool_choice e tool_calls in streaming, con i risultati restituiti come messaggi role: "tool".
  • Finestra di contesto da 100.000 token, prompt e completamento insieme.
  • Modalità JSON con response_format, e streaming su SSE.

Quello che devi verificare tu stesso: quanto bene segue un lungo ciclo di agenti, con quale frequenza genera chiamate di funzioni non valide e come gestisce la tua lingua e il tuo framework. Esegui tre o quattro attività reali del tuo repository prima di spostare un intero workflow. Il credito di prova da $0,50, richiesto con un clic dopo l'accesso, è sufficiente per questo.

Testa prima l'upstream

Prima di toccare Claude Code, conferma che il lato API funzioni con una richiesta semplice, inclusa una chiamata di strumento, poiché gli agent dipendono da essa:

curl https://api.claudecodeproxyapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the files in the src folder."}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "list_files",
        "description": "List files in a directory",
        "parameters": {
          "type": "object",
          "properties": {"path": {"type": "string"}},
          "required": ["path"]
        }
      }
    }],
    "tool_choice": "auto"
  }'

Una buona risposta contiene una voce tool_calls con list_files e una stringa di argomento JSON. Se lo vedi, l'upstream è pronto ed eventuali problemi successivi riguardano la configurazione del proxy o della CLI.

Due percorsi e quando scegliere l'uno o l'altro

Percorso 1: un proxy di traduzione per Claude Code

Scegli questo se ti piace l'interfaccia di Claude Code, i suoi prompt di autorizzazione e il suo workflow, e vuoi un modello diverso dietro di essa. Esegui il proxy in locale, punta il CLI verso di esso e mappa i nomi dei modelli inviati dal CLI a uncensored. Le variabili esatte sono trattate nella documentazione e nell'articolo di configurazione.

Percorso 2: un client che parla già OpenAI

Diversi assistenti di codifica open source ed estensioni per editor, tra cui Aider, Continue e Cline, possono utilizzare qualsiasi endpoint compatibile con OpenAI direttamente. Inserisci l'URL base, la chiave e il nome del modello e non c'è uno strato di traduzione da mantenere. Se non hai specificamente bisogno dell'interfaccia di Claude Code, questo è il percorso più breve e ha meno parti che possono rompersi.

Una regola pratica: scegli il percorso 2 per una rapida prova del modello sul codice, e il percorso 1 quando il tuo team si affida già al workflow di Claude Code.

Costo di una sessione di codifica

Gli agent reinviano molto contesto, quindi i token di input dominano il conto. Prendi una sessione di 30 richieste, ciascuna con 20.000 token di input (file, cronologia, output degli strumenti) e 800 token di output:

  • Input: 30 x 20.000 = 600.000 token, che è 0,6 x $0,15 = $0,09
  • Output: 30 x 800 = 24.000 token, che è 0,024 x $0,50 = $0,012
  • Totale: $0,102

I prezzi sono $0,15 per 1M di token di input e $0,50 per 1M di token di output. La fatturazione avviene dal credito prepagato senza abbonamento, le richieste fallite o rifiutate non vengono addebitate e il credito non scade mai. Le ricariche vanno da $20 a $500 con bonus del +5% da $50, +10% da $100 e +15% da $200. Questo sito accetta ricariche tramite cripto (USDT su TRC20, USDC su Base). La pagina dei prezzi ha la tabella completa, e la pagina delle chiavi è dove ti registri con Google o email.

Limiti che influenzano i cicli di agent

Una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto. La chiave di prova permette 2 concorrenti e 60 al minuto. Gli agent che distribuiscono sotto-attività possono raggiungere prima il limite di concorrenza. L'API risponde quindi con HTTP 429 e il codice concurrency, mentre il limite di tasso di richieste restituisce rate_limited. Un sovraccarico temporaneo restituisce anche 429, con Retry-After: 5. Un buon proxy ritenta su 429 dopo il ritardo, e una richiesta in streaming mantiene il suo slot fino alla fine dello stream, quindi gli stream bloccati contano contro di te.

Il corpo della richiesta può essere fino a 8 MB. Tienilo a mente se il tuo strumento incolla file grandi nei prompt, e mantieni l'intero prompt sotto la finestra di 100.000 token.

Note sulla sicurezza per un proxy locale

Un proxy conserva la tua chiave upstream, quindi trattala come qualsiasi altra credenziale. Associala a localhost, non a tutte le interfacce di rete, a meno che tu non abbia davvero bisogno che altre macchine vi accedano. Memorizza la chiave in una variabile d'ambiente o in un gestore di segreti piuttosto che in un file che finisce nel controllo di versione. Se condividi un proxy con un team, assegnagli la propria chiave master così da poterla ruotare senza toccare la chiave upstream.

Ricorda anche cosa invia un agent. Una CLI di codifica inoltra i contenuti dei file, l'output dei comandi e i tuoi prompt al modello. I prompt non vengono utilizzati per l'addestramento qui, ma dovresti comunque tenere le chiavi private e i file .env fuori dalla directory di lavoro che l'agent può leggere.

Un modo equo per valutare il modello sul tuo codice

Scegli tre attività di difficoltà crescente da un repository reale: una correzione su un solo file, una modifica che tocca tre file e una piccola refactorizzazione con test. Esegui ciascuna due volte con lo stesso prompt, una volta con il tuo modello attuale e una volta con uncensored, e tieni note su quattro aspetti: le modifiche sono state applicate correttamente, le chiamate di funzioni sono state analizzate correttamente, quanti tentativi sono stati necessari e quanto è costata ogni esecuzione. Un'ora di questo ti dice più di qualsiasi classifica.

Se il modello a pesi aperti non è all'altezza nel compito più difficile, potresti comunque trovarlo adatto per compiti più semplici e meno costosi come la stesura di test, la scrittura di messaggi di commit o la spiegazione di codice non familiare. Poiché la fatturazione è a consumo da credito prepagato senza abbonamento, non ci sono penalità nell'utilizzarlo solo per quei lavori.

Domande e risposte

Claude Code può usare questa API senza un proxy?

No. Claude Code invia richieste in formato Anthropic e questa API accetta richieste in formato OpenAI, quindi è necessario uno strato di traduzione tra di esse.

Il modello si comporterà come Claude?

No. È un modello a pesi aperti di un provider indipendente. Provalo sui tuoi compiti prima di affidarti ad esso.

L'API supporta la chiamata di funzioni?

Sì. Supporta strumenti, tool_choice e tool_calls in streaming, e puoi restituire i risultati come messaggi con role tool.

Esiste un'opzione più semplice di un proxy?

Sì. Gli assistenti di codifica che accettano un endpoint compatibile con OpenAI, come Aider, Continue o Cline, possono connettersi direttamente all'URL di base.

Quanto costa provarlo?

I nuovi utenti possono richiedere $0,50 di credito di prova con un clic dopo l'accesso. È valido per 7 giorni e non richiede carta.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.