Claude Code é um agente de software que roda no seu terminal e tem acesso real ao sistema de arquivos, ao shell e a ferramentas externas via MCP. Ele não apenas sugere código — ele lê seus arquivos, escreve implementações, roda testes, corrige erros e faz commit. Entender como instalar, autenticar e os primeiros comandos é a base para o que vem depois.

Instalação e autenticação

# Pré-requisito: Node.js 18+ instalado
node --version   # deve ser >= 18

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verificar instalação
claude --version

# Autenticação — duas opções:

# Opção 1: via conta Claude.ai (Pro ou Team) — recomendado para início
claude
# Abre um fluxo OAuth no browser — autoriza e volta ao terminal

# Opção 2: via API key da Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
claude  # usa a key automaticamente
# Ou coloque no ~/.bashrc / ~/.zshrc para persistir

# Verificar que está autenticado:
claude --version   # exibe modelo em uso e créditos disponíveis

# Configuração inicial (opcional mas recomendado):
claude config set preferredModel claude-sonnet-4-5   # define modelo padrão
claude config set theme dark                          # tema do terminal

A autenticação via conta Claude.ai é a mais simples para começar — ela usa os mesmos créditos do seu plano. Para uso em produção ou CI/CD, a API key é o caminho correto: você controla os gastos separadamente e pode criar keys com permissões restritas no Anthropic Console.

Claude Code vs outras ferramentas: entendendo o que é

Ferramenta	Tipo	Acesso ao sistema	Autonomia	Melhor para
GitHub Copilot	Completador inline	Apenas arquivo aberto	Zero — apenas sugere	Autocompletar dentro do editor
ChatGPT/Claude.ai web	Chat conversacional	Nenhum (só upload manual)	Zero — só texto	Perguntas, explicações, rascunhos
Cursor	IDE aumentado	Projeto via editor	Baixa — edições no editor	Codificação assistida em IDE
Claude Code	Agente autônomo	Sistema de arquivos + shell	Alta — executa ações reais	Implementação, refactoring, debug end-to-end

FerramentaGitHub Copilot

TipoCompletador inline

Acesso ao sistemaApenas arquivo aberto

AutonomiaZero — apenas sugere

Melhor paraAutocompletar dentro do editor

FerramentaChatGPT/Claude.ai web

TipoChat conversacional

Acesso ao sistemaNenhum (só upload manual)

AutonomiaZero — só texto

Melhor paraPerguntas, explicações, rascunhos

FerramentaCursor

TipoIDE aumentado

Acesso ao sistemaProjeto via editor

AutonomiaBaixa — edições no editor

Melhor paraCodificação assistida em IDE

FerramentaClaude Code

TipoAgente autônomo

Acesso ao sistemaSistema de arquivos + shell

AutonomiaAlta — executa ações reais

Melhor paraImplementação, refactoring, debug end-to-end

A distinção chave: Claude Code é um agente que age, não um assistente que sugere. Quando você pede "implemente a autenticação JWT neste projeto", ele lê os arquivos existentes, escreve o código novo, atualiza os imports, roda os testes e reporta o resultado. Não é magia — é acesso real ao ambiente.

Primeiros comandos: como Claude Code funciona na prática

# Modo interativo padrão — uma sessão de conversa
cd meu-projeto
claude

# Interface interativa abre. Você digita, Claude responde e age.
# Exemplos de prompts que funcionam bem:

# "O que esse projeto faz? Me explique a arquitetura"
# → Claude lê os arquivos principais e descreve o projeto

# "Tem algum bug óbvio no arquivo src/auth.ts?"
# → Claude lê o arquivo e analisa

# "Adicione rate limiting na rota POST /api/login"
# → Claude edita o arquivo, possivelmente instala dependências, roda testes

# "Faça commit com uma mensagem descritiva"
# → Claude executa git add + git commit com mensagem gerada

# Comandos especiais dentro da sessão interativa:
# /help                → lista comandos disponíveis
# /clear               → limpa o histórico da sessão
# /compact             → compacta o contexto (economiza tokens em sessões longas)
# /cost                → exibe custo da sessão atual
# /model claude-opus-4-6  → troca o modelo na sessão
# Ctrl+C               → cancela a ação atual sem encerrar
# /exit ou Ctrl+D      → encerra a sessão

Como Claude Code acessa seu código: as ferramentas

# Claude Code tem um conjunto de ferramentas nativas que usa internamente:

# Leitura de arquivos
# → Glob (encontrar arquivos por padrão: "src/**/*.ts")
# → Read (ler conteúdo de um arquivo específico)
# → Grep (buscar string ou regex em arquivos)

