🚀 O que e Claude Code
Claude Code e a ferramenta de CLI agentica mais avancada da Anthropic. Diferente de chatbots tradicionais, ele roda direto no seu terminal, le e edita arquivos, executa comandos, entende a estrutura completa do seu codebase e toma acoes concretas. Nao e uma interface de perguntas e respostas. E um assistente que age.
🎯 Conceito Principal
Claude Code e um agente de codificacao que opera no terminal. Quando voce inicia uma sessao, ele mapeia o diretorio do projeto, entende a estrutura de pastas, identifica linguagens e frameworks, e fica pronto para executar tarefas complexas de desenvolvimento.
- • Roda no terminal: Nao e uma interface web. Voce interage via linha de comando, o que significa acesso direto ao sistema de arquivos, ao git, ao npm, ao docker e a qualquer ferramenta CLI que voce ja usa
- • Le e escreve arquivos: Claude Code abre, le, edita e cria arquivos no seu projeto. Ele nao apenas sugere codigo. Ele aplica as mudancas diretamente, com diff visual para voce aprovar
- • Executa comandos: Roda npm install, git commit, pytest, docker build e qualquer outro comando necessario para completar a tarefa. Com sua permissao, claro
- • Entende o codebase: Em vez de voce copiar e colar codigo no chat, o Claude Code navega pelo projeto inteiro, encontra as dependencias, identifica padroes e faz mudancas consistentes em multiplos arquivos
📊 Dados 2026
- 29 milhoes de instalacoes diarias no VS Code (extensao Claude integrada)
- 4% de todos os commits publicos no GitHub sao gerados pelo Claude Code
- 42.8% taxa de adocao entre desenvolvedores profissionais
- 92% de reducao no tempo de conclusao de tarefas de codificacao em benchmarks internos
- 9.000+ plugins no ecossistema, com integracao nativa via MCP
💡 Dica Pratica
A forma mais rapida de entender o poder do Claude Code e usar. Navegue ate qualquer projeto no terminal, digite claude e pergunte: "O que este projeto faz?". Em segundos, ele vai ler o codebase e dar uma analise estruturada que levaria 30 minutos manualmente.
Nao pense nele como "AI que escreve codigo". Pense como um colega senior que acabou de sentar do seu lado, tem acesso ao seu projeto inteiro e pode executar qualquer comando que voce pediria.
🔀 Claude Chat vs Code vs Cowork
A Anthropic oferece tres interfaces distintas para o Claude, cada uma otimizada para um tipo de trabalho. Entender as diferencas e fundamental para usar a ferramenta certa no momento certo. Muita gente tenta fazer tudo no Chat quando deveria estar no Code, ou usa o Code quando o Cowork seria mais eficiente.
🎯 Conceito Principal
Cada produto tem um dominio claro. Quando voce usa a ferramenta certa, a produtividade multiplica. Quando usa a errada, voce luta contra a interface.
- • Claude Chat (claude.ai): Interface web para conversas, analise de documentos, brainstorming, criacao de textos. Voce envia mensagens e recebe respostas. Nao tem acesso ao seu sistema de arquivos, nao executa comandos, nao modifica codigo. Ideal para pensar.
- • Claude Code (terminal CLI): Agente de codificacao agentico. Roda no terminal, le seu codebase inteiro, edita arquivos, executa comandos shell, faz commits, cria PRs. Ideal para construir.
- • Claude Cowork (desktop agent): Agente de desktop para trabalho de conhecimento. Gerencia arquivos, cria apresentacoes, organiza documentos, conecta com servicos via connectors. Ideal para produzir entregas nao-codigo.
Comparacao Detalhada
| Caracteristica | Chat | Code | Cowork |
|---|---|---|---|
| Interface | Web (navegador) | Terminal CLI | Desktop app |
| Acesso a arquivos | Upload manual | Le/escreve direto | Via connectors |
| Executa comandos | Nao | Sim (shell completo) | Limitado |
| Git integrado | Nao | Sim (/commit, /pr) | Nao |
| Codebase awareness | Nao | Sim (completo) | Nao |
| Melhor para | Pensar, analisar | Construir, codar | Produzir, organizar |
💡 Dica Pratica
Regra simples de decisao: se envolve codigo e terminal, use Claude Code. Se envolve conversa e analise, use Claude Chat. Se envolve arquivos nao-codigo e produtividade geral, use Cowork.
Na duvida: se voce precisa que o Claude execute algo (rodar um comando, editar um arquivo, fazer um commit), a resposta e Claude Code. Se voce so precisa pensar junto, e Chat.
✓ O que FAZER
- ✓ Usar Claude Code para qualquer tarefa que envolva seu codebase
- ✓ Usar Chat para planejar arquitetura antes de implementar no Code
- ✓ Combinar ferramentas: planeje no Chat, execute no Code
✗ O que NAO fazer
- ✗ Copiar/colar codigo no Chat quando poderia abrir Claude Code no projeto
- ✗ Tentar usar Claude Code para escrever emails ou documentos longos
- ✗ Ignorar Cowork para tarefas de produtividade que nao envolvem codigo
📋 Pre-requisitos
Antes de instalar o Claude Code, voce precisa de poucas coisas, mas todas sao obrigatorias. A boa noticia: se voce e desenvolvedor, provavelmente ja tem quase tudo. Vamos checar item por item.
🎯 Conceito Principal
Claude Code roda como um pacote npm global. Isso significa que voce precisa do Node.js instalado e de uma conta Anthropic com plano pago para autenticacao. O resto e opcional mas recomendado.
- • Conta Anthropic (obrigatorio): Plano Pro ($20/mes), Team ou Enterprise. O plano gratuito nao inclui acesso ao Claude Code. O Pro da um limite generoso de uso mensal que cobre a maioria dos workflows
-
•
Node.js 18+ (obrigatorio): Recomendado usar a versao 20 LTS. Voce pode verificar com
node --version. Se nao tiver ou estiver desatualizado, use nvm para instalar - • Terminal moderno (obrigatorio): Qualquer terminal funciona: Terminal.app (macOS), iTerm2, Warp, Windows Terminal, Alacritty, Kitty. O terminal padrao do seu SO ja serve
- • Sistema operacional: macOS, Linux ou Windows com WSL. No Windows sem WSL, o funcionamento e limitado. Recomendacao forte: use WSL se estiver no Windows
✅ Checklist de Requisitos
node --version
💡 Dica Pratica
Se voce nao tem Node.js ou precisa atualizar, a forma mais limpa e usar nvm (Node Version Manager). Instale o nvm e depois rode nvm install 20 seguido de nvm use 20. Isso evita problemas de permissao e conflitos com versoes anteriores.
No Windows, nao tente instalar o Claude Code no PowerShell nativo. Use o WSL. O funcionamento no Windows sem WSL tem muitas limitacoes e bugs conhecidos. 5 minutos configurando o WSL economizam horas de frustacao.
⚙️ Instalacao
A instalacao do Claude Code e direta: um unico comando npm. Mas existem detalhes de autenticacao e verificacao que voce precisa acertar na primeira vez. Vamos passo a passo.
🎯 Conceito Principal
Claude Code e distribuido como um pacote npm global. A instalacao coloca o binario claude no seu PATH, disponivel em qualquer diretorio do terminal. Apos instalar, voce autentica uma vez e esta pronto.
- • Pacote global: Instalacao unica que fica disponivel em todo o sistema. Nao precisa instalar por projeto
-
•
Autenticacao via browser: O
claude loginabre o navegador para autenticar com sua conta Anthropic. O token fica salvo localmente -
•
Atualizacoes: Atualize com
npm update -g @anthropic-ai/claude-code. Novas versoes saem frequentemente com melhorias significativas
💻 Comandos de Instalacao
1. Instalar o Claude Code globalmente:
2. Verificar se a instalacao funcionou:
# Deve exibir algo como: claude-code 1.x.x
3. Autenticar com sua conta Anthropic:
# Abre o navegador para autenticacao OAuth
4. Iniciar sua primeira sessao:
$ claude
⚠️ Erros Comuns e Solucoes
EACCES: permission denied
Problema de permissao do npm global. Solucao: configure o npm para usar um diretorio local com npm config set prefix ~/.npm-global e adicione ao PATH. Ou use nvm (recomendado).
Node version incompativel
Claude Code exige Node.js 18+. Verifique com node --version. Se menor que 18, atualize via nvm: nvm install 20 && nvm use 20.
claude: command not found
O binario nao esta no PATH. Rode npm list -g @anthropic-ai/claude-code para confirmar a instalacao. Se instalou, o PATH do npm global nao esta configurado. Use which claude ou adicione o prefixo do npm ao PATH.
Algo mais estranho?
Rode /doctor dentro de uma sessao do Claude Code. Ele diagnostica e tenta resolver problemas de configuracao automaticamente.
💡 Dica Pratica
Se voce usa VS Code, o Claude Code tambem tem uma extensao nativa que integra diretamente no editor. Mas comece pelo terminal: entender o CLI puro primeiro te da mais controle e entendimento de como tudo funciona por baixo.
Mantenha o Claude Code atualizado. As atualizacoes sao frequentes (quase semanais em 2026) e trazem melhorias significativas. Rode npm update -g @anthropic-ai/claude-code periodicamente ou crie um alias: alias ccup='npm update -g @anthropic-ai/claude-code'.
🖥️ Primeira Sessao
A sua primeira sessao no Claude Code e o momento em que tudo faz sentido. Voce navega ate um projeto, digita claude, e o assistente le seu codebase automaticamente. Vamos ver exatamente o que acontece e o que esperar.
🎯 Conceito Principal
Ao iniciar o Claude Code num diretorio, ele faz um scan automatico do projeto. Se existir um arquivo CLAUDE.md na raiz, ele carrega essas instrucoes como contexto persistente. Sem CLAUDE.md, ele ainda funciona, mas sem instrucoes customizadas.
- • Scan automatico: Claude mapeia a estrutura de diretorios, identifica linguagens, frameworks e dependencias do projeto
- • CLAUDE.md: Se existir, funciona como "instrucoes de briefing". Voce pode definir regras de estilo, stack preferida, padroes de nomeacao e comportamentos esperados (veremos isso na Trilha 2)
- • Interface interativa: Apos o scan, voce ve uma area de prompt onde digita instrucoes. O Claude responde, usa ferramentas (Read, Write, Bash, etc.) e mostra indicadores de quais tools esta usando
- • Indicador de custo: No rodape da sessao, voce ve os tokens consumidos e o custo acumulado. Esse numero cresce a cada interacao
Passo a Passo da Primeira Sessao
Navegar ate o projeto
Terminal
Iniciar o Claude Code
Um unico comando
Ele carrega, faz o scan do diretorio e mostra o prompt interativo.
Fazer sua primeira pergunta
Explore o codebase
Claude vai ler os arquivos principais (package.json, README, entry points) e dar uma analise completa do projeto.
Observar as ferramentas em acao
Tool use indicators
Voce vera indicadores como Read(package.json), Glob(**/*.ts), Bash(git log). Isso mostra que o Claude esta ativamente investigando o projeto, nao apenas "chutando" uma resposta.
Continuar a conversa
Sessao interativa
> Mostre o ponto de entrada principal
> Existem testes? Qual a cobertura?
💡 Dica Pratica
Na primeira sessao, foque em explorar, nao modificar. Faca perguntas sobre o projeto, peca para ele explicar partes do codigo, pergunte sobre dependencias. Quando voce estiver confortavel com a interface, ai sim comece a pedir mudancas.
Atalhos uteis logo na primeira sessao: Escape cancela a geracao atual, Shift+Tab ativa modo de multiplas linhas para prompts longos, e /help mostra todos os comandos disponiveis.
✓ O que FAZER
- ✓ Comecar com perguntas explorationais antes de pedir mudancas
- ✓ Observar quais tools o Claude usa para entender o fluxo
- ✓ Iniciar num projeto que voce conhece bem para validar as respostas
✗ O que NAO fazer
- ✗ Pedir mudancas complexas na primeira sessao sem entender a interface
- ✗ Aprovar todas as acoes sem ler os diffs mostrados
- ✗ Iniciar num projeto vazio (o scan nao tera muito para analisar)
🏋️ Exercicio Pratico
Hora de colocar a mao na massa. Este exercicio guiado vai levar voce da instalacao ate sua primeira conversa com o Claude Code. Siga cada passo e confirme o resultado antes de avancar.
Exercicio: Primeiros Passos com Claude Code
Tempo estimado: 10-15 minutos
Instalar o Claude Code
Abra seu terminal e rode o comando de instalacao global:
Aguarde a instalacao completar. Se der erro de permissao, veja a secao de troubleshooting no Topico 4.
Verificar a instalacao
Confirme que o binario esta acessivel:
# Esperado: claude-code 1.x.x (ou versao mais recente)
Fazer login
Autentique com sua conta Anthropic. Um navegador vai abrir automaticamente:
# O navegador abre -> faca login na Anthropic -> autorize o Claude Code
Navegar ate um projeto
Escolha qualquer projeto existente no seu computador:
Nao tem um projeto? Clone um repo publico: git clone https://github.com/expressjs/express.git && cd express
Iniciar sessao interativa
Abra o Claude Code no diretorio do projeto:
Aguarde o carregamento e o scan do projeto. Voce vera o prompt interativo aparecer.
Explorar o projeto
Faca as seguintes perguntas e observe as respostas:
Observe as tools que o Claude usa (Read, Glob, Grep, etc.) para responder cada pergunta.
🎯 Resultado Esperado
Ao completar o exercicio, voce tera o Claude Code instalado, autenticado e tera experimentado sua primeira interacao real com um agente agentico de codificacao. Voce deve ter visto:
- • O Claude lendo arquivos do projeto automaticamente (tool indicators como Read, Glob)
- • Uma analise precisa do que o projeto faz baseada na leitura real do codigo
- • Identificacao correta das tecnologias, dependencias e estrutura
- • O custo da sessao exibido no rodape (deve ser menos de $0.05 para essas perguntas iniciais)
✅ Criterios de Sucesso
🌟 Bonus Challenge
Para ir alem, rode este comando one-liner que combina verificacao da instalacao com um prompt rapido:
O flag -p (print mode) executa um prompt unico sem abrir sessao interativa. E o modo "one-shot" do Claude Code. Voce vai aprender mais sobre ele no modulo 1.4 (Flags de Linha de Comando).
📋 Resumo do Modulo
npm install -g @anthropic-ai/claude-code + claude login + claude.
Proximo Modulo:
1.2 - Comandos Essenciais do Terminal