Codex VS Code Chiave API: Usa un Endpoint Personalizzato

Cosa stai configurando

Gli assistenti di programmazione in VS Code comunicano con un modello tramite HTTP. La maggior parte utilizza il formato API OpenAI, il che significa che accettano un URL base e una chiave personalizzati invece del valore predefinito del fornitore. Questo servizio è compatibile con OpenAI, quindi si integra in qualsiasi strumento che offra questa opzione.

Sii chiaro su cosa si trovi dall'altra parte. È un modello a pesi aperti gestito da un provider indipendente, ottimizzato per rispondere senza rifiuti di contenuto per l'uso adulto legale. Non è il modello Codex di OpenAI né l'API ufficiale di alcun altro fornitore. È solo testo, con una finestra di 100.000 token, chiamata di funzioni e modalità JSON. Se vuoi i dettagli delle rotte in stile OpenAI, leggi la documentazione; se ti serve solo l'indirizzo, consulta la pagina sull'URL base API Codex.

Ecco i tre valori da usare ovunque:

Ottieni una chiave e testala prima

Crea un account nella pagina delle chiavi API con Google o con email e password. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic, valido per 7 giorni, senza carta. Poi testa la chiave in un terminale prima di toccare VS Code. Una chiamata curl funzionante prova la chiave e l'URL, quindi gli errori successivi riguardano l'estensione.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

La risposta è un JSON di completamento chat e la risposta include un'intestazione X-Balance-USD con il tuo credito residuo. Tieni la chiave in una variabile d'ambiente o nell'archivio segreto dell'estensione, mai in un repository.

Estensione e CLI Codex: file di configurazione

Gli strumenti Codex di OpenAI supportano provider di modelli personalizzati tramite un file di configurazione TOML nella tua home directory, e l'estensione VS Code condivide tale configurazione con la CLI. Verifica questo aspetto con la documentazione Codex attuale per la tua versione, poiché il formato è cambiato.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Punti da controllare:

• base_url termina con /v1, senza /chat/completions.
• env_key è il nome della variabile d'ambiente, non la chiave stessa.
• wire_api seleziona il formato della richiesta. Questo servizio accetta sia POST /v1/chat/completions che POST /v1/responses. Prova prima "chat"; usa "responses" se la tua versione di Codex lo richiede.
• Avvia VS Code da una shell con la variabile impostata, o riavvialo dopo aver aggiunto la variabile al tuo profilo. Un'avvio GUI su macOS spesso non vede le variabili d'ambiente esportate.

Gli strumenti di tipo agent si affidano alla chiamata di funzioni. È supportato qui, incluse le chiamate di funzioni in streaming, ma la qualità varia a seconda del modello, quindi esegui prima un compito piccolo. La pagina correlata su l'uso dell'API in Cursor copre una configurazione simile in un altro editor.

Continue, Cline e altre estensioni

Le estensioni di terze parti hanno ciascuna la loro schermata, ma il modello è costante: scegli un provider "OpenAI" o "Compatibile con OpenAI", poi compila URL base, chiave e modello. Continue utilizza una configurazione YAML:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline e Roo Code offrono un provider "Compatibile con OpenAI" nel pannello delle impostazioni con gli stessi tre campi. Nomi e menu cambiano spesso, quindi cerca nella documentazione dell'estensione "Compatibile con OpenAI" o "URL base personalizzato". Se un'estensione non ha un campo per l'URL base, non può usare questo endpoint.

Suggerimenti che fanno risparmiare tempo:

• Disabilita l'autocompletazione della scheda contro il modello ospitato a meno che tu non voglia una richiesta per ogni pausa. Le azioni di chat e modifica sono più economiche.
• Imposta un contesto più piccolo nell'estensione per le modifiche quotidiane. Inviare intere repository al modello costa token di input ogni volta.
• Usa una chiave separata per ogni strumento in modo da poter dire quale usa il tuo credito.

Quali attività dell'editor si adattano a questo modello

Un modello di testo generale con una finestra ampia è adatto per diverse attività quotidiane: spiegare codice sconosciuto, scrivere test unitari per una funzione, convertire uno script tra linguaggi, redigere docstring e regex, e riscrivere un modulo quando incolli l'intero file. La finestra da 100.000 token significa che alcuni file di medie dimensioni più le tue istruzioni entrano in una singola richiesta e il completamento può utilizzare qualsiasi cosa rimanga.

Sii realistico sul resto. Non è un modello di codifica specializzato con addestramento consapevole dell'editor, quindi le esecuzioni di agent multi-file di grandi dimensioni potrebbero richiedere più guida e verifica rispetto a uno strumento creato per esse. Chiedi le differenze invece che i file interi, rivedi ogni modifica prima di accettarla ed esegui i tuoi test. Se un compito richiede contenuti che un assistente filtrato rifiuta, come la struttura per narrativa per adulti o testo di ricerca di sicurezza per uso lecito, un endpoint senza rifiuti sui contenuti è il motivo per usare questo.

Quanto costa in un editor

I prezzi sono $0,15 per 1M di token in input e $0,50 per 1M di token in output. Gli strumenti di codifica inviano molto contesto, quindi guarda prima l'input.

Esempio: una richiesta di modifica con 8.000 token di contesto file e una risposta di 600 token costa 8.000 x $0,15 / 1M + 600 x $0,50 / 1M = $0,0012 + $0,0003 = $0,0015. Un giorno di 150 tali richieste costa 150 x $0,0015 = $0,225. Venti giorni lavorativi: $4,50.

Un agent che legge molti file può inviare 40.000 token per passaggio. A quella dimensione un passaggio costa $0,006 più l'output, quindi 100 passaggi costano circa $0,60 più l'output. Tieni d'occhio i cicli degli agent. Le richieste fallite o rifiutate non vengono addebitate e il credito non scade mai. Le ricariche da $20 a $500 possono essere pagate con carta (Visa, Mastercard, Apple Pay, Google Pay) o cripto. I piani attuali sono elencati nella pagina dei prezzi.

Risoluzione dei Problemi

401 Non autorizzato

La chiave manca, ha uno spazio estraneo o la variabile d'ambiente non è visibile a VS Code. Riavvia l'editor da un terminale con la variabile.

404 o "modello non trovato"

Usa il modello esatto uncensored e l'URL base con /v1 alla fine.

Errori 429

Una chiave completa permette 8 richieste parallele e 300 al minuto; la chiave di prova permette 2 e 60. Un'estensione che avvia diverse richieste parallele, come l'autocompletamento più la chat, può raggiungere il limite di concorrenza. Il codice di errore è concurrency per troppi contemporaneamente e rate_limited per i limiti al minuto. Un'intestazione Retry-After: 5 significa sovraccarico temporaneo.

Blocco dello streaming

Alcuni proxy aziendali mettono in buffer gli eventi inviati dal server. Testa da una rete diversa o disattiva lo streaming nell'estensione.

Le risposte differiscono da quelle che hai visto con un altro assistente

È previsto. Questo è un modello diverso con i suoi punti di forza. Dai istruzioni chiare e specifiche e testalo sul codice del tuo progetto.

Altre guide

• API Codex in Python: Interagire con un LLM per la programmazione
• URL di base dell'API Codex: come puntare il tuo client sul nostro