# Escrita e edição
# → Edit (fazer substituição exata em arquivo existente)
# → Write (criar novo arquivo ou reescrever existente)

# Execução de comandos
# → Bash (rodar qualquer comando shell com confirmação do usuário)

# Quando Claude usa cada uma:
# - Você pede "o que tem na pasta src/" → Glob
# - Você pede "explique o arquivo main.py" → Read
# - Você pede "onde usamos a função parseToken?" → Grep
# - Você pede "corrija o bug na linha 42" → Edit (cirúrgico)
# - Você pede "crie um novo módulo de autenticação" → Write
# - Você pede "rode os testes e me diga se passam" → Bash

# IMPORTANTE: Bash pede confirmação por padrão
# Claude mostra o comando antes de rodar:
# "Posso executar: npm test -- --coverage"
# Você aprova (Enter) ou recusa (Ctrl+C)

# Você pode ver o que Claude está fazendo em tempo real —
# cada ação de ferramenta é exibida antes de ser executada

Dicas de uso que mudam a produtividade

# 1. Contexto importa: rode claude do diretório raiz do projeto
cd ~/projetos/minha-api
claude   # Claude enxerga todo o projeto

# 2. Seja específico no que quer, vago no como
# ❌ "edite o arquivo auth.ts linha 42 para verificar se o token expirou"
# ✅ "a autenticação está deixando passar tokens expirados — corrija"

# 3. Para sessões longas, use /compact periodicamente
# Claude tem janela de contexto de 200k tokens mas sessões longas ficam lentas
# /compact resume o histórico e libera espaço

# 4. Use /cost para monitorar gasto
/cost   # mostra tokens usados e custo estimado da sessão

# 5. Para tarefas grandes, divida em sessões
# Uma sessão = uma tarefa coesa
# "Implemente autenticação" → uma sessão
# "Adicione testes para o módulo de autenticação" → próxima sessão

# 6. CLAUDE.md no projeto economiza contexto nas próximas sessões
# Em vez de explicar a stack toda vez, documente uma vez no CLAUDE.md
# Claude lê automaticamente no início de cada sessão

# 7. Para revisar o que Claude vai fazer antes de aprovar:
# Pause quando Claude propõe um Bash e leia o comando inteiro
# Claude Code é auditável — você sempre vê antes de aprovar

✅

O loop de trabalho com Claude Code: abre a sessão no diretório do projeto → descreve o problema ou tarefa em linguagem natural → Claude lê o contexto e propõe ações → você aprova as ações → Claude executa e reporta. O valor não está em comandos específicos, mas em ter um agente que entende o projeto completo e age com autonomia supervisionada.

💡

Próximo: Modos de uso — interativo, não-interativo, pipe e headless. Como usar Claude Code além do modo conversacional padrão.

Instalação e autenticação

# Pré-requisito: Node.js 18+ instalado
node --version   # deve ser >= 18

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verificar instalação
claude --version

# Autenticação — duas opções:

# Opção 1: via conta Claude.ai (Pro ou Team) — recomendado para início
claude
# Abre um fluxo OAuth no browser — autoriza e volta ao terminal

# Opção 2: via API key da Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
claude  # usa a key automaticamente
# Ou coloque no ~/.bashrc / ~/.zshrc para persistir

# Verificar que está autenticado:
claude --version   # exibe modelo em uso e créditos disponíveis

# Configuração inicial (opcional mas recomendado):
claude config set preferredModel claude-sonnet-4-5   # define modelo padrão
claude config set theme dark                          # tema do terminal

Claude Code vs outras ferramentas: entendendo o que é

Ferramenta	Tipo	Acesso ao sistema	Autonomia	Melhor para
GitHub Copilot	Completador inline	Apenas arquivo aberto	Zero — apenas sugere	Autocompletar dentro do editor
ChatGPT/Claude.ai web	Chat conversacional	Nenhum (só upload manual)	Zero — só texto	Perguntas, explicações, rascunhos
Cursor	IDE aumentado	Projeto via editor	Baixa — edições no editor	Codificação assistida em IDE
Claude Code	Agente autônomo	Sistema de arquivos + shell	Alta — executa ações reais	Implementação, refactoring, debug end-to-end

FerramentaGitHub Copilot

TipoCompletador inline

Acesso ao sistemaApenas arquivo aberto

AutonomiaZero — apenas sugere

Melhor paraAutocompletar dentro do editor

FerramentaChatGPT/Claude.ai web

TipoChat conversacional

Acesso ao sistemaNenhum (só upload manual)

AutonomiaZero — só texto

Melhor paraPerguntas, explicações, rascunhos

FerramentaCursor

TipoIDE aumentado

Acesso ao sistemaProjeto via editor

