Solução de problemas do Claude Code
O foco da solução de problemas do Claude Code é confirmar se ele obteve a configuração do Claude / Anthropic. Não misture endereços compatíveis com OpenAI, nomes de modelos Codex ou chaves Gemini no Claude Code.
O que deve ser verificado primeiro?
| Item a verificar | Como verificar | Por quê |
|---|---|---|
| Ferramenta de destino | Certifique-se de que você está solucionando problemas no Claude Code, e não no Codex ou Gemini CLI | Os arquivos de configuração, protocolos e nomes de modelos variam entre ferramentas diferentes. |
| Protocolo do provedor | Claude, Anthropic e Claude Code são mencionados explicitamente no painel ou tutorial | Provedores que oferecem apenas interfaces compatíveis com OpenAI podem não suportar necessariamente o Claude Code |
| Tipo de chave | Use a chave correspondente ao Claude / Anthropic | Se o tipo de chave estiver incorreto, resultará diretamente em erro 401 ou falha de autenticação |
| Estado do terminal | Após alternar a configuração, reabra o terminal e teste novamente | O terminal antigo ainda pode estar usando as variáveis de ambiente ou configurações de antes da alteração |
Erros comuns
| Sintoma | Verificação prioritária | Soluções |
|---|---|---|
| O comando abre, mas a requisição falha | Se o Claude Code obteve a nova configuração | Feche a janela atual do terminal e reabra-a, depois envie a pergunta de teste mais curta possível. Após alternar via CC-Switch, não modifique manualmente a mesma configuração ao mesmo tempo. |
| 401 / Unauthorized | Tipo e integridade da chave | Confirme que você está usando a chave correspondente ao Claude / Anthropic; não insira uma chave compatível com OpenAI no Claude Code; verifique se há espaços extras no início ou no fim ao copiar novamente. |
| 404 / model not found | Nome do modelo Claude | Preencha exatamente como listado no painel do provedor para modelos Claude, sem alterar maiúsculas/minúsculas, hifens ou números de versão. |
| Tempo limite de conexão ou sem resposta | Claude Base URL | Verifique o endereço da API Claude / Anthropic no painel; provedores que oferecem apenas endereços compatíveis com OpenAI podem não suportar o Claude Code. |
| Ainda usando o provedor antigo após alternar | Sessão do terminal e origem da configuração | Reabra o terminal e teste novamente; se ainda não surtir efeito, confirme se o provedor atual no CC-Switch foi aplicado ao Claude Code. |
Teste mínimo
Ao testar, primeiro envie uma pergunta curta fixa, confirme se há resposta e só então prossiga para o projeto real.
Teste mínimo do Claude Code
claude "Please reply only: Claude Code configuration test successful"Modelo de feedback
Ao enviar feedback ao provedor, escreva assim
Tool: Claude Code 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