Documentazione / API Codex

Codex CLI: configurazione della chiave API e del provider personalizzato

Usa questa guida per collegare il lavoro locale con Codex CLI ad AI Prime Tech. Ti servono un account del gateway, una chiave attiva nel gruppo Codex previsto e un modello disponibile per quella chiave. Inizia dalla panoramica dell'API Codex se stai ancora scegliendo un tipo di accesso.

1. Verifica la chiave e il gruppo

Crea una chiave nella dashboard. L'accesso prepagato a GPT usa il Codex gruppo. Se viene offerto un accesso a tempo a Codex, utilizza il gruppo e le condizioni indicati per quel piano; l'accesso a Claude è separato. Verifica l'elenco dei modelli per la chiave che utilizzerai.

Imposta la chiave nel terminale corrente. Sostituisci il segnaposto in locale; non includere la chiave in un commit nel repository.

PowerShell

$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

bash o zsh

export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

Se un terminale o un editor avviato prima di impostare il suo ambiente non riesce a vedere la variabile, riavvialo. Questi esempi la impostano per il processo corrente e i suoi processi figli.

2. Configura il provider

Integra questa configurazione nel tuo file a livello utente ~/.codex/config.toml. Su Windows, il percorso equivalente è %USERPROFILE%\.codex\config.toml. Le credenziali del provider devono essere nella configurazione utente, non nel file del repository .codex/config.toml.

model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

Usa un ID del provider come aiprimetech e mantieni model_provider coerente con la relativa tabella. La versione attuale di Codex usa il protocollo Responses. L'URL di base è la radice del gateway /v1 ; Codex aggiunge il percorso della richiesta. Questa configurazione usa il trasporto HTTP/SSE.

3. Verifica la connessione

Esegui codex doctor per esaminare la configurazione della CLI. Avvia codex, poi usa /status per confermare il provider e il modello. Chiedi una risposta breve prima di autorizzare un'attività più ampia sul repository. Verifica che la richiesta compaia nella tua pagina di utilizzo di AI Prime Tech.

Puoi esaminare l'elenco dei modelli della chiave indipendentemente da Codex:

Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

Se il catalogo restituito include il tuo modello ma la richiesta non riesce, verifica l'errore effettivo e la disponibilità attuale del gruppo. La sola presenza di un ID nell'elenco non costituisce un test di inferenza riuscito.

Mantieni un profilo CLI facoltativo

Per selezionare questo provider solo per determinate sessioni CLI, inserisci la configurazione precedente in ~/.codex/aiprimetech.config.toml e avvia:

codex --profile aiprimetech

In Codex 0.134.0 e versioni successive, i profili CLI usano file separati. I precedenti esempi di [profiles.aiprimetech] non corrispondono al formato attuale dei profili. L'estensione IDE usa la configurazione a livello utente; verifica il provider attivo dopo averla riavviata, anziché presumere che il cambio di profilo CLI sia stato applicato anche lì.

Scegli un modello

Usa gpt-6.1-sol come punto di partenza per la programmazione, gpt-6-astra per attività impegnative oppure gpt-6-luna per lavori mirati. gpt-6-sol è un ID separato per i flussi di lavoro Sol esistenti. Consulta i dettagli del modello e come confrontarli.

Risoluzione dei problemi

Sintomo Controlla
Variabile d'ambiente mancante Imposta AIPRIMETECH_API_KEY nel processo che avvia Codex.
Errore di autenticazione 401 Verifica che la chiave sia attiva, copiata integralmente ed emessa da questo gateway.
403 o modello non disponibile Verifica il gruppo della chiave, l'accesso previsto dal piano e l'ID esatto del modello.
404 o una risposta HTML Usa https://aiprimetech.io/v1; rimuovi il duplicato /v1 o un elemento aggiunto /responses.
wire_api rifiutato Usa responses; i vecchi chat esempi di provider sono obsoleti.
Errore di saldo, piano o limite di frequenza Leggi l'errore, controlla il tuo account e riduci le attività simultanee prima di riprovare.
La connessione si interrompe durante la risposta Prova una richiesta breve, verifica la connettività di rete e del proxy e acquisisci l'ID della richiesta per l'assistenza.

Claude e funzionalità Codex ospitate

Per usare Claude tramite la traduzione Responses del gateway, segui Claude con Codex usando una chiave compatibile del gruppo Claude. L'esempio GPT qui sopra è per l'accesso del gruppo Codex.

L'accesso al gateway non fornisce i diritti di accesso agli spazi di lavoro ChatGPT né l'accesso a Codex nel cloud. Consulta il confronto delle modalità di accesso per conoscere i limiti del prodotto.

Riferimenti