Erros Comuns e Verificação de Conexão
401 / invalid_api_key
Confirme se a solicitação foi enviada para Base URL e se a Authorization usa Bearer sk-.... Verifique se a Key está completa, se não foi revogada e se o grupo ao qual pertence está correto.
404 / model not found
Verifique, em ordem, o ID do modelo, o endereço do protocolo e o grupo da Key. OpenAI Compatible geralmente usa o endereço com /v1; Claude Code geralmente usa o endereço raiz sem /v1.
403 ou bloqueio por controle de risco
Defina um User-Agent claro no script para reduzir a probabilidade de o User-Agent vazio ser bloqueado pelo gateway. Não tente contornar a restrição repetindo tentativas continuamente.
Solicitação muito lenta
Comece testando com perguntas curtas. Se perguntas curtas forem rápidas, mas tarefas complexas forem lentas, geralmente é devido ao contexto ou à inferência do modelo; se perguntas curtas também forem lentas, verifique a rede local, a linha e o status do serviço.
Conexão bem-sucedida, mas o cliente não muda
Feche completamente o cliente e abra novamente. Verifique se existem múltiplos arquivos de configuração, variáveis de ambiente antigas que sobrescrevem as novas configurações ou se CC Switch não ativou realmente o fornecedor alvo.
Lista de Verificação Antes do Lançamento
- Verifique Key, Base URL e modelo com a solicitação mínima.
- Configure tempo limite, tentativas, simultaneidade e limite de orçamento.
- Prepare linhas de backup ou modelos de reserva.
- Faça logs desensibilizados, sem registrar a Key completa.