Como configurar a API key no Claude Code (terminal e VS Code)

O que você vai precisar

Este tutorial segue o método oficial da Anthropic, conferido na documentação em 26 de outubro de 2026: a variável de ambiente ANTHROPIC_API_KEY. Se ainda não sabe o que o Claude Code faz, comece pelo guia Claude Code: o que é e como funciona.

• Windows 10 1809+, macOS 13+ ou Linux, com 4 GB de RAM e internet.
• Uma API key da Claude: gerada no Claude Console, com créditos pré-pagos, ou avulsa, como as da página do Claude Code da Pulse.
• Um projeto para testar (qualquer pasta com código serve).
• Opcional: VS Code 1.94 ou mais recente, para usar a extensão; no Windows, o Git for Windows, recomendado pela Anthropic.

Dica: se a sua key veio com instruções próprias (as dos planos de 30 dias da Pulse chegam com um app para macOS ou Windows e um tutorial em vídeo), siga essas instruções. Os passos abaixo são o caminho manual, válido para qualquer key da API.

Passo 1: instalar o Claude Code

Segundo a página de instalação (abre em nova aba), o jeito recomendado é o instalador nativo, que não depende de Node.js e se atualiza sozinho.

1. Abra o terminal. No Windows, procure por "PowerShell" no menu Iniciar; no macOS, o Terminal.
2. Rode o comando do seu sistema.

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

# macOS, Linux ou WSL
curl -fsSL https://claude.ai/install.sh | bash

3. Confira a instalação. Abra um terminal novo e rode claude --version. Se disser que claude não foi encontrado, a pasta de instalação ainda não está no PATH; a página de solução de problemas (abre em nova aba) da Anthropic explica como corrigir.

Também existem winget install Anthropic.ClaudeCode (Windows), brew install --cask claude-code (macOS) e o npm (npm install -g @anthropic-ai/claude-code, que exige Node.js 22+).

Passo 2: definir a variável ANTHROPIC_API_KEY

A documentação de autenticação (abre em nova aba) diz que, quando ANTHROPIC_API_KEY está definida e você aprova a key, o Claude Code pula o login no navegador. Troque sua-key pela chave que você recebeu.

Windows (PowerShell), só para a janela atual:

$env:ANTHROPIC_API_KEY = "sua-key"

Windows, de forma permanente: rode setx ANTHROPIC_API_KEY "sua-key" e abra um terminal novo, ou cadastre a variável em Variáveis de Ambiente do Windows, na seção do usuário.

macOS ou Linux, só para a janela atual:

export ANTHROPIC_API_KEY=sua-key

macOS ou Linux, de forma permanente: adicione a mesma linha export ao fim do arquivo ~/.zshrc (macOS) ou ~/.bashrc (Linux) e abra um terminal novo.

Dica: trate a key como senha. Não cole em prints, em repositórios nem em grupos. Se vazar, gere outra.

Passo 3: abrir o Claude Code e aprovar a key

1. Entre na pasta do projeto. cd caminho/do/projeto.
2. Inicie o agente. Rode claude.
3. Aprove a key. Na primeira vez, o Claude Code pergunta se deve usar a ANTHROPIC_API_KEY que encontrou. Responda que sim. A escolha fica salva; para mudar depois, use Use custom API key em /config.
4. Confira. Digite /status. A tela mostra o método de autenticação ativo. Se há login do claude.ai e key ao mesmo tempo, a key aprovada tem prioridade.

Se o Claude Code abriu o navegador pedindo login em vez de perguntar sobre a key, a variável não chegou ao terminal: volte ao Passo 2 e abra uma janela nova.

Passo 4: usar a key no VS Code

A extensão oficial usa a mesma autenticação da CLI. Segundo a página do VS Code (abre em nova aba), ANTHROPIC_API_KEY vale para a extensão também.

1. Instale a extensão. Pressione Ctrl+Shift+X (Windows/Linux) ou Cmd+Shift+X (Mac), procure por "Claude Code" e clique em Install. Funciona também no Cursor.
2. Abra o VS Code pelo terminal. Com a variável definida, rode code . na pasta do projeto. Se a tela de login aparecer mesmo com a key no shell, o VS Code não herdou as variáveis do terminal; abrir com code . resolve.
3. Abra o painel. Ctrl+Shift+P (ou Cmd+Shift+P), digite "Claude Code" e escolha Open in New Tab.

Passo 5: o primeiro prompt

Teste com um exemplo do guia oficial (abre em nova aba). Comece por leitura, que é barata e mostra se o agente enxerga o projeto:

"O que este projeto faz? Explique a estrutura de pastas."

Depois peça uma mudança pequena. O Claude Code mostra o diff e pede confirmação antes de salvar; aprove com Yes. Para sair, /exit; para ver os comandos, /help.

Deu erro? Problemas comuns

• Pede login no navegador em vez de usar a key → a variável não está no terminal em uso. Defina de novo, abra uma janela nova e rode claude. No VS Code, abra o editor com code ..
• "Invalid API key" ou erro 401 → key colada com espaço ou caractere faltando, ou revogada. Confira com echo $env:ANTHROPIC_API_KEY (PowerShell) ou echo $ANTHROPIC_API_KEY (macOS/Linux) e redefina. Se a key veio da Pulse, chame o suporte.
• Erro 400 "This organization has been disabled" → segundo a Anthropic, costuma ser uma ANTHROPIC_API_KEY antiga sobrepondo a assinatura. Remova a variável (Remove-Item Env:ANTHROPIC_API_KEY no PowerShell, unset ANTHROPIC_API_KEY no macOS/Linux) e confira o /status.
• Erro 429 ou aviso de limite → limite de taxa ou saldo de tokens esgotado. Em key por tokens, o acesso termina quando a cota acaba.
• Nada ajuda → rode claude doctor no terminal (ou /doctor dentro do Claude Code). Erros de rede e proxy estão na página de solução de problemas (abre em nova aba).

Como funciona na Pulse Coding

A Pulse vende a key do Claude Code por tokens (a key chega pelo WhatsApp e por e-mail, pelo botão da tela do pedido, e fica em "Meus pedidos") e em planos 5x e 20x de 30 dias (key gerada na hora, na tela do pedido, com o app e o tutorial). Pagamento único no Pix, sem assinatura. O vídeo Como ativar a API do Claude Code (abre em nova aba) mostra o processo; as condições estão na página do Claude Code e a garantia segue a Política de Reembolso.

Conclusão

Configurar a API key no Claude Code se resume a três coisas: instalar, definir ANTHROPIC_API_KEY e aprovar a key na primeira abertura. O /status confirma o que está em uso, e o VS Code herda tudo quando é aberto pelo terminal. Para entender o que o agente faz e quanto consome, leia o guia Claude Code: o que é e como funciona. Se você também usa o agente da OpenAI, a ativação dele está em como ativar a key do Codex no Windows.

Claude e Claude Code são marcas de seus respectivos donos. A Pulse Coding é uma loja independente, sem vínculo com a Anthropic.