Módulo 2.2 — Autenticação e Primeiro Uso

🚀 Rodando claude pela primeira vez

Digite claude no terminal. Na primeira execução, o Claude Code não abre o REPL diretamente — ele detecta que não há credenciais e inicia o fluxo de onboarding.

Detecta ausência de credenciais

Claude Code verifica ~/.claude/

Welcome to Claude Code!
To get started, you'll need to authenticate...

Mostra opções de autenticação

Escolha entre conta Anthropic (OAuth) ou API key

1. Login with Anthropic account (browser)
2. Enter API key manually
>

Browser abre (opção 1)

Autentica via OAuth, token salvo localmente

Opening browser for authentication...
✓ Authentication successful
✓ Session saved to ~/.claude/

REPL interativo abre

Pronto para receber seu primeiro prompt

Claude Code (claude-sonnet-4-5)
Working directory: /home/user/meu-projeto
>

🔐 Fluxo de login detalhado

O Claude Code usa OAuth2 via browser como método principal. As credenciais ficam em ~/.claude/ e são válidas até expirar (geralmente semanas).

Comandos de autenticação

# Autenticar pela primeira vez (abre browser)
claude

# Verificar status de autenticação
claude --status

# Forçar reautenticação
claude --logout
claude

# Ver onde as credenciais estão salvas
ls ~/.claude/

# Autenticar em ambiente sem browser (API key)
export ANTHROPIC_API_KEY="sk-ant-..."
claude

💡 Token expira? Não se preocupe

Quando o token OAuth expira, o Claude Code avisa na próxima sessão e reabre o browser automaticamente. O fluxo é idêntico ao primeiro login. Suas configurações e histórico não são afetados.

💳 API key vs assinatura

Duas formas de pagar pelo uso. A escolha certa depende do seu volume de uso — uso esporádico favorece API key, uso diário intenso favorece assinatura Claude Max.

🔑 API Key (pay-per-use)

•Paga por token consumido (input + output)
•Ideal para uso esporádico ou scripts automatizados
•Controle granular de custo
•Limites de rate por minuto/dia
•Variável: ANTHROPIC_API_KEY

📋 Claude Max (assinatura)

•Mensalidade fixa com cota generosa
•Melhor custo-benefício para uso diário (8h/dia)
•Acesso aos modelos mais recentes
•Login via browser OAuth (sem API key)
•Cota reseta mensalmente

Usando API key no Claude Code

# Opção 1: variável de ambiente (sessão atual)
export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude

# Opção 2: persistir no .bashrc ou .zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-..."' >> ~/.bashrc
source ~/.bashrc

# Opção 3: informar na autenticação interativa
claude
# Escolher opção 2 (Enter API key manually)
# Colar a chave quando solicitado

# Verificar qual método está sendo usado
claude --status

⚠️ Nunca exponha sua API key

Não faça git add .env ou commit de arquivos com ANTHROPIC_API_KEY. Adicione ao .gitignore. Chaves expostas em repos públicos são detectadas e revogadas automaticamente pelo Anthropic, mas o dano pode ser feito.

💬 O prompt interativo (REPL)

O REPL do Claude Code aceita linguagem natural, comandos slash e referências a arquivos com @. Entender esses três inputs multiplica sua produtividade.

✓ O que você pode digitar

✓Pedidos em português: "Crie um servidor Express básico"
✓Referência a arquivos: "Refatore @src/api.js"
✓Comandos slash: /help, /clear, /status
✓Mensagens longas: Shift+Enter para nova linha
✓Contexto acumulativo: Claude lembra da conversa

✗ Evitar no REPL

✗Pedidos vagos sem contexto: "melhore o código"
✗Tarefas muito grandes em um único prompt
✗Colar segredos/tokens direto no chat
✗Ignorar as confirmações de permissão

Comandos slash mais úteis

/help          # Lista todos os comandos disponíveis
/clear         # Limpa o contexto da conversa atual
/status        # Mostra modelo, uso de contexto, autenticação
/exit          # Sair do REPL (ou Ctrl+C)
/mcp           # Lista servidores MCP conectados
/init          # Gera CLAUDE.md para o projeto atual
/cost          # Mostra tokens usados na sessão

💡 Use @ para referenciar arquivos

Digitar @ no REPL abre autocomplete de arquivos do projeto. Você pode referenciar um arquivo específico sem colar o conteúdo manualmente:

> Explique o que faz @src/auth/middleware.js e sugira melhorias

⌨️ Primeiros comandos reais

Coloque a mão na massa agora. Estes são os primeiros pedidos que você vai fazer ao Claude Code — cada um demonstra uma capacidade diferente.

1. Criar um arquivo

> Crie um arquivo README.md para este projeto com seções básicas

Claude pede confirmação antes de escrever → você aprova → arquivo criado

2. Explorar o projeto

> O que faz este projeto? Leia os arquivos principais e me explique

Leitura é segura — sem confirmação. Claude lê e resume o codebase

3. Executar comando

> Rode os testes e me diga se todos passaram

Claude pede permissão para executar bash → você aprova → executa e reporta

4. Refatorar código

> Refatore @src/index.js para usar async/await em vez de callbacks

Claude mostra diff antes de aplicar → você revisa → aprova ou cancela

📊 Loop de confirmação

Toda ação que modifica arquivos ou executa comandos passa por confirmação. Este é o mecanismo de segurança central:

y → aprovar e executar
n → recusar (Claude tenta abordagem alternativa)
a → aprovar todas as ações pendentes desta tarefa
Ctrl+C → cancelar tarefa atual

🔄 Sair, retomar e gerenciar sessões

Sessões do Claude Code têm contexto que pode ser retomado. Entender o ciclo de vida da sessão evita perder contexto importante no meio de um projeto.

Comandos de sessão

# Sair do REPL
/exit          # ou Ctrl+C duas vezes

# Retomar sessão anterior do mesmo diretório
claude --resume

# Ver sessões disponíveis
claude --list-sessions

# Iniciar sessão sem histórico (limpa)
claude --no-resume

# Usar claude sem REPL (modo print, para scripts)
claude --print "Gere um script Python para ordenar arquivos por data"

# Passar contexto via stdin
cat meu_arquivo.py | claude --print "Explique este código"

✓ Boas práticas de sessão

✓Use /clear quando mudar de tarefa
✓Retome com --resume para continuar bugs
✓Use /status para ver tokens usados

💡 Contexto e tokens

Cada sessão consome tokens de contexto. Sessões longas ficam mais caras/lentas. Use /clear para resetar quando o contexto não é mais necessário.

✅ Resumo do Módulo 2.2

✓

Primeiro boot detecta ausência de credenciais e inicia onboarding automático

✓

OAuth via browser é o método mais simples para conta Anthropic

✓

API key via ANTHROPIC_API_KEY para automação e CI/CD

✓

REPL aceita linguagem natural, comandos slash e referências @arquivo

✓

Loop de confirmação protege toda ação destrutiva

Próximo Módulo:

2.3 — Configuração: settings.json e permissões. Controle total do comportamento do Claude Code no seu ambiente.

← Módulo 2.1 Próximo Módulo →