Configurando Claude Code com CC Switch sem errar a URL base

Um erro comum ao trocar o provedor do Claude Code é copiar uma URL de API completa para um campo que espera apenas a URL base. O resultado pode ser um 404, mesmo com uma chave válida. Abaixo está um procedimento para configurar um endpoint compatível com Anthropic no CC Switch e descobrir se a troca realmente entrou em vigor.

O exemplo usa Crazyrouter. O ponto útil para outros serviços compatíveis é separar credencial, URL base, modelo autorizado e configuração ativa. São quatro verificações diferentes.

1. Verifique o cliente

No PowerShell do Windows:

claude --version

Se o comando não existir, resolva a instalação ou o PATH do Claude Code antes de mexer no provedor. O CC Switch pode ser obtido na página de releases do projeto. Este procedimento foi conferido em Windows 10 22H2 com Claude Code 2.1.283.

2. Adicione o provedor

Na aba Claude do CC Switch, clique no botão de adicionar. A configuração anterior pode permanecer na lista.

Pesquise crazy nos presets e selecione CrazyRouter. Se a sua versão não trouxer esse preset, crie um provedor personalizado com os mesmos campos.

Insira uma API Key criada na sua própria conta. Nunca publique a chave em capturas de tela ou repositórios.

Para o endpoint regional usado neste exemplo, informe apenas:

https://cn.crazyrouter.com

Também existe o host https://api.crazyrouter.com; escolha um deles conforme sua rede. Não acrescente /v1 nem /v1/messages ao campo de URL base do Claude. O cliente monta o caminho da requisição de acordo com o protocolo Anthropic.

Peça a lista de modelos no próprio CC Switch e selecione um modelo permitido para a chave atual. Uma lista publicada em outro momento pode estar desatualizada.

3. Teste a configuração ativa

Salve o provedor, volte à lista e selecione o novo cartão. Feche sessões antigas do Claude Code, abra um novo PowerShell e execute:

claude -p "Reply with OK only." --max-turns 1 --tools ""

Em uma máquina com a versão e a URL acima, uma credencial válida produziu OK. Isso comprova a chamada do CLI naquele ambiente, mas não identifica sozinho qual cartão do CC Switch a originou. Para confirmar o trajeto, compare o horário com o log de requisições da conta e procure variáveis de ambiente antigas caso o registro não apareça.

401 sugere começar pela chave; 403 ou model not allowed, pela permissão do modelo; 404, pela URL e pelo formato de API. Esses códigos não têm uma causa única. Mude um parâmetro de cada vez e repita o mesmo teste curto.

Transparência: Crazyrouter aparece como exemplo de serviço configurado, não como comparação independente de preço ou desempenho. Verifique modelos e custos atuais no painel do serviço. Não compartilhe sua API Key.