Errore 401 di Codex CLI: correggere il percorso di autenticazione giusto

Un 401 di Codex CLI significa che l'autenticazione è stata rifiutata dal server che gestisce la richiesta. Il controllo più rapidamente utile combina host di destinazione, provider selezionato e origine della credenziale. Una variabile d'ambiente vuota è una possibilità; non spiega ogni 401. Segui il ramo corrispondente alla tua configurazione.

Innanzitutto identifica quale connessione ha avuto esito negativo

Quando disponibili, salva stato, testo dell'errore, timestamp e ID della richiesta. Rimuovi intestazioni di autorizzazione, chiavi e token prima di condividere i dettagli. Non incollare auth.json in un ticket di supporto: potrebbe contenere credenziali. Un errore di una singola integrazione non dimostra che la connessione al modello sia interrotta.

1. Controlla la CLI e il metodo di accesso

codex --version
codex login status

# POSIX shell: report presence only, without printing the secret
if [ -n "${KUNAVO_API_KEY:-}" ]; then
  printf 'KUNAVO_API_KEY is set\n'
else
  printf 'KUNAVO_API_KEY is missing or empty\n'
fi

Esegui i controlli nello stesso terminale che avvia Codex. Sostituisci il nome della variabile nel controllo della presenza se il tuo provider ne usa una env_key diversa. “Impostata” conferma solo che esiste un valore; non dimostra che il valore sia aggiornato o accettato dalla destinazione.

Per un accesso personale a ChatGPT che ha smesso di aggiornarsi, usa codex logout seguito da codex login, quindi completa il flusso nel browser per l'account previsto. Questo modifica lo stato di accesso memorizzato; non è un passaggio obbligatorio per ogni errore di un provider personalizzato. Nell'automazione gestita, segui invece il metodo di autenticazione dell'amministratore. Consulta la guida ufficiale all'autenticazione.

2. Associa una chiave API al suo emittente e alla destinazione

Una chiave della OpenAI Platform appartiene al percorso dell'API OpenAI. Una chiave Kunavo appartiene al percorso di Kunavo. Un accesso riuscito a ChatGPT nel browser non convalida una chiave del gateway, e il saldo di un gateway non è un saldo della OpenAI Platform. Controlla l'host effettivo nell'errore prima di sostituire qualsiasi cosa.

Nella dashboard dell'emittente, conferma che la chiave esista ancora e sia attiva. Controlla il progetto associato e le eventuali restrizioni di accesso. Il riferimento agli errori dell'API OpenAI include credenziali non valide, appartenenza all'organizzazione e problemi con la allowlist IP tra gli errori di autenticazione. Usa il messaggio associato per scegliere la correzione; creare ripetutamente nuove chiavi non risolve un account o una policy di rete.

3. Controlla la configurazione del provider utilizzata da Codex

# Compare these non-secret fields with your intended provider.
model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"
wire_api = "responses"

Il model_provider selezionato deve corrispondere al blocco del provider. Il campo env_key indica la variabile; non contiene il segreto. Verifica la configurazione attiva e qualsiasi override del profilo o della riga di comando, quindi riavvia Codex dopo averla corretta. Evita di copiare un blocco di provider non correlato sopra la configurazione funzionante.

Il riferimento alla configurazione di OpenAI documenta il protocollo Responses. Un base URL che termina con /v1 è diverso da un URL completo per una richiesta /v1/responses. Un percorso errato richiede in genere una diagnosi dell'endpoint anche dopo che l'autenticazione ha esito positivo. Controlla anche requires_openai_auth: quando è abilitato, l'autenticazione OpenAI ha precedenza su env_key, come descritto nella guida all'autenticazione.

4. Modifica una sola cosa e riprova con un'attività semplice

1. Conserva i dettagli dell'errore e identifica il percorso selezionato.
2. Correggi l'accesso, la credenziale o il campo del provider indicato dalle evidenze.
3. Riavvia il processo della CLI o dell'editor interessato affinché riceva la nuova impostazione.
4. Esegui una piccola richiesta prima di riavviare un'attività di coding lunga.
5. Se il problema persiste, invia al provider un errore redatto e l'ID della richiesta, non la credenziale.

Un successivo errore 429, un avviso sul saldo o un errore di modello mancante costituiscono un nuovo ramo diagnostico. Mantieni la correzione dell'autenticazione e affronta il problema successivo invece di annullare ogni impostazione. La guida ai limiti di Codex distingue questi casi. Per una configurazione Kunavo, usa l'integrazione completa Codex e gestisci le chiavi nella tua dashboard.

Domande frequenti

Documentazione ufficiale e guida della CLI locale verificate il 17 settembre 2026. Non è necessario condividere alcuna credenziale per seguire questi controlli.