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
| Parte | Parla | Compito |
|---|---|---|
| Claude Code CLI | Formato Anthropic Messages | Pianifica le modifiche, chiama gli strumenti, mostra le diff |
| Proxy di traduzione (locale) | Entrambi i formati | Converte richieste e flussi, mappa i nomi dei modelli |
| Questa API | OpenAI Chat Completions | Esegue 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_choiceetool_callsin streaming, con i risultati restituiti come messaggirole: "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.
