Solução de problemas do Codex
O ponto principal na solução de problemas do Codex é a interface compatível com OpenAI. Em geral, faça a verificação nesta ordem: Base URL, Key, nome do modelo e se o Provider atual está ativo.
O que deve ser confirmado primeiro?
| Itens a verificar | Como verificar | Por quê |
|---|---|---|
| O provedor suporta interfaces compatíveis com OpenAI | O painel mostra endereço de API, Base URL, compatibilidade com OpenAI e outras instruções | O Codex precisa conseguir enviar requisições para a interface compatível |
| Base URL | Copie o link de API fornecido pelo provedor | Se precisa de /v1 siga o exemplo do painel, não tente adivinhar |
| Status da Key | A Key não está desativada, não expirou e o saldo da conta está normal | Erros 401 geralmente começam pela verificação da Key |
| Nome do modelo | Copie conforme a lista de modelos do painel | Erros no nome do modelo, maiúsculas/minúsculas, hífens ou versão causarão falhas |
Erros comuns
| Sintoma | Verificação prioritária | Solução |
|---|---|---|
| 401 / Unauthorized | API Key | Gere novamente ou copie a Key, e confirme que ela não está desativada, não expirou e que o saldo da conta está normal. |
| 404 / model not found | Nome do modelo | Não digite nomes de modelos de cabeça; copie conforme a lista de modelos no painel do provedor. Se houver suporte à obtenção da lista de modelos, obtenha a lista primeiro; se falhar, adicione manualmente. |
| Erros relacionados à Base URL | O link da API está completo? | A Base URL é o link de API fornecido pelo provedor. Se requer /v1, siga o exemplo do painel, não tente adivinhar. |
| A requisição não passa, mas a Key está normal | O protocolo é compatível? | Confirme se o provedor atual oferece uma interface compatível com OpenAI, e não Claude, Gemini ou uma interface que suporte apenas chat web. |
| Não surte efeito após usar o CC-Switch | Seleção da ferramenta de destino | Certifique-se de que o Provider foi aplicado ao Codex, e não ao Claude Code; reinicie o terminal ou cliente antes de testar novamente. |
Teste mínimo
Faça um teste com a pergunta mais curta possível para confirmar que a requisição passa antes de usá-lo no projeto real.
Teste mínimo do Codex
codex "Please reply only: Codex configuration test successful"Modelo de feedback
Ao pedir suporte ao provedor, envie desta forma
Tool: Codex System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened