Claude Code: o que é, como funciona e quando abrir ele no lugar do chat

Claude Code não é um chat com tema escuro rodando dentro do terminal

É um agente que abre os teus arquivos, mexe neles e roda comando na tua máquina

Fala aí, beleza? Se você chegou aqui só pelo nome, vamos ao ponto: o Claude Code é a ferramenta agêntica de codificação da Anthropic, ela vive no terminal, entende a base de código do projeto e executa tarefas a partir de comandos em linguagem natural

Guarda esse detalhe, porque eu volto nele mais pra frente: o terminal é a casa dele, e o mesmo motor também aparece em outras superfícies (extensão de editor, plugin de IDE, app desktop e web)

O repositório oficial é o anthropics/claude-code, e a ideia central é simples de resumir: em vez de você descrever o problema e colar o resultado de volta no editor, quem lê o código, edita os arquivos, roda os comandos e conversa com as tuas ferramentas de desenvolvimento é ele

Bora entender como isso funciona por baixo?

Como o Claude Code funciona por baixo

O ciclo de trabalho do agente tem três fases que se misturam durante a tarefa: reunir contexto, agir e verificar o resultado

Não é uma esteira bonitinha onde uma fase termina e a outra começa

Ele lê um pouco, mexe num arquivo, roda algo pra conferir, volta a ler, e assim vai, usando ferramentas o tempo todo

E que ferramentas são essas? Aí está a diferença de verdade: o Claude Code tem acesso ao terminal e a qualquer comando que você mesmo poderia rodar

Build tools, git, gerenciadores de pacote, utilitários de sistema, os teus scripts

Se roda no teu shell, está no alcance dele

Tem um detalhe de execução que explica por que ele parece rápido lendo e cauteloso escrevendo: as ferramentas somente de leitura podem rodar em paralelo, enquanto as que alteram estado rodam em sequência

• Em paralelo: Read, Glob, Grep e ferramentas MCP de leitura
• Em sequência: Edit, Write e Bash

Faz sentido, né? Ler dez arquivos ao mesmo tempo não quebra nada

Escrever em dois arquivos ao mesmo tempo, ou rodar dois comandos que se atropelam, é pedir problema

Por isso o Claude Code não é "gerar texto de código": gerar texto acaba quando a resposta termina, o agente só acaba quando a tarefa foi verificada 🙂

Claude Code ou a conversa comum: qual é a diferença na prática

Repara numa coisa importante antes de seguir: o contraste aqui é entre dois JEITOS de trabalhar, agente x conversa, e não entre endereços diferentes

O próprio claude.ai é uma das superfícies onde o Claude Code roda, com seletor de modo e tudo, então dizer "lá é chat, aqui é agente" seria bobagem

Sobre as superfícies, um ponto que costuma passar batido: todas estão ligadas ao mesmo motor e compartilham CLAUDE.md, configurações e servidores MCP

Ou seja, o que você configurou no terminal continua valendo quando abre a extensão

A extensão do VS Code é a forma recomendada de usar o Claude Code dentro do VS Code, e existe plugin para IntelliJ IDEA, PyCharm, WebStorm e outras IDEs JetBrains, com visualização de diff e contexto da seleção

Se a tua dúvida já não é "agente ou conversa" e sim qual agente, tem um comparativo com o Codex CLI que ataca exatamente essa escolha

Quando abrir o Claude Code em vez de só conversar

Nem toda pergunta pede agente

Pra "o que essa função faz", a conversa comum resolve

Os casos onde vale abrir o terminal são estes:

Mudança espalhada por vários arquivos:

Renomear um conceito, trocar uma assinatura usada em meio projeto, ajustar um padrão que aparece em vinte lugares

Aqui o ganho é ele ler a base de código e editar os arquivos, em vez de você caçar ocorrência e colar trecho um por um

Tarefa que só se prova rodando:

Quando a resposta certa depende de build passar, teste rodar ou git mostrar o estado real

Como ele tem acesso ao terminal e a qualquer comando que você poderia rodar, a fase de verificar acontece dentro do mesmo ciclo

Entrar num projeto que você não conhece:

Esse é o meu favorito de recomendar pra quem está começando: usa o modo plano

Nele o Claude lê arquivos, roda comandos de exploração e escreve um plano, sem editar o código

Você ganha um mapa antes de deixar qualquer coisa ser tocada

Subtarefa longa que suja o contexto:

Pra isso existem os subagentes

Cada subagente começa sem o histórico da conversa, carrega o próprio system prompt e o contexto do projeto do CLAUDE.md, e devolve só um resumo pra conversa principal

A investigação pesada acontece lá dentro e não entope a tua sessão

O que você precisa antes de instalar

A lista é curta:

• Um terminal aberto no diretório do projeto (isso importa mais do que parece, já volto nesse ponto)
• Acesso ao Claude Code: ele está incluído nos planos pagos do Claude (Pro e Max), incluído em cada assento do plano Team e disponível no Enterprise
• Ou uma chave de API na variável de ambiente ANTHROPIC_API_KEY
• No Windows nativo: o Git for Windows é recomendado pro Claude Code usar a ferramenta Bash

Sobre esse último item, um aviso pra você não estranhar depois: sem o Git for Windows instalado, o Claude Code usa o PowerShell como shell

Não é o fim do mundo, mas os comandos que você pedir vão rodar em outro shell do que você esperava

Como instalar e rodar o Claude Code pela primeira vez

1. Instale pelo instalador nativo. No macOS e no Linux, a instalação recomendada é via curl:

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

No Windows, a recomendada é pelo PowerShell:

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

E, se você estiver no CMD, a variante é esta:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

O erro comum deste passo é sair instalando por npm no automático

O npm install -g @anthropic-ai/claude-code está depreciado em favor do instalador nativo, que ainda tem a vantagem de se atualizar sozinho em background

Se você veio de um tutorial antigo, dá uma olhada no que mudou na instalação por npm antes de seguir por lá

2. Abra o terminal na pasta do projeto e rode o comando:

claude

Ele mostra a versão, o modelo atual e o diretório de trabalho acima do prompt

O erro comum deste passo é rodar claude de qualquer lugar, tipo a home do usuário

Olha o diretório de trabalho que ele imprimiu: se não for o projeto, sai, entra na pasta certa e roda de novo

3. Faça o login. No primeiro uso ele abre uma janela do navegador pro login, e as credenciais ficam salvas

Se você tiver a variável ANTHROPIC_API_KEY definida, ele pula o login e pede a aprovação da chave

4. Se ambiente na sessão. Dois comandos de barra resolvem o começo:

• /help lista os comandos disponíveis
• /resume continua uma conversa anterior

Esse /resume é o que evita aquela sensação de recomeçar do zero toda vez que você fecha o terminal

O que continua dependendo de você: permissões e contexto

Agente autônomo assusta, e com razão

Só que o controle continua sendo teu, e ele tem nome: modos de permissão

• default: o modo manual, ele pergunta antes
• acceptEdits: aceita edições e comandos comuns de sistema de arquivos
• plan: só leitura

No CLI você cicla entre os modos com Shift+Tab

Nas outras superfícies do Claude Code existe um seletor de modo: VS Code, Desktop e claude.ai

O modo plano também entra prefixando o prompt com /plan, e ele faz o que o nome diz: pesquisa, lê arquivos, roda comandos de exploração e escreve um plano, sem aplicar mudança nenhuma

Agora o aviso duro, e esse aqui vale ouro: as regras de permissão são aplicadas pelo próprio Claude Code, não pelo modelo

Instrução no prompt ou no CLAUDE.md orienta o que o Claude tenta fazer, não muda o que é permitido

Quem quer segurança de verdade mexe no modo de permissão, não escreve "por favor não apague nada" no arquivo de instruções 😀

E o contexto do projeto, como fica?

Esse é o papel do CLAUDE.md: um arquivo markdown com instruções persistentes do projeto, lido no início de cada sessão

Ele pode ficar em ./CLAUDE.md ou em ./.claude/CLAUDE.md

Você não precisa escrever ele na mão: o comando /init cria o arquivo analisando o projeto, com comandos de build, instruções de teste e as convenções que ele encontrou

E se já existir um, ele sugere melhorias em vez de sobrescrever

Além disso existe a memória automática, ligada por padrão

Dá pra alternar com o /memory na sessão, e a preferência fica gravada como autoMemoryEnabled no ~/.claude/settings.json

Quanto custa usar o Claude Code

O Claude Code está incluído nos planos pagos do Claude: Pro e Max, tanto no terminal quanto nas IDEs suportadas (VS Code, forks do VS Code e IDEs JetBrains)

Nos planos de time, ele vem incluído em cada assento do Team e está disponível no Enterprise

Um ponto que muda a conta mental: o uso na IDE e no terminal conta no mesmo limite compartilhado com o Claude

Não são duas cotas separadas, é a mesma

Sobre números, o que dá pra dizer com segurança:

• Pro: US$ 20 por mês (preço dos EUA, cobrado em moeda local onde há suporte)
• Max: definido por multiplicador de uso sobre o Pro, 5x ou 20x o uso do Pro por sessão de 5 horas, com cobrança mensal

Repara que o Max não é vendido como "mais recursos", e sim como mais uso dentro da mesma janela

Por onde começar

Recapitulando o que interessa: o Claude Code é um agente de codificação que vive no terminal (e chega também na extensão do VS Code, no plugin JetBrains, no app desktop e na web, sempre no mesmo motor) e trabalha no ciclo de reunir contexto, agir e verificar, com acesso às mesmas ferramentas que você usa no dia a dia

Ele compensa quando a tarefa envolve o projeto de verdade: vários arquivos, build, git, exploração

E o controle não sai da tua mão, ele mora no modo de permissão

O próximo passo é bem concreto:

1. Instala pelo instalador nativo
2. Abre o terminal na pasta de um projeto que você já conhece (fica muito mais fácil julgar se ele acertou)
3. Roda claude
4. Começa em modo plano, com Shift+Tab, e pede uma exploração
5. Roda /init pra ele criar o teu CLAUDE.md

Depois disso você já tem o suficiente pra formar opinião própria, que é sempre melhor do que ler review dos outros

Até o próximo post!