Claude Code — Introdução

Chegamos ao capítulo final deste guia — e à ferramenta mais avançada do ecossistema Claude. O Claude Code é onde toda a inteligência da Claude ganha acesso direto ao mundo real: sistema de arquivos, terminal, comandos de shell, Git, IDEs e pipelines de CI/CD.

Se o Chat é onde você conversa com a Claude e o CoWork é onde ela executa tarefas de produtividade, o Claude Code é onde ela se torna um desenvolvedor sênior pareando com você. Ele não apenas gera código — ele lê seu codebase inteiro, entende a arquitetura, edita múltiplos arquivos, roda testes, depura problemas, cria commits e abre pull requests. Tudo de forma autônoma, com você mantendo o controle.

Segundo a documentação oficial da Anthropic, o Claude Code é "uma ferramenta agêntica de codificação que lê seu codebase, edita arquivos, executa comandos e se integra com suas ferramentas de desenvolvimento". Ele está disponível no terminal, no VS Code, no JetBrains, no aplicativo desktop, no navegador e até no Slack.

Neste capítulo, você vai entender o que o Claude Code faz e como ele se diferencia das outras ferramentas, como instalá-lo, os modos de interação, o sistema de permissões, CLAUDE.md e memória, Hooks, sub-agentes, e como ele se encaixa no fluxo de trabalho de um desenvolvedor moderno. Mesmo que você não seja programador, entender o Claude Code completa sua visão do ecossistema Claude e pode inspirar novas formas de trabalhar.

O Claude Code é um assistente de codificação agêntico (agentic coding tool) que opera diretamente no seu ambiente de desenvolvimento. Diferente de ferramentas tradicionais de autocomplete (que sugerem a próxima linha de código), o Claude Code funciona como um agente autônomo que pode:

• Ler seu codebase inteiro — Entende a arquitetura, padrões e dependências do seu projeto.
• Editar arquivos — Modifica código em múltiplos arquivos de forma coordenada.
• Executar comandos — Roda comandos no terminal (testes, builds, linting, deploys).
• Depurar problemas — Cole uma mensagem de erro e ele rastreia a causa raiz pelo codebase.
• Gerenciar Git — Faz staging, escreve mensagens de commit, cria branches e abre pull requests.
• Conectar ferramentas via MCP — Lê docs no Google Drive, atualiza tickets no Jira, puxa dados do Slack.

O Claude Code está disponível em múltiplas superfícies, todas conectadas ao mesmo motor:

• Terminal/CLI — A interface original, completa e poderosa. Rode claude na pasta do projeto.
• VS Code — Extensão com diffs inline, @-mentions, revisão de plano e histórico de conversas.
• JetBrains — Plugin para IntelliJ, PyCharm, WebStorm e outros IDEs da família.
• Desktop App — Aba "Code" no aplicativo desktop, com diffs visuais e sessões lado a lado.
• Web — Em claude.ai/code, sem instalação local necessária. Ideal para tarefas longas.
• Slack — Mencione @Claude com um bug report e receba um pull request de volta.

Todas as superfícies compartilham a mesma configuração: seus arquivos CLAUDE.md, settings e servidores MCP funcionam em todas elas.

Com três ferramentas poderosas no ecossistema, é importante saber quando usar cada uma:

Chat — Para interações conversacionais. Perguntas, análises de texto, geração de conteúdo, brainstorming, explicações. Você pergunta, a Claude responde. O output é texto e artefatos visuais.

CoWork — Para trabalho de produtividade no desktop. Criação de documentos, organização de arquivos, análise de dados, pipelines com Notion/Gmail/Slack. A Claude planeja e executa tarefas com arquivos locais via interface gráfica. Projetado para não-programadores.

Claude Code — Para desenvolvimento de software. Escrita de código, debugging, refatoração, testes, DevOps, automação. A Claude opera diretamente no terminal e no IDE com acesso total ao codebase. Projetado para desenvolvedores.

A regra prática: se a tarefa envolve código-fonte, terminal ou pipeline de desenvolvimento, use Claude Code. Se envolve documentos, apresentações ou organização de trabalho, use CoWork. Se é uma conversa, pergunta ou geração rápida, use Chat.

Na prática, as fronteiras são fluidas. Você pode começar no Chat brainstormando uma solução, migrar para Claude Code para implementar, e usar CoWork para criar a documentação. As três ferramentas se complementam — e o novo recurso Dispatch permite até que uma conversa siga você do celular para o desktop sem perder contexto.

