ai2saveai2save

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

  1. Abra https://ai2save.com/keys.
  2. Clique em "Criar chave", preencha o nome e selecione o grupo que contém o modelo Claude.
  3. 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:

  1. Digite uma pergunta curta, como "Olá, apresente-se".
  2. Se o conteúdo for retornado normalmente, isso indica que o endereço, a chave e o grupo do modelo estão conectados.
  3. 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_TOKEN ou ANTHROPIC_API_KEY que 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/v1 causará erro; Claude Code deve ser preenchido como https://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.json e 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.