HomeGuida
API Claude Code per Cursor: configurazione endpoint personalizzato
Cerchi una configurazione dell'API Claude Code per Cursor che non dipenda da un singolo fornitore? Cursor può comunicare con qualsiasi endpoint compatibile con OpenAI e questa guida mostra ogni impostazione necessaria.
Aggiornato

Cosa stai configurando
Cursor è un editor con funzionalità AI integrate. Tra le sue impostazioni dei modelli c'è un campo che ti permette di sostituire il base URL OpenAI con il tuo, insieme a uno spazio per inserire la tua chiave. Questo rende possibile inviare richieste chat a qualsiasi servizio che segua il formato chat-completions di OpenAI. Questo servizio lo fa, quindi Cursor può usarlo come modello per la chat e le modifiche inline.
I valori da inserire sono fissi. Base URL: https://api.claudecodeapikey.com/v1. Nome modello: uncensored. Chiave: quella del tuo account, inviata come token Bearer. Non serve configurare altro lato server.
Sii chiaro su cosa sia questo. Il modello dietro l'endpoint è un modello a pesi aperti di un provider indipendente. Non è un modello Claude e non è l'API ufficiale di Anthropic o di altri. Se sei qui aspettando Claude stesso dentro Cursor, è una cosa diversa e le sezioni finali spiegano come valutare se è abbastanza buono per il tuo lavoro.
Prima di aprire Cursor
Prepara tutto prima, così non ti fermi a metà.
- Crea un account con Google o con email e password.
- Apri la pagina della chiave API e crea una chiave. La guida alle chiavi mostra dove si trova ogni pulsante.
- Richiedi il credito di prova da $0,50 se vuoi testare senza pagare. Richiede un solo clic, non serve la carta e dura 7 giorni.
- Esegui un controllo rapido da un terminale per confermare che la chiave funzioni prima di dare la colpa all'editor.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
Una risposta JSON con un messaggio indica che la chiave e l'URL sono corretti. Un HTTP 401 indica che la chiave è errata o contiene uno spazio di troppo. Correggi qui, perché i messaggi di errore di Cursor sono meno specifici di quelli di curl.
Configurazione passo dopo passo in Cursor
I nomi dei menu variano tra le versioni di Cursor, quindi tratta le etichette seguenti come una guida e cerca la corrispondenza più vicina.
- Apri le impostazioni di Cursor e vai alla sezione dei modelli.
- Trova il campo per una chiave API OpenAI e incolla la tua chiave di questo servizio.
- Attiva l'opzione per sovrascrivere il base URL OpenAI e inserisci
https://api.claudecodeapikey.com/v1. Includi la parte/v1alla fine e non aggiungere percorsi finali come/chat/completions. - Usa l'opzione per aggiungere un modello personalizzato e digita
uncensoredesattamente, tutto in minuscolo. - Premi il pulsante di verifica o salvataggio accanto al campo della chiave. Cursor invia una piccola richiesta di test.
- Apri un pannello chat, seleziona
uncensoreddal menu a discesa dei modelli e invia un prompt breve.
Se il passaggio di verifica fallisce ma il controllo curl è passato, controlla di aver digitato l'URL nel campo base URL e non nel campo chiave, e che la versione di Cursor non abbia resettato la sovrascrittura dopo un aggiornamento. La guida rapida mantiene i passaggi attuali per questo editor.
Un dettaglio da sapere: una singola sovrascrittura si applica allo slot del provider OpenAI. Se usi anche veri modelli OpenAI attraverso quello slot, ora verranno instradati anche lì verso questo endpoint. Molte persone mantengono un profilo Cursor separato o disattivano la sovrascrittura quando vogliono tornare indietro.
Testa con un prompt di programmazione reale
Un saluto dimostra poco. Usa un prompt che metta alla prova contesto e istruzioni. Seleziona una funzione nel tuo progetto, apri la chat e chiedi qualcosa di concreto, come aggiungere una validazione degli input e un test unitario. Osserva tre cose.
- Streaming. La risposta dovrebbe apparire token per token. L'endpoint fa streaming via SSE, quindi un'attesa lunga seguita da un blocco di testo suggerisce che un proxy o un'impostazione lo sta bufferizzando.
- Utilizzo del contesto. Allega due o tre file e fai una domanda che li richieda tutti. La finestra di contesto è di 100.000 token, che contiene molto codice sorgente, ma è il tuo editor a decidere quanto effettivamente invia.
- Seguire le istruzioni. Chiedi una risposta solo con diff o un formato di output rigoroso e vedi se il modello ci si attiene. I modelli a pesi aperti variano su questo punto, e vuoi impararlo fin dal primo giorno.
Tieni un elenco breve di cinque compiti reali dal tuo repository e rieseguili ogni volta che cambi un'impostazione come la temperatura. Giudicare dal tuo codice batte qualsiasi affermazione generale, inclusa la nostra.
Risoluzione degli errori comuni
401 o chiave non valida
La chiave è sbagliata, scaduta negli appunti o ha spazi attorno. Incollala di nuovo. Assicurati che lo schema di autorizzazione sia Bearer, che Cursor fa per te quando usi il campo chiave OpenAI.
404 o modello non trovato
Quasi sempre un problema dell'URL di base. Un /v1 mancante o un /chat/completions extra interrompe il percorso. Il nome del modello deve anche essere uncensored, senza maiuscole o spazi.
429 con rate_limited o concurrency
Hai raggiunto un limite. La chiave di prova permette 2 richieste parallele e 60 al minuto, e una chiave completa permette 8 parallele e 300 al minuto. Un editor può inviare diverse richieste contemporaneamente, ad esempio chat più modifiche in background, e gli streaming mantengono il loro slot fino alla fine. Il codice errore ti dice quale limite: rate_limited è richieste al minuto, concurrency è troppe contemporaneamente. Un sovraccarico temporaneo restituisce anche 429 con Retry-After: 5, quindi aspettare cinque secondi e riprovare è corretto.
La risposta si interrompe
La finestra è di 100.000 token, prompt più completamento. Un allegato molto grande lascia poco spazio per la risposta. Invia meno file o inizia una nuova chat.
Funzionalità che non fanno nulla
L'API è solo testo e non offre embedding. Se una funzionalità di Cursor richiede un modello di embedding o input immagine, non funzionerà attraverso questo endpoint.
Impostazioni da ottimizzare una volta funzionante
Dopo la prima chat riuscita, alcune regolazioni rendono l'uso quotidiano più fluido.
Abbassa la temperatura per le attività di modifica. Se il tuo editor lo consente, un valore intorno a 0,2 garantisce un codice più stabile. Per il brainstorming, aumentala. Poi, tieni d'occhio la quantità di contesto che allegi. La finestra è generosa, ma ogni file allegato viene fatturato come input, quindi chiudere le schede non correlate ed escludere le cartelle di build riduce i costi e rende le risposte più mirate.
Se usi le modalità agent o multi-step, ricorda il supporto per la chiamata di funzioni: l'endpoint accetta tools e tool_choice e effettua lo streaming di tool_calls. Se una determinata funzionalità di Cursor li utilizza dipende dalla versione, quindi esegui un piccolo task agent e leggi cosa succede prima di fidarti per una modifica di grandi dimensioni. Infine, dai un'occhiata all'header X-Balance-USD in un test da terminale ogni tanto, così un saldo basso non ti sorprenderà a lavoro in corso.
Utilizzo della stessa chiave negli script
Un vantaggio di un endpoint compatibile con OpenAI è che la chiave che hai impostato in Cursor funziona anche nel codice. Ecco un esempio in Node.js, utile per script di build o strumenti per i messaggi di commit.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
Memorizza la chiave in una variabile d'ambiente, non in un file che committi. Ogni risposta include un'intestazione X-Balance-USD, così uno script può avvisarti quando il credito è basso.
Costi e quando conviene restare
L'uso nell'editor è intensivo per l'input perché ogni richiesta trasporta il contesto del file. A $0,15 per 1M di token di input e $0,50 per 1M di output, una richiesta con 15.000 token di input e 1.000 token di output costa 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Cento di queste sono $0,275. La pagina dei prezzi ha importi di ricarica a partire da $20, con bonus a partire da $50.
Mantieni la tua configurazione esistente se dipendi dal modello di un fornitore specifico per refactoring complessi, o se il tuo flusso di lavoro si basa su funzionalità che un semplice endpoint di chat non può offrire. Usa questo quando vuoi un prezzo per token basso, un'API semplice e meno rifiuti di contenuti per lavoro lecito. Molti sviluppatori mantengono entrambe le configurazioni e passano da una all'altra in base al compito.
Altre guide
Domande e risposte
Quale base URL devo inserire in Cursor?
Inserisci https://api.claudecodeapikey.com/v1 includendo la parte /v1. Non aggiungere /chat/completions alla fine.
Quale nome del modello devo aggiungere?
Aggiungi un modello personalizzato chiamato uncensored, in minuscolo. È l'unico ID modello servito dall'API.
Questo mi dà accesso ai modelli Claude in Cursor?
No. L'endpoint serve un unico modello a pesi aperti da un fornitore indipendente. Non è un'API ufficiale di Anthropic o di qualsiasi altro fornitore.
Perché ricevo errori 429 nell'editor?
Hai superato il limite per minuto o hai troppe richieste parallele. Una chiave di prova consente 2 richieste parallele e 60 al minuto, una chiave completa 8 e 300.
Posso provarlo senza pagare?
Sì. I nuovi utenti possono richiedere $0,50 di credito di prova nella pagina della chiave API. Non serve una carta ed è valido per 7 giorni.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.