O Claude Code pode ser instalado de múltiplas formas. A instalação nativa é recomendada porque atualiza automaticamente:

macOS e Linux:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Alternativas: Homebrew (brew install --cask claude-code) ou WinGet (winget install Anthropic.ClaudeCode). Note que essas alternativas não atualizam automaticamente.

Após instalar, o uso é direto:

1. Abra o terminal e navegue até a pasta do seu projeto: cd seu-projeto
2. Execute: claude
3. Na primeira vez, faça login com sua conta Claude (Pro, Max, Team ou Enterprise necessário).
4. Descreva o que quer fazer em linguagem natural.

O Claude Code imediatamente analisa a estrutura do seu projeto, lê os arquivos relevantes, e está pronto para trabalhar. Alguns exemplos de comandos iniciais:

• claude "write tests for the auth module, run them, and fix any failures"
• claude "commit my changes with a descriptive message"
• claude "explain how the payment system works in this codebase"

O Claude Code segue a filosofia Unix: é composável e pode ser integrado em pipelines. Você pode direcionar output de outros comandos para ele:

tail -200 app.log | claude -p "analise se há anomalias"

git diff main --name-only | claude -p "revise estes arquivos por problemas de segurança"

O Claude Code oferece três modos de interação que controlam o nível de autonomia da Claude — permitindo que você escolha quanto controle manter:

Ask (Perguntar) — A Claude propõe cada mudança e aguarda sua aprovação antes de modificar qualquer arquivo. É o modo mais conservador: nada acontece sem seu "ok". Ideal para codebases sensíveis ou quando você está aprendendo como o Claude Code trabalha.

Code (Codificar) — A Claude aplica modificações em arquivos automaticamente, mas pede aprovação antes de executar comandos no terminal. Isso significa que ela pode editar código livremente, mas não roda testes, builds ou scripts sem sua confirmação. É o modo padrão e o equilíbrio ideal para a maioria dos desenvolvedores.

Plan (Planejar) — A Claude elabora sua estratégia completa antes de fazer qualquer mudança. Você revisa o plano inteiro em um viewer dedicado, ajusta se necessário, e só então autoriza a execução. Ideal para tarefas complexas que envolvem múltiplos arquivos e dependências.

Além dos modos, existe o Auto Mode — uma alternativa mais segura para tarefas longas que concede autonomia balanceada à Claude. É oficialmente descrito como "uma alternativa mais segura" do que desativar permissões completamente, oferecendo o equilíbrio entre supervisão e fluidez.

O sistema de permissões é progressivo: você pode começar no modo Ask para entender como o Claude Code trabalha no seu projeto, migrar para Code quando ganhar confiança, e usar Plan para refatorações grandes. O nível de controle é sempre seu.

Assim como Projects têm Custom Instructions, o Claude Code tem o CLAUDE.md — um arquivo Markdown que você coloca na raiz do seu projeto e que a Claude lê automaticamente no início de toda sessão.

O CLAUDE.md é onde você define:

• Padrões de código — Convenções de nomenclatura, estilo, linting, formatação.
• Decisões de arquitetura — Stack tecnológico, padrões de design, bibliotecas preferidas.
• Checklists de revisão — O que verificar antes de fazer commit ou abrir PR.
• Comandos do projeto — Como rodar testes, build, deploy. Como configurar o ambiente.
• Regras específicas — "Nunca modifique arquivos em /config sem aprovação", "Sempre use TypeScript strict mode".

Pense no CLAUDE.md como o onboarding document que você daria para um novo desenvolvedor no primeiro dia. Tudo que ele precisa saber sobre o projeto, as regras e como trabalhar — em um único arquivo.

Além do CLAUDE.md, o Claude Code possui Auto Memory: à medida que trabalha no seu projeto, ele salva automaticamente insights como comandos de build, técnicas de debugging e padrões do codebase. Esses aprendizados persistem entre sessões sem que você precise escrever nada — a Claude aprende com o uso.

A combinação de CLAUDE.md (instruções explícitas) com Auto Memory (aprendizados implícitos) faz com que o Claude Code fique progressivamente mais eficaz quanto mais você o usa no mesmo projeto.

Três funcionalidades avançadas que ampliam significativamente o que o Claude Code pode fazer:

Hooks

Hooks são scripts que disparam automaticamente em momentos específicos do fluxo de trabalho do Claude Code. O nome vem do inglês "gancho" — você "engancha" um script em um evento, e ele roda toda vez que aquele evento acontece.

Exemplos práticos:

• Auto-formatar código depois de cada edição de arquivo.
• Rodar lint antes de cada commit.
• Executar testes automaticamente após mudanças em arquivos críticos.
• Validar que nenhum arquivo sensível foi incluído no staging.

Hooks são reativos (respondem a eventos), enquanto Skills são consultivas (a Claude busca quando precisa de expertise).

Custom Commands (Skills no Claude Code)

No contexto do Claude Code, Skills funcionam como comandos customizados — workflows reutilizáveis que sua equipe pode compartilhar. Invocados com / na interface: /review-pr, /deploy-staging, /run-security-audit. Cada comando encapsula um fluxo de trabalho completo que a Claude executa autonomamente.

Sub-agentes

Para tarefas grandes, o Claude Code pode criar múltiplos agentes que trabalham em paralelo em partes diferentes do problema. Um agente líder coordena o trabalho, atribui subtarefas, e consolida os resultados. Na prática, isso significa que uma refatoração que afeta 50 arquivos pode ser dividida entre vários agentes que trabalham simultaneamente — reduzindo drasticamente o tempo total.

Baseado na documentação oficial da Anthropic, aqui estão as categorias principais de uso do Claude Code:

Automatizar o trabalho tedioso — Escrever testes para código não testado, corrigir erros de lint em todo o projeto, resolver conflitos de merge, atualizar dependências, escrever release notes. As tarefas que você adia porque são repetitivas e demoradas.

Construir features e corrigir bugs — Descreva o que quer em linguagem natural. O Claude Code planeja a abordagem, escreve o código em múltiplos arquivos e verifica se funciona. Para bugs, cole a mensagem de erro — ele rastreia a causa pelo codebase, identifica o problema e implementa a correção.

Criar commits e pull requests — O Claude Code trabalha diretamente com Git: faz staging das mudanças, escreve mensagens de commit descritivas, cria branches e abre PRs. Em CI/CD, pode automatizar code review e triagem de issues via GitHub Actions ou GitLab CI/CD.

Conectar ferramentas via MCP — Leia design docs no Google Drive, atualize tickets no Jira, puxe dados do Slack, ou use suas próprias ferramentas customizadas — tudo via Model Context Protocol.

Agendar tarefas recorrentes — Revisão de PRs toda manhã, análise de falhas de CI overnight, auditoria de dependências semanal, sincronização de docs após PRs serem mergeados. Tarefas agendadas na nuvem continuam rodando mesmo com o computador desligado.

Trabalhar de qualquer lugar — Comece no terminal, continue no celular com Remote Control. Envie uma tarefa do Slack e receba um PR de volta. Inicie uma sessão longa na web e puxe para o terminal com /teleport. As sessões seguem você entre dispositivos.

Se você chegou até aqui e não é programador, pode estar pensando: "Esse capítulo não é para mim." Mas existe um motivo importante para entender o Claude Code, mesmo que você nunca abra um terminal.

Primeiro: o Claude Code pode ser usado para criar ferramentas para você mesmo. Descreva em linguagem natural o que precisa — "crie um app web simples que me ajude a organizar meus estudos com flashcards" — e o Claude Code cria. O conceito de vibe coding (programar pela "vibe", descrevendo o que quer sem saber código) é real e cada vez mais acessível.

Segundo: entender o Claude Code completa sua visão do ecossistema. Chat para conversar, CoWork para produtividade no desktop, Claude Code para desenvolvimento — cada peça tem seu lugar. Quando você entende o quadro completo, toma melhores decisões sobre qual ferramenta usar para cada problema.

Terceiro: o Claude Code está disponível no navegador em claude.ai/code, sem instalação. Você pode experimentá-lo diretamente, sem precisar configurar nada. Descreva um projeto simples e veja o que acontece.

E por fim: se você trabalha com desenvolvedores ou lidera equipes que incluem programadores, entender o Claude Code ajuda a ter conversas mais produtivas sobre como a IA está transformando o processo de desenvolvimento de software.

Este capítulo encerra o guia "Dominando a Claude: Do Zero ao Avançado". Ao longo de 10 capítulos, você passou do básico — o que é a Claude, modelos, interface — até as ferramentas mais avançadas do ecossistema: Projects, Skills, Integrações, CoWork e Claude Code. Cada camada constrói sobre a anterior, e juntas elas formam um sistema completo de produtividade assistida por IA.

O mais importante agora é praticar. Abra o claude.ai, crie um Project, teste uma Skill, conecte o Notion, explore o CoWork. A teoria abre portas, mas é a prática que transforma. Boa jornada.