O que é Claude Code? Entenda a ferramenta da Anthropic que programa no seu terminal

Fala aí, beleza? Pedir código pra um chat é uma coisa, ter um agente com acesso ao teu projeto inteiro é outra história bem diferente

No chat tu copia o trecho, cola, explica o contexto na mão, recebe a resposta e cola de volta

O Claude Code corta esse vai e volta: ele é a ferramenta de codagem agêntica da Anthropic, roda no terminal, lê o teu codebase, edita arquivos, roda comandos e integra com as ferramentas de desenvolvimento

Se tu ouviu falar dele e tá na dúvida se vale investir tempo, é isso que a gente vai destrinchar aqui: o que ele é por baixo, no que ele muda em relação a um chat comum, onde ele entra no dia a dia, o que precisa pra rodar e como funcionam os limites

Bora? 🙂

Como o Claude Code funciona por baixo

Ele roda LOCALMENTE no teu terminal e fala direto com as APIs do modelo

Não tem servidor de backend próprio no meio do caminho, nem índice remoto do teu código

Ou seja: quem abre e lê os arquivos é o processo que está na tua máquina, no teu shell, dentro da pasta que tu escolheu

E tem outra peça de desenho que vale entender logo de cara: ele pede permissão antes de alterar arquivos e antes de executar comandos

Esse é o comportamento do modo Manual, e os modos de permissão são configuráveis: mais pra frente eu abro os quatro pra ti

Sobre adoção, o único número que dá pra cravar por aqui: o repositório público anthropics/claude-code tem cerca de 140 mil estrelas no GitHub

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Qual a diferença entre o Claude Code e um chat comum de IA

Essa é a pergunta que trava a maioria das pessoas, então vamos direto ao ponto

Num chat comum, tu é o transportador de contexto: copia arquivo, cola, descreve a estrutura da pasta, avisa qual framework é, cola o erro, e depois carrega a resposta de volta pro editor

Aqui o agente lê o projeto, planeja a abordagem, escreve o código em vários arquivos e ainda verifica se aquilo funciona

O contexto que não se perde: CLAUDE.md

O CLAUDE.md é o mecanismo de contexto persistente da ferramenta

São arquivos markdown com instruções fixas: pro projeto, pro teu fluxo pessoal ou pra organização

O Claude lê esses arquivos no início de cada sessão, então aquilo que tu escreveu ali não precisa ser repetido a cada conversa

No escopo de projeto ele mora no próprio repo, na raiz ou dentro da pasta .claude/

Se tu conhece aquele README que ninguém lê, pensa no contrário disso: é o arquivo que a IA lê SEMPRE antes de encostar no código 😀

O modo de planejamento, pra ele não sair editando

O medo mais comum de quem chega agora é: "e se ele sair mexendo em tudo?"

Pra isso existe o modo de planejamento (plan mode)

Nele o Claude pode ler arquivos e explorar com comandos de shell, e escreve um plano sem editar o código-fonte

As edições ficam bloqueadas até tu aprovar o plano

Tu entra nele com Shift+Tab ou prefixando o teu pedido com /plan

Git como parte do fluxo

Ele trabalha direto com git: prepara as mudanças (stage), escreve mensagens de commit, cria branches e abre pull requests

Aqui mora boa parte da economia de tempo do dia a dia, porque é justamente a parte chata que a gente empurra com a barriga, né?

O que dá para fazer com o Claude Code no dia a dia

A documentação oficial lista um punhado de tarefas que ele assume ponta a ponta, planejando a abordagem, escrevendo o código em vários arquivos e verificando se funciona:

• escrever testes para código sem cobertura
• corrigir erros de lint no projeto
• resolver conflitos de merge
• atualizar dependências
• escrever release notes

Repara no padrão: é manutenção, aquele trabalho que ninguém acorda animado pra fazer

Caçar bug sem saber onde ele mora

Esse é o caso de uso que costuma converter cético

Tu cola a mensagem de erro ou simplesmente descreve o sintoma, e ele rastreia o problema pelo codebase, identifica a causa raiz e implementa a correção

É diferente de perguntar "por que esse erro acontece?" pra um chat, porque ali tu recebe uma hipótese genérica e continua com o trabalho de investigação na mão

Se tu quer uma visão mais geral de para que serve o Claude Code, esse recorte de tarefas já dá o tom do tipo de trabalho que ele puxa pra si

Onde ele roda: terminal, IDE, desktop e navegador

O nome engana um pouco, porque "terminal" virou sinônimo da ferramenta, mas ela está disponível em quatro superfícies: terminal, IDE, aplicativo desktop e navegador

O terminal segue sendo a porta de entrada mais direta, e se tu quer entender como funciona a versão de linha de comando, é por ali que a maioria começa

O que muda no aplicativo desktop

O app desktop do Claude tem três abas: Chat (conversas), Cowork (Dispatch e trabalho agêntico mais longo) e Code (desenvolvimento de software)

Na parte de Code, os recursos que ele traz são:

• sessões paralelas com isolamento de Git
• layout de painéis por arrastar e soltar
• terminal e editor de arquivos integrados
• side chats
• computer use
• revisão visual de diff

Sessão paralela com isolamento de Git é o tipo de coisa que só faz sentido depois que tu já tem duas frentes abertas no mesmo repo e não quer que uma pise na outra

O que você precisa antes de instalar o Claude Code

Antes de sair rodando comando, dá uma conferida se a tua máquina entra nos requisitos oficiais:

• macOS 13.0+, Windows 10 1809+ ou Windows Server 2019+, Ubuntu 20.04+, Debian 10+ ou Alpine Linux 3.19+
• 4 GB ou mais de RAM
• processador x64 ou ARM64
• conexão de internet
• shell Bash, Zsh, PowerShell ou CMD

Nada de PC da Nasa aqui, o trabalho pesado do modelo não acontece na tua máquina

No Windows nativo tem um detalhe: o Git for Windows é recomendado pra que a ferramenta consiga usar a ferramenta Bash

Sem ele, o shell usado é o PowerShell

E tem o acesso, que é o ponto que costuma pegar: pra usar o Claude Code é preciso plano Claude Pro ou Max, assento premium de plano Team ou Enterprise, ou conta no Console (API)

Como instalar e dar o primeiro comando

O caminho recomendado é o instalador nativo, que ainda se atualiza sozinho em segundo plano

1. Confira os requisitos e o acesso antes de tudo. Sistema na versão mínima, 4 GB de RAM, shell suportado e um dos acessos válidos (Pro, Max, assento premium Team/Enterprise ou Console). O erro comum aqui é instalar primeiro e descobrir depois que a conta não tem acesso

2. Rode o instalador nativo do teu sistema. No macOS, Linux ou WSL:

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

3. No Windows, escolha o instalador do teu shell. PowerShell:

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

CMD:

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

O erro comum deste passo é misturar os dois: o comando do PowerShell não roda no CMD e vice-versa

4. Se preferir npm, saiba o que muda. Existe instalação pelo pacote @anthropic-ai/claude-code, que baixa o mesmo binário nativo por baixo:

npm install -g @anthropic-ai/claude-code

Aqui mora uma pegadinha real: a partir da v2.1.198 o pacote npm pede Node.js 22+. Se o teu Node é mais antigo, a instalação te morde. E lembra que o método recomendado continua sendo o instalador nativo

5. No Windows nativo, instale o Git for Windows. É o que permite usar a ferramenta Bash. Sem ele nada explode, o shell só cai pro PowerShell, e aí comando que tu copiou de tutorial Linux não vai colar

6. Abra o teu projeto e comece em plan mode. Shift+Tab ou o prefixo /plan no pedido. Ele lê, explora e escreve o plano sem tocar no código, e as edições ficam travadas até tu aprovar. O erro comum é começar solto num codebase que tu nem conhece direito e depois revisar um diff gigante

7. Cheque quais modelos a tua conta tem com /model. Esse comando é a fonte de verdade: mostra o que está disponível pra ti e permite trocar. Existe ainda o padrão embutido /model opusplan, que usa Opus no planejamento e Sonnet na execução

8. Crie o CLAUDE.md com as regras do repositório. Markdown puro, no repo, na raiz ou na pasta .claude/. É o que ele lê no início de cada sessão, então tudo que tu cansa de repetir mora ali

Os modelos que aparecem na configuração

Na configuração aparecem listados: Sonnet 4.6 (claude-sonnet-4-6), Opus 4.6 (claude-opus-4-6), Opus 4.5 (claude-opus-4-5-20251101), Sonnet 4.5 (claude-sonnet-4-5-20250929) e Haiku 4.5 (claude-haiku-4-5-20251001)

O que tu de fato consegue usar depende da tua conta, e quem responde isso é o /model, não um post na internet 😛

Dá também pra escolher o modelo já na abertura, com a flag --model

Modos de permissão e o que o Claude Code não faz sem você

Essa parte é a que separa o uso tranquilo do uso ansioso, e é aqui que fica claro que pedir permissão a cada ação é uma configuração, não uma tatuagem

