Tutorial da Série Claude Code 6: Como Autenticar - Login pelo Navegador e Configuração Manual da Chave de API

Fluxo de Autenticação: Login pelo Navegador e Configuração Manual da Chave de API

Após instalar o Claude Code, você precisa autenticar para usá-lo. Você precisa vincular a ferramenta à sua conta Anthropic. Existem duas formas de vincular: Login pelo Navegador e Configuração Manual da Chave de API. Ambas têm o mesmo resultado final; escolha a que for mais conveniente.

Método 1: Login pelo Navegador (Recomendado)

O Claude Code fornece um comando de autenticação automática claude login, que abre o navegador para você autorizar na página web e, em seguida, escreve automaticamente as credenciais de volta no terminal.

Passos:

No terminal, digite:

bash claude login

O sistema exibirá uma série de instruções e abrirá automaticamente a página de autorização da Anthropic no seu navegador padrão.
Se não abrir automaticamente, o terminal imprimirá um link; você pode copiá-lo manualmente e abri-lo no navegador.
Faça login na sua conta Anthropic no navegador (se já estiver logado, esta página solicitará autorização diretamente).
Clique em "Permitir" ou "Autorizar". A página do navegador exibirá "Autorização bem-sucedida, você pode fechar esta página".
Volte ao terminal; você verá uma mensagem de autenticação concluída. Agora, ao executar o comando claude, ele já estará vinculado à sua conta.

Método 2: Configuração Manual da Chave de API

Se você estiver usando um servidor sem interface gráfica, um contêiner ou não quiser passar pela autorização do navegador, pode obter a chave de API diretamente do Console da Anthropic e configurá-la no Claude Code.

Passos:

Abra o navegador, acesse https://console.anthropic.com e faça login na sua conta Anthropic.
Vá para a página de Chaves de API (geralmente em Configurações ou opções do desenvolvedor) e clique em "Criar Chave de API".
Dê um nome à chave (por exemplo, claude-code-local). Após gerá-la, copie imediatamente.
Observação: esta chave é exibida apenas uma vez; se você fechar a página, não poderá vê-la novamente. Se esquecer de salvar, exclua a antiga e gere uma nova.
Volte ao terminal; há duas maneiras de fornecer a chave ao Claude Code:

A. Variável de ambiente:

bash export ANTHROPIC_API_KEY=sua-chave-api

Adicione esta linha ao seu ~/.bashrc ou ~/.zshrc para que seja aplicada automaticamente sempre que você iniciar o terminal.

B. Escrever em arquivo de configuração:

O Claude Code também lê seu próprio arquivo de configuração. Edite manualmente ~/.claude/config.json (crie se não existir) e escreva:

json { "apiKey": "sua-chave-api" }

Observação: recomenda-se definir a permissão deste arquivo como 600 (chmod 600 ~/.claude/config.json) para evitar que outros usuários o leiam.

Teste a conexão:

bash claude "Olá, por favor responda com 'OK'"

Se você receber uma resposta normal, a chave está configurada corretamente.

Erros comuns na configuração manual:

A chave não deve começar com sk-ant- ou sk-? Não, a chave de API da Anthropic realmente começa com sk-ant-api03- e é uma string longa. Certifique-se de não perder nenhum caractere ao copiar.
Se você definir tanto a variável de ambiente quanto o arquivo, a variável de ambiente terá prioridade mais alta. Mantenha apenas uma para evitar confusão.
A chave é uma credencial de cobrança; não a envie para repositórios Git. Recomenda-se usar .gitignore para ignorar todo o diretório ~/.claude ou o arquivo de configuração.

Trocar de conta ou sair

Para trocar de conta ou limpar as credenciais locais:

Se você usou claude login: execute claude logout e depois claude login novamente.
Se configurou a chave manualmente: exclua a variável de ambiente ou a chave antiga no arquivo de configuração e substitua pela nova chave.

Testar se a autenticação está normal

claude "Explique para que serve o diretório atual"

Se ele conseguir ler a visão geral do seu projeto, significa que o ambiente está pronto.