Claude Code Tutorial de Configuração
Claude Code usa o protocolo Anthropic Messages. Ao conectar ao ai2save, preencha o endereço com o endereço raiz do site https://ai2save.com, não adicione manualmente /v1; a chave deve ser a sk-... criada no console do ai2save.
1. Preparar API Key
- Abra https://ai2save.com/keys.
- Clique em "Criar chave", preencha o nome e selecione o grupo que contém o modelo Claude.
- Após a criação, copie imediatamente a Key completa. A Key completa é exibida apenas uma vez.
2. Instalar Claude Code
Primeiro, conclua a instalação do ambiente Node.js, depois execute:
npm install -g @anthropic-ai/claude-code
claude --version
Se a versão for inferior à exigida pelo gateway, atualize conforme indicado:
npm update -g @anthropic-ai/claude-code
3. Habilitação temporária do terminal atual
macOS / Linux / WSL:
export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-sua-chave-api"
claude
Windows PowerShell:
$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-sua-chave-api"
claude
ANTHROPIC_AUTH_TOKEN é uma variável dedicada à chave de retransmissão. Não defina ANTHROPIC_API_KEY como outra Key oficial ao mesmo tempo, para evitar que Claude Code leia credenciais incorretas.
4. Escrevendo o arquivo de configuração Claude Code (recomendado)
Edite ~/.claude/settings.json (no Windows normalmente em %USERPROFILE%\.claude\settings.json):
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://ai2save.com",
"ANTHROPIC_AUTH_TOKEN": "sk-sua-chave-api"
}
}
Depois de salvar, reabra o terminal e inicie o claude. Se você quiser que funcione apenas em um projeto, escreva o mesmo conteúdo no .claude/settings.local.json dentro do projeto, não envie a Key real para o Git.
5. Escolha o modelo e verifique
claude --model claude-sonnet-4-6
Após entrar na interface interativa:
- Digite uma pergunta curta, como "Olá, apresente-se".
- Se o conteúdo for retornado normalmente, isso indica que o endereço, a chave e o grupo do modelo estão conectados.
- Quando for necessário trocar de modelo, use
/model; o ID do modelo deve ser consistente com o ID aberto no console.
Você também pode usar Claude Code para diagnóstico interno e verificar o status da configuração:
/status
/doctor
6. Multiconfigurações e Limpeza de Configurações Antigas
Se você já fez login anteriormente no Claude oficial ou em outros pontos de transferência:
- Priorize o uso de CC Switch para gerenciar múltiplos fornecedores, evitando erros manuais de configuração.
- Ao configurar manualmente, verifique se não há antigos
ANTHROPIC_BASE_URL,ANTHROPIC_AUTH_TOKENouANTHROPIC_API_KEYque sobrescrevam os valores atuais. - WSL e Windows são dois ambientes separados; após configurar no terminal Windows, ainda é necessário configurar separadamente dentro do WSL.
Limpeza temporária no macOS / Linux:
unset ANTHROPIC_API_KEY
Erros Comuns
- 401 / invalid_api_key: A chave não foi copiada completamente, foi revogada ou o grupo não contém o modelo atual.
- 404 / model not found: O ID do modelo está incorreto ou o grupo da chave não tem acesso a este modelo.
- Falha na conexão: Base URL escrito como
https://ai2save.com/v1causará erro; Claude Code deve ser preenchido comohttps://ai2save.com. - Ainda fazendo requisições ao endereço oficial: Verifique se há endereços antigos restantes em
~/.claude/settings.json, no projeto.claude/settings.local.jsone nas variáveis de ambiente do terminal. - No Windows, ao abrir não surte efeito: Feche completamente o terminal, VS Code ou Claude Desktop e abra novamente.