O Claude Code é uma IA que fica no seu terminal e lê e escreve direto no seu repositório. Colar código na caixa de chat do navegador e copiar a resposta de volta para o editor: esse vaivém acaba.
Este capítulo monta o modelo mental em que os outros seis capítulos se apoiam. Se você pular, nos capítulos seguintes nunca vai ficar claro por que as coisas foram desenhadas do jeito que foram.
Primeiro, o terreno — onde essa ferramenta roda
As ferramentas que fazem a IA escrever código se dividem em três grupos, conforme o lugar onde rodam. O Claude Code pertence ao primeiro.
Rodam no terminal e mexem nos arquivos diretamente. Claude Code, Codex CLI e afins. Bons para assumir um bloco inteiro de trabalho.
Vêm embutidos no editor e sugerem ao lado do que você está digitando. Cursor, GitHub Copilot e afins. Bons para escrever com você olhando.
Tudo acontece no navegador e dá para publicar dali mesmo. v0, Bolt, Lovable e afins. Bons por não exigirem nenhuma configuração local.
A comparação entre os três tipos está no capítulo 1 do curso de coding com IA. Este curso se restringe ao primeiro tipo e vai a fundo.
Aliás, o Claude Code não é exclusivo do terminal. A mesma coisa está disponível como extensão do VS Code ou do JetBrains, como aplicativo de desktop e pelo navegador. Mas a concepção dele nasce no terminal, e, uma vez que você entende isso, nenhuma das outras portas de entrada confunde.
A diferença decisiva em relação ao chat
"O Claude do navegador também escreve código, então o que muda de verdade?" — essa pergunta sempre vem primeiro. A diferença não é inteligência. É alcance.
Ele só enxerga o que você cola. O que devolve é texto. Quem aplica é você. Quando a mudança atinge 10 arquivos, são 10 colagens e 10 viagens de volta.
Ele procura e lê por conta própria. O que devolve é um diff. Roda os testes e, quando falham, corrige e roda de novo. Ele mesmo localiza aqueles 10 arquivos.
A diferença pesa quando o trabalho envolve descobrir coisas. "Rastreie todos os lugares em que essa função é chamada e corrija todos" significa que quem rastreia é você, com uma ferramenta de chat. Um agente faz a busca sozinho.
Invertendo isso, quanto maior o alcance, maior o estrago quando ele erra. É por isso que as permissões precisam ser desenhadas (capítulo 5). Ser inteligente não é ser seguro.
O loop do agente — coletar → agir → verificar
Enquanto o Claude Code trabalha, o mesmo ciclo fica girando por baixo.
Ele procura arquivos, lê e busca quando precisa. O que você deixa ele ler aqui decide o resultado.
Ele reescreve arquivos e roda comandos. O portão de permissão fica aqui.
Ele lê a saída dos testes e da checagem de tipos. Se falharam, volta ao STEP 1.
O que importa é o STEP 3 existir. Uma ferramenta de chat para em "provavelmente é assim". Um agente consegue executar a própria saída e descobrir. Poder continuar corrigindo até os testes passarem vem desse loop.
O que também significa que a vantagem some nas tarefas que você não consegue verificar. "Deixe esse código mais limpo" não tem definição de sucesso, então o loop só gira em falso. O padrão do capítulo 3, entregar antes um meio de verificação, vem exatamente daí.
Ferramentas e permissões — o que ele faz e o que você consegue barrar
O que o Claude Code pode fazer é definido pelo conjunto de "ferramentas" que ele recebeu. Ler um arquivo, escrever um arquivo, rodar um comando, buscar: cada uma é uma ferramenta própria.
E toda chamada de ferramenta passa por uma checagem de permissão. Por padrão, ele pede sua aprovação sempre que reescreve um arquivo ou roda um comando. Existem configurações que pulam a aprovação, e o capítulo 5 trata dos cuidados envolvidos.
Você: "Corrija os testes de autenticação"
↓
[BUSCAR] achar os arquivos ligados à auth ← leitura. sem confirmação por padrão
↓
[LER] ler auth.test.ts ← leitura
↓
[EDITAR] reescrever auth.test.ts ← escrita. a confirmação vem aqui
↓
[EXECUTAR] rodar npm test ← execução. outra confirmação aqui
↓
ler a falha e voltar para [EDITAR]
Quando esse fluxo fica visível, você entende por que ele parou onde parou. Não foi por ter travado. Foi por ter batido em um portão de permissão.
A janela de contexto como restrição
Existe um teto para quanto o Claude Code consegue "guardar na cabeça" de uma vez. Esse teto é a janela de contexto. Quanto mais longa a conversa e mais arquivos ele lê, mais cheia ela fica.
Conforme enche, duas coisas acontecem.
Ele relê um histórico enorme a cada turno, então demora mais e custa mais. Isso se liga direto à conversa sobre custo do capítulo 7.
As premissas que você deu no início são empurradas para fora. "Mas eu já tinha te falado isso" costuma ser isto aqui.
A saída é dobrar a conversa: resumir e comprimir, ou cortar e começar uma nova. Saber quando dobrar exige julgamento, e Devo rodar o /compact em intervalos fixos? trabalha os critérios. Os passos práticos estão no capítulo 3.
Onde ele serve e onde não serve
Você pega a forma de uma ferramenta descobrindo no que ela é ruim.
Correções que atravessam vários arquivos / investigar código existente / iterar até os testes passarem / trabalho de migração repetitivo / rastrear a causa a partir de uma mensagem de erro
Trabalho sem definição de correto / território que você não consegue executar e conferir / decisões de negócio que só você conhece / correções de uma linha (o vaivém da aprovação custa mais)
O lado do "serve mal" não é uma questão de capacidade. É estrutural: o loop de verificação não gira. Por isso trocar por um modelo mais inteligente não resolve.
O mapa deste curso
Aqui está o lugar de cada um dos seis capítulos restantes. Ler na ordem é o padrão, mas, se você já está travado, começar pelo capítulo 4 está de bom tamanho.
Instalar, conectar e fazer a primeira instrução passar.
Colocar o trabalho nos trilhos explorar → planejar → implementar → commitar.
Um procedimento para descer do sintoma até a causa.
Desenhar até onde delegar e onde barrar.
Quando recorrer a CLAUDE.md, hooks, subagents e MCP.
O jeito de operar para usar a ferramenta por muito tempo.
Também existe um site oficial de aprendizado. A Anthropic mantém uma plataforma gratuita, a Claude Academy, que inclui um curso de Claude Code. Este curso não substitui aquele. Ele pende para explicações em português, construídas de trás para frente a partir de casos em que as pessoas realmente travaram. Usar os dois deve ser o caminho mais rápido.
Resumo
- O Claude Code é uma ferramenta no estilo agente que roda no terminal e lê e escreve direto no seu repositório
- A distância em relação ao chat não é inteligência, e sim alcance. Ele busca sozinho, devolve diffs e executa para conferir
- Por baixo há um loop de coletar → agir → verificar. Como o STEP 3 existe, ele consegue seguir corrigindo até os testes passarem
- O que ele faz é definido pelo conjunto de ferramentas, e toda chamada de ferramenta passa por um portão de permissão
- Quando a janela de contexto enche, ele fica lento e esquece o começo. Decidir quando dobrar exige julgamento
- Serve mal para tarefas em que o loop de verificação não gira. Trocar de modelo não resolve
A esta altura você já deve ter uma noção do tipo de ferramenta que o Claude Code é. Agora vamos rodar de verdade. Siga para o capítulo 2, "Instalação e a primeira hora".