Guida rapida per gli utenti di Claude Code

Autenticazione

Ogni richiesta al nostro proxy richiede una chiave API valida. Ricevi questa chiave immediatamente dopo esserti registrato nella pagina Ottieni chiave API. Includila nell'intestazione Authorization come token Bearer. Se la chiave manca o non è valida, l'API restituisce un errore 401. Puoi rigenerare la tua chiave in qualsiasi momento dal tuo dashboard, il che revoca istantaneamente quella precedente. Questo garantisce che chiavi perse o compromesse non consentano ulteriore accesso ai tuoi crediti prepagati.

Endpoint Chat Completions

Invia i tuoi prompt di programmazione all'endpoint standard di completamento chat. L'URL di base per tutte le richieste è https://api.claudecodeapikey.com/v1. Usa l'ID del modello uncensored per accedere al nostro modello linguistico di grandi dimensioni. Questo modello è ottimizzato per rispondere senza rifiuti di contenuti per uso adulto lecito, rendendolo ideale per generare codice senza blocchi inutili. L'endpoint supporta sia risposte standard che in streaming. Di seguito è riportato un esempio di una richiesta di base usando curl.

Copycurl https://api.claudecodeapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Il corpo della richiesta deve essere inferiore a 8 MB. Se superi questo limite, il server rifiuterà il payload. Il modello gestisce una finestra di contesto di 100.000 token, combinando sia i token di input che quelli di output. Questo consente frammenti di codice sostanziosi e lunghe cronologie di conversazione senza una troncatura immediata.

SDK Python

Per gli sviluppatori che usano Python, puoi integrare la nostra API utilizzando l'SDK ufficiale di OpenAI. Basta puntare il client al nostro URL di base e fornire la tua chiave API. L'ID del modello uncensored funziona esattamente come gli altri modelli compatibili con OpenAI nell'SDK. Puoi chiamare il metodo di completamento e gestire la risposta come un oggetto di testo standard. Questo approccio è ideale per l'elaborazione in batch o per l'integrazione in script di automazione più grandi.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudecodeapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Ricorda che l'SDK gestisce per te la serializzazione JSON. Devi solo assicurarti che la tua variabile base_url punti al nostro proxy. L'oggetto di risposta contiene il testo generato, che puoi poi scrivere nei tuoi file o reintrodurre nel contesto della conversazione.

SDK Node.js

Gli sviluppatori Node.js possono utilizzare il pacchetto npm di OpenAI per interagire con il nostro proxy. Configura il client con l'URL di base personalizzato e la tua chiave API. Il pattern di utilizzo riflette l'implementazione Python: crea un client, chiama l'endpoint delle chat completions e elabora il risultato. Questo è utile per la generazione di codice lato server o per assistenti di coding in tempo reale.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.claudecodeapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

L'SDK Node gestisce le connessioni HTTP in modo efficiente. Assicurati di utilizzare una versione dell'SDK che supporta gli URL di base personalizzati. La struttura della risposta rimane coerente con lo standard OpenAI, rendendo facile il passaggio tra diversi fornitori compatibili con OpenAI se necessario.

Risposte in streaming

Per l'assistenza al coding in tempo reale, abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce uno stream di Server-Sent Events (SSE). Ogni chunk contiene una risposta parziale, consentendoti di visualizzare il codice mentre viene generato. Questo migliora significativamente l'esperienza utente negli agenti di coding interattivi.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Gestisci gli eventi dello stream nel tuo codice per accumulare la risposta finale. Lo streaming non consuma più token di una richiesta non in streaming; cambia solo il modo in cui i dati vengono consegnati. Questo è particolarmente utile per blocchi di codice lunghi dove vuoi mostrare il progresso immediatamente.

Limiti di velocità e quote

La nostra API impone un limite di 300 richieste al minuto per chiave API. Se superi questo limite, riceverai un errore 429. Dovresti implementare una logica di retry con backoff esponenziale nelle tue applicazioni. Inoltre, ogni account è limitato a una sola chiave API, che può essere rigenerata se necessario. L'errore 402 indica che il tuo credito prepagato è stato esaurito. Puoi ricaricare da $10 usando cripto (USDT o USDC). I crediti non scadono mai, quindi puoi mettere in pausa e riprendere l'utilizzo al tuo ritmo senza perdere il saldo.