AutonomiaBaixa — edições no editor

Melhor paraCodificação assistida em IDE

FerramentaClaude Code

TipoAgente autônomo

Acesso ao sistemaSistema de arquivos + shell

AutonomiaAlta — executa ações reais

Melhor paraImplementação, refactoring, debug end-to-end

Primeiros comandos: como Claude Code funciona na prática

# Modo interativo padrão — uma sessão de conversa
cd meu-projeto
claude

# Interface interativa abre. Você digita, Claude responde e age.
# Exemplos de prompts que funcionam bem:

# "O que esse projeto faz? Me explique a arquitetura"
# → Claude lê os arquivos principais e descreve o projeto

# "Tem algum bug óbvio no arquivo src/auth.ts?"
# → Claude lê o arquivo e analisa

# "Adicione rate limiting na rota POST /api/login"
# → Claude edita o arquivo, possivelmente instala dependências, roda testes

# "Faça commit com uma mensagem descritiva"
# → Claude executa git add + git commit com mensagem gerada

# Comandos especiais dentro da sessão interativa:
# /help                → lista comandos disponíveis
# /clear               → limpa o histórico da sessão
# /compact             → compacta o contexto (economiza tokens em sessões longas)
# /cost                → exibe custo da sessão atual
# /model claude-opus-4-6  → troca o modelo na sessão
# Ctrl+C               → cancela a ação atual sem encerrar
# /exit ou Ctrl+D      → encerra a sessão

Como Claude Code acessa seu código: as ferramentas

# Claude Code tem um conjunto de ferramentas nativas que usa internamente:

# Leitura de arquivos
# → Glob (encontrar arquivos por padrão: "src/**/*.ts")
# → Read (ler conteúdo de um arquivo específico)
# → Grep (buscar string ou regex em arquivos)

# Escrita e edição
# → Edit (fazer substituição exata em arquivo existente)
# → Write (criar novo arquivo ou reescrever existente)

# Execução de comandos
# → Bash (rodar qualquer comando shell com confirmação do usuário)

# Quando Claude usa cada uma:
# - Você pede "o que tem na pasta src/" → Glob
# - Você pede "explique o arquivo main.py" → Read
# - Você pede "onde usamos a função parseToken?" → Grep
# - Você pede "corrija o bug na linha 42" → Edit (cirúrgico)
# - Você pede "crie um novo módulo de autenticação" → Write
# - Você pede "rode os testes e me diga se passam" → Bash

# IMPORTANTE: Bash pede confirmação por padrão
# Claude mostra o comando antes de rodar:
# "Posso executar: npm test -- --coverage"
# Você aprova (Enter) ou recusa (Ctrl+C)

# Você pode ver o que Claude está fazendo em tempo real —
# cada ação de ferramenta é exibida antes de ser executada

Dicas de uso que mudam a produtividade

# 1. Contexto importa: rode claude do diretório raiz do projeto
cd ~/projetos/minha-api
claude   # Claude enxerga todo o projeto

# 2. Seja específico no que quer, vago no como
# ❌ "edite o arquivo auth.ts linha 42 para verificar se o token expirou"
# ✅ "a autenticação está deixando passar tokens expirados — corrija"

# 3. Para sessões longas, use /compact periodicamente
# Claude tem janela de contexto de 200k tokens mas sessões longas ficam lentas
# /compact resume o histórico e libera espaço

# 4. Use /cost para monitorar gasto
/cost   # mostra tokens usados e custo estimado da sessão

# 5. Para tarefas grandes, divida em sessões
# Uma sessão = uma tarefa coesa
# "Implemente autenticação" → uma sessão
# "Adicione testes para o módulo de autenticação" → próxima sessão

# 6. CLAUDE.md no projeto economiza contexto nas próximas sessões
# Em vez de explicar a stack toda vez, documente uma vez no CLAUDE.md
# Claude lê automaticamente no início de cada sessão

# 7. Para revisar o que Claude vai fazer antes de aprovar:
# Pause quando Claude propõe um Bash e leia o comando inteiro
# Claude Code é auditável — você sempre vê antes de aprovar

Claude Code: instalação, autenticação e primeiro uso real

Instalação e autenticação

Claude Code vs outras ferramentas: entendendo o que é

Primeiros comandos: como Claude Code funciona na prática

Como Claude Code acessa seu código: as ferramentas

Dicas de uso que mudam a produtividade

Discussão

Claude Code: instalação, autenticação e primeiro uso real

Instalação e autenticação

Claude Code vs outras ferramentas: entendendo o que é

Primeiros comandos: como Claude Code funciona na prática

Como Claude Code acessa seu código: as ferramentas

Dicas de uso que mudam a produtividade

Discussão