Como Gerar Seu Claude Setup Token — Guia Completo para Mac e Windows

O que e um setup token? E uma "chave digital" que permite usar sua assinatura do Claude (Pro ou Max) em ferramentas externas como GitHub Actions, editores de codigo e servidores. Sem ele, essas ferramentas nao conseguem se conectar a sua conta.

O que voce precisa antes de comecar

Para seguir este tutorial, voce vai precisar de:

Uma assinatura ativa do Claude Pro ($20/mes) ou Claude Max ($100 ou $200/mes) em

claude.ai - acesse para verificar sua assinatura

Conexao com a internet e cerca de 10 minutos.

Tutorial para Mac

Passo 1 — Abra o Terminal

O Terminal e um aplicativo que ja vem instalado no seu Mac. Ele parece uma tela preta onde voce digita comandos.

Como encontrar:

1. Pressione as teclas Command + Barra de Espaco ao mesmo tempo — isso abre a busca do Spotlight.

2. Digite Terminal e pressione Enter.

3. Uma janela escura (ou clara) vai aparecer com um cursor piscando. Pronto, esse e o Terminal!

Dica: Nao se preocupe com a aparencia. Tudo que vamos fazer e copiar e colar comandos.

Passo 2 — Instale o Homebrew (gerenciador de pacotes)

O Homebrew e como uma "loja de aplicativos" que funciona pelo Terminal. Ele facilita instalar tudo que precisamos.

Copie e cole o comando abaixo no Terminal e pressione Enter:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

O que vai acontecer:

O Terminal vai pedir a senha do seu Mac (a mesma que voce usa para desbloquear). Ao digitar, os caracteres NAO aparecem na tela — isso e normal, e por seguranca. Digite normalmente e pressione Enter. A instalacao pode levar de 2 a 5 minutos.

Importante para Macs com chip Apple Silicon (M1, M2, M3, M4):

Apos a instalacao, o Homebrew pode pedir que voce execute dois comandos extras. Eles vao aparecer no final da instalacao com o texto "Next steps". Copie e cole cada um no Terminal. Normalmente sao algo como:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Se voce ja tem o Homebrew instalado, pode pular este passo.

Passo 3 — Instale o Node.js

O Node.js e um programa necessario para rodar o Claude Code. Copie e cole no Terminal:

brew install node

Espere terminar (1-2 minutos).

Para confirmar que funcionou, digite:

node --version

Se aparecer algo como v22.x.x, deu certo!

Passo 4 — Gere o seu token

Agora vem a parte principal. Copie e cole no Terminal:

npx @anthropic-ai/claude-code setup-token

O que vai acontecer:

1. O Terminal pode perguntar se deseja instalar o pacote — digite y e pressione Enter.

2. Seu navegador (Safari, Chrome, etc.) vai abrir automaticamente em uma pagina de login da Anthropic.

3. Faca login com a mesma conta da sua assinatura Claude Pro ou Max.

4. Clique em Autorizar / Allow.

5. Volte para o Terminal — seu token vai aparecer la.

Passo 5 — Copie e guarde o token

O token e um texto longo que comeca com sk-ant-oat01-...

1. Selecione o token inteiro no Terminal (clique e arraste, ou use Command + A para selecionar tudo e depois copie com Command + C).

2. Cole em um lugar seguro:

- Um gerenciador de senhas (1Password, Bitwarden, etc.)

- O aplicativo Notas do Mac (temporariamente)

- Ou diretamente onde voce precisa usar (ex: GitHub Secrets)

IMPORTANTE: Trate esse token como uma senha. Qualquer pessoa com ele pode usar sua assinatura do Claude e gastar seus creditos.

Tutorial para Windows

Passo 1 — Abra o PowerShell

O PowerShell e o "Terminal" do Windows. Ele ja vem instalado.

Como encontrar:

1. Clique no botao Iniciar (icone do Windows, canto inferior esquerdo).

2. Digite PowerShell na barra de busca.

3. Clique em Windows PowerShell (o icone azul).

4. Uma janela azul escura vai aparecer com um cursor piscando. Pronto!

Dica: NAO use o "Prompt de Comando" (cmd). Use o PowerShell.

Passo 2 — Instale o Node.js

Diferente do Mac, no Windows o mais facil e baixar o instalador diretamente.

1. Abra seu navegador e va para: nodejs.org

2. Clique no botao verde grande que diz "LTS" (versao recomendada). Um arquivo .msi vai ser baixado.

3. Abra o arquivo baixado e siga o instalador:

- Clique Next em todas as telas.

- Aceite os termos.

- Mantenha as opcoes padrao.

- Clique Install.

- Se pedir permissao de administrador, clique em Sim.

4. Clique Finish ao terminar.

Importante: Depois de instalar, feche o PowerShell e abra novamente (repita o Passo 1). Isso e necessario para que ele reconheca o Node.js.

Para confirmar que funcionou, digite no PowerShell:

node --version

Se aparecer algo como v22.x.x, deu certo!

Passo 3 — Gere o seu token

Copie e cole no PowerShell:

npx @anthropic-ai/claude-code setup-token

O que vai acontecer:

1. O PowerShell pode perguntar se deseja instalar o pacote — digite y e pressione Enter.

2. Seu navegador vai abrir automaticamente em uma pagina de login da Anthropic.

3. Faca login com a mesma conta da sua assinatura Claude Pro ou Max.

4. Clique em Autorizar / Allow.

5. Volte para o PowerShell — seu token vai aparecer la.

Passo 4 — Copie e guarde o token

O token e um texto longo que comeca com sk-ant-oat01-...

1. Selecione o token inteiro no PowerShell: clique com o botao esquerdo no inicio do token, segure e arraste ate o final.

2. Para copiar, pressione Ctrl + C (ou clique com o botao direito apos selecionar).

3. Cole em um lugar seguro (gerenciador de senhas, bloco de notas, ou direto onde precisa).

IMPORTANTE: Trate esse token como uma senha. Qualquer pessoa com ele pode usar sua assinatura do Claude.

Usando o token

Depois de copiar, veja os usos mais comuns:

No GitHub Actions

Va ate o repositorio no GitHub, acesse Settings > Secrets and variables > Actions e clique em New repository secret:

Name: CLAUDE_CODE_OAUTH_TOKEN

Secret: Cole o token aqui

Como variavel de ambiente (Mac/Linux)

export CLAUDE_CODE_OAUTH_TOKEN="seu-token-aqui"

Como variavel de ambiente (Windows PowerShell)

$env:CLAUDE_CODE_OAUTH_TOKEN = "seu-token-aqui"

Problemas comuns e solucoes

command not found: node — Feche e abra o Terminal/PowerShell novamente. Se persistir, reinstale o Node.js.

O navegador nao abre — Copie a URL que aparece no Terminal e cole manualmente no navegador.

Token expirou — Gere um novo rodando npx @anthropic-ai/claude-code setup-token novamente.

Erro de autenticacao — Verifique se sua assinatura Pro ou Max esta ativa em

claude.ai/settings

npm ERR! ou npx ERR! — Tente rodar como administrador. No Mac, adicione sudo antes do comando. No Windows, abra o PowerShell como Administrador (clique direito > Executar como administrador).

Resumo rapido

Mac:

1. Abrir terminal: Command + Espaco > Terminal

2. Instalar Node.js: brew install node

3. Gerar token: npx @anthropic-ai/claude-code setup-token

Windows:

1. Abrir terminal: Iniciar > PowerShell

2. Instalar Node.js: Baixar de

nodejs.org

3. Gerar token: npx @anthropic-ai/claude-code setup-token

Resultado: Token comeca com sk-ant-oat01-...