Home → Assistenza

Claude Code e Codex hanno bisogno di base URL diverse sullo stesso gateway

Cosa vedi

• 404 on /v1/v1/messages
• Claude Code works but Codex returns 404, or the reverse
• Unexpected token '<' — HTML where JSON was expected
• The key is valid and the model exists, yet nothing connects
• No trace of the failed request in the provider's usage log

Perché succede

Due famiglie di SDK, due convenzioni, un solo nome host del gateway. Nessuno dei due client sbaglia; semplicemente non sono d'accordo su chi sia il proprietario del segmento /v1. Invertirli produce /v1/v1/… oppure un percorso senza versione.

Il 404 che ne risulta è particolarmente difficile da diagnosticare perché spesso non raggiunge mai l'API. Un gateway che serve il proprio sito sullo stesso dominio risponde ai percorsi sconosciuti con la pagina commerciale: HTTP 200, Content-Type: text/html. Il client prova allora a interpretare l'HTML come JSON e segnala un errore di sintassi che non indica nemmeno lontanamente la vera causa.

Significa anche che l'errore non lascia tracce dal lato del provider. L'assistenza dirà di non vedere richieste dalla tua chiave, e dirà la verità: alla richiesta ha risposto un server web prima ancora che diventasse una chiamata API.

Verifica se la causa è questa

Chiedi il tipo di contenuto invece di leggere il corpo: un comando basta a chiarire:

curl -s -o /dev/null -w '%{http_code} %{content_type}\n' \
  -X POST 'YOUR_BASE_URL/chat/completions' \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model":"YOUR_MODEL","messages":[{"role":"user","content":"hi"}]}'

application/json significa che l'URL è corretto: anche una chiave sbagliata risponde in JSON. text/html significa che stai parlando con un sito web e che il problema è la base URL.

Come risolvere

1. Decidi in base alla famiglia di SDK, non al nome del prodottoTutto ciò che è costruito sull'SDK di Anthropic vuole solo l'host; tutto ciò che è compatibile con OpenAI vuole /v1. I nuovi strumenti rientrano in una delle due categorie senza bisogno di istruzioni proprie.
2. Togli la barra finaleAlcuni client uniscono i percorsi in modo ingenuo, e una base URL che termina con / può produrre una doppia barra che porta al sito invece che all'API.
3. Controlla il tipo di contenuto prima della chiaveUna risposta in HTML significa che la richiesta non ha mai raggiunto l'API. Cambiare chiave a quel punto non cambia nulla e ti costa un pomeriggio.
4. Usa prima gli esempi del provider così come sonoFai funzionare una configurazione nota, poi cambia una cosa alla volta. La maggior parte degli errori di configurazione sono due errori insieme.

Articoli correlati

Ultima verifica: 2026-10-01. Scritto a partire da problemi diagnosticati su un gateway compatibile con OpenAI in produzione, non raccolto da altri siti.