Guia de configuração

Guia de configuração de provedores

Veja o passo a passo de configuração e solução de problemas por ferramenta.

Guia de configuração de provedores/Configuração do Claude Code

Configuração do Claude Code

O Claude Code é a ferramenta de programação no terminal da Anthropic para desenvolvedores. Ele pode ler o projeto atual, ajudar a explicar código, modificar arquivos, executar comandos de verificação e também trabalhar com o modelo Claude para lidar com tarefas de desenvolvimento mais complexas.

O que é esta ferramenta e para que serve

Modificação de códigoFerramentas de terminalModelo ClaudeAtenção com autorizações

Onde procurar a configuração primeiro

LocalPara quem é indicadoDescrição
~/. claude/settings.jsonQuem deseja salvar a configuração permanentementeGrave as variáveis de ambiente relacionadas ao Claude Code no arquivo de configuração; é mais fácil diagnosticar problemas.
Variáveis de ambiente do terminal atualQuem quer apenas fazer testes temporáriosNormalmente deixa de ter efeito após fechar o terminal.
CC SwitchQuem gerencia vários CLIs ao mesmo tempoPrimeiro configure o provedor na página do CC Switch e depois aplique-o ao Claude Code

Como preencher a Key e a interface

Se estiver usando o Claude oficial, priorize o processo oficial de login ou de Key pela Anthropic / Claude Code. Se estiver usando um provedor de IA, confirme que o provedor oferece a interface do Claude / Anthropic e não insira um endereço compatível com OpenAI padrão no Claude Code.

Exemplo de settings.json para Claude Code
{ "env": { "ANTHROPIC_API_KEY": "YOUR_KEY", "ANTHROPIC_BASE_URL": "https://YOUR_PROVIDER_CLAUDE_API_URL", "ANTHROPIC_MODEL": "PROVIDER_SUPPORTED_CLAUDE_MODEL" } }
ConfiguraçãoDe onde obterErros comuns
ANTHROPIC_API_KEYKey do Claude / Anthropic no painel do provedorNão use o nome da anotação do token como Key
ANTHROPIC_BASE_URLO endereço de interface Claude / Anthropic fornecido pelo provedorNão copie o endereço compatível com OpenAI
ANTHROPIC_MODELO nome do modelo Claude na lista de modelos do provedorCopie exatamente maiúsculas, minúsculas, hifens e números de versão

Como testar após salvar

Teste mínimo do Claude Code
claude "Please reply only: Configuration successful"

Se você ainda estiver usando a configuração antiga, verifique primeiro se há uma Key ou Base URL antiga nas variáveis de ambiente do sistema. A precedência das variáveis de ambiente pode fazer com que as alterações recém-feitas não tenham efeito.

Documentação oficial de configurações do Claude Code Consulte o escopo e o método de configuração do settings.json.
Variáveis de ambiente do Claude Code Veja as instruções sobre variáveis de autenticação, Base URL e modelo.