São quatro modos de permissão:

• Manual: pergunta antes de editar arquivo e antes de rodar comando
• Accept edits: edita e roda comandos comuns de filesystem sem perguntar, e continua perguntando pros demais
• Plan: explora e propõe um plano, sem editar
• Auto: avalia todas as ações com verificações de segurança em background

A escolha aqui é sobre confiança na tarefa, não sobre coragem: tarefa de manutenção pequena num repo que tu domina pede um modo, refactor grande em código legado pede outro

Trancando o que ele não pode nem ler

Tome cuidado com um ponto antes de soltar a rédea: chave de API, segredo e arquivo .env são leitura que tu provavelmente não quer liberar

Pra isso existe a configuração permissions.deny, no .claude/settings.json

E se tu quer que o projeto SEMPRE comece no plan mode, dá pra definir o defaultMode no mesmo .claude/settings.json

Essas duas linhas de configuração valem mais que qualquer promessa de "prompt mágico" pra ele se comportar

Como estender a ferramenta: CLAUDE.md, skills, MCP, subagents e hooks

Aqui é onde ela deixa de ser "IA no terminal" e vira ambiente de trabalho

Cada mecanismo resolve um problema diferente:

• CLAUDE.md: contexto sempre ligado
• skills: conhecimento e fluxos sob demanda
• MCP: conexão com serviços externos
• subagents: contexto isolado
• hooks: automação em eventos de ciclo de vida

O erro clássico de quem chega agora é jogar TUDO no CLAUDE.md e reclamar depois que o contexto ficou pesado

Se é conhecimento que só interessa em certos momentos, o lugar disso é uma skill

O formato de uma skill

O formato recomendado é .claude/skills/<nome>/SKILL.md

Ela é invocável por /nome, funcionando como slash command, e também pode ser acionada sozinha pelo Claude quando faz sentido

Dois coelhos numa cajadada: vira atalho pra ti e vira conhecimento sob demanda pra ele 😀

Quanto custa e como funcionam os limites de uso

O acesso ao Claude Code vem por plano Claude Pro ou Max, assento premium de Team ou Enterprise, ou conta no Console (API)

O plano Pro custa US$ 20 por mês nos Estados Unidos, com preço variando por região

O Max existe em duas faixas de uso em relação ao Pro por sessão de 5 horas: Max 5x e Max 20x

O detalhe que pega todo mundo: o limite é compartilhado

O uso do Claude Code divide o mesmo limite do resto do plano

Atividade no claude.ai, no terminal e no Claude Desktop cai tudo no mesmo pool

Então aquela tarde inteira conversando no chat aparece na conta quando tu senta pra codar, e é bom saber disso ANTES

O limite por sessão reseta a cada cinco horas, e o plano Pro também tem limite semanal, que reseta em dia e horário fixos atribuídos à tua conta

Em planos Pro, Max, Team ou Enterprise por assento, o consumo aparece em barras de progresso da sessão de 5 horas e do limite semanal em Settings > Usage, nas configurações da conta Claude

Vale a pena investir tempo no Claude Code?

Veredito honesto, sem hype

Faz sentido pra ti se:

• tu trabalha num codebase existente, com muitos arquivos e histórico
• a tua rotina tem manutenção repetitiva: testes faltando, lint, dependências, conflito de merge, release notes
• git é parte pesada do teu dia, com branch e pull request o tempo todo
• tu topa gastar um tempo inicial configurando CLAUDE.md, permissões e skills

Talvez não compense AGORA se:

• teu uso é esporádico, uma dúvida solta aqui e ali
• tu não tem nenhum dos acessos pagos e não pretende assinar
• tuas perguntas são de resposta curta, do tipo que um chat resolve em dois minutos sem precisar tocar em arquivo nenhum

E tem o fator limite compartilhado: se tu já usa o claude.ai pesado no dia, considera que a conta é a mesma

Conclusão

Resumindo em uma frase: o Claude Code é a ferramenta de codagem agêntica da Anthropic que roda localmente no terminal (e também em IDE, desktop e navegador), lê o teu projeto, planeja, edita arquivos, roda comandos e cuida do fluxo de git, dentro do modo de permissão que tu escolher

O próximo passo concreto é curto: instala pelo método nativo, abre o teu projeto, começa em plan mode e escreve um CLAUDE.md com as regras do repositório

Só com isso tu já sai do "copia e cola no chat" pra um fluxo bem mais adulto

faça o teste e tira a tua própria conclusão, é o melhor jeito de decidir se vale o tempo =)

até o próximo post!