O que é o Claude Code?
O Claude Code é o assistente de programação da Anthropic que roda direto no terminal. Ele opera de forma agêntica: lê os arquivos do seu projeto sob demanda, propõe mudanças e pede aprovação antes de editar qualquer coisa. Você conversa com ele em linguagem natural — como se fosse um colega de equipe.
Além do terminal, o Claude Code também está disponível em VS Code, JetBrains, no app desktop, na web em claude.ai/code e em CI/CD via GitHub Actions e GitLab.
Instalação
A documentação oficial recomenda o instalador nativo, que faz auto-update em segundo plano:
macOS / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
No Windows, o Git for Windows precisa estar instalado antes.
Métodos alternativos (sem auto-update — você precisa atualizar manualmente):
- Homebrew:
brew install --cask claude-code - WinGet:
winget install Anthropic.ClaudeCode - VS Code: extensão
anthropic.claude-code
Login na primeira execução
Rode claude no terminal e você verá o prompt de login. As contas aceitas são:
- Claude Pro, Max, Team ou Enterprise (recomendado)
- Claude Console (acesso via API com créditos pré-pagos — um workspace "Claude Code" é criado automaticamente para tracking de custo)
- Provedores enterprise: Amazon Bedrock, Google Vertex AI, Microsoft Foundry
Use /login dentro de uma sessão para trocar de conta. As credenciais ficam armazenadas localmente após o primeiro login.
Primeiro fluxo
cd /caminho/do/seu/projeto
claude
Você cai numa tela de boas-vindas com info da sessão, conversas recentes e novidades. Digite /help para ver os comandos ou /resume para retomar uma conversa anterior.
6 fluxos práticos do Quick Start oficial
1. Entender o codebase
o que esse projeto faz?
quais tecnologias esse projeto usa?
explique a estrutura de pastas
onde está o entry point principal?
2. Fazer uma mudança de código
adicione uma função hello world ao arquivo principal
O Claude encontra o arquivo, mostra o diff, pede aprovação e então edita.
3. Operações de Git
quais arquivos eu modifiquei?
faça commit das minhas mudanças com uma mensagem descritiva
crie uma branch nova chamada feature/quickstart
me ajude a resolver os conflitos de merge
4. Corrigir um bug
tem um bug onde usuários conseguem submeter formulários vazios — corrija
5. Adicionar uma feature com validação
adicione validação de input no formulário de registro de usuário
6. Refatorar, escrever testes, atualizar docs, revisar código
refatore o módulo de autenticação para usar async/await em vez de callbacks
escreva testes unitários para as funções de calculadora
atualize o README com instruções de instalação
revise minhas mudanças e sugira melhorias
Comandos essenciais
| Comando | O que faz |
|---|---|
| claude | Inicia o modo interativo |
| claude "task" | Roda uma tarefa única |
| claude -p "query" | Query única, sai depois de responder |
| claude -c | Continua a conversa mais recente do diretório atual |
| claude -r | Retoma uma conversa anterior |
| /clear | Limpa o histórico da conversa |
| /help | Mostra os comandos disponíveis |
| exit ou Ctrl+D | Sai do Claude Code |
Atalhos úteis: ? mostra todos os atalhos do teclado, Tab para autocompletar, seta para cima para histórico, / para navegar por todos os comandos e skills.
Próximos passos
Depois do quick start, vale explorar:
- Como o Claude Code funciona — o loop agêntico e as ferramentas built-in
- Best practices — prompting efetivo e setup de projeto
- Workflows comuns — guias passo-a-passo
- Estendendo o Claude Code —
CLAUDE.md, skills, hooks e MCP
A comunidade fica no Discord da Anthropic.
Documentação oficial: code.claude.com/docs/en/quickstart.
