Claude Code: o que é e por que ele é diferente de usar o Claude pelo navegador?

Fala aí, beleza? A diferença entre usar o Claude pelo navegador e usar o Claude Code cabe numa frase: um responde dentro da caixa de conversa, o outro abre os arquivos do seu projeto e trabalha neles

Se você só conhece o Claude pelo Claude.ai, o fluxo é sempre o mesmo: você leva o código pra conversa, lê a resposta, copia de volta pro editor

O Claude Code inverte esse caminho

Ele é a ferramenta de programação agêntica da Anthropic que lê o código do projeto, edita arquivos, roda comandos e se integra às ferramentas de desenvolvimento, como diz a documentação oficial

A descrição no repositório oficial no GitHub vai na mesma linha: uma ferramenta agêntica que vive no terminal, entende o codebase e ajuda em tarefas rotineiras, explicação de código e fluxos de git por comandos em linguagem natural

Ou seja: a mudança não é o modelo ficar mais esperto, é o lugar onde ele trabalha

Claude no navegador x Claude Code: a diferença na prática

Se liga na comparação por critério:

A linha mais importante dessa tabela é a do acesso aos arquivos

Todas as outras são consequência dela 🙂

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 114 aulas
• 4 projetos
• 9h 18min

Conhecer formação

Quais tarefas mudam de figura com o Claude Code

Tem tarefa que no chat é chata e no agente é natural, justamente porque ele já está dentro do projeto:

• Explicar código do seu próprio repositório: o agente entende o codebase, então a explicação sai sobre os seus arquivos e não sobre um trecho solto que você colou
• Tarefas rotineiras: aquele trabalho repetitivo que você adiava porque dava preguiça de fazer na mão
• Fluxos de git por linguagem natural: git workflows estão na descrição oficial da ferramenta, você pede em português e ele resolve por comandos
• Revisão de diffs: o app desktop permite revisar diffs visualmente, e nas IDEs da JetBrains existe visualização interativa de diff
• Sessões paralelas: dá pra rodar várias sessões lado a lado no desktop, e a versão web permite rodar tarefas em paralelo
• Tarefas agendadas: o app desktop deixa agendar tarefas recorrentes e iniciar sessões na nuvem
• Trabalhar em repositório que você nem tem na máquina: isso é da versão web, que roda sem setup local e ainda aguenta tarefa longa

Nem toda tarefa vale delegar pro agente, claro

Se você quer critério pra separar o que compensa mandar do que é mais rápido fazer na mão, dá uma olhada em como saber se a tarefa vale delegar

Onde o Claude Code roda: terminal, IDE, desktop e web

A ferramenta roda em quatro superfícies: terminal, extensões de IDE, aplicativo desktop e navegador

E aqui vem o detalhe que muita gente não sacou: todas elas conectam ao mesmo motor

Na prática isso significa que os arquivos CLAUDE.md do repositório, as configurações e os servidores MCP funcionam em todas as superfícies

Você não configura quatro ferramentas, você configura uma e escolhe por onde entrar

O que cada superfície agrega:

• Terminal: o lugar onde a ferramenta vive, segundo a própria descrição do projeto
• Extensões de IDE: são duas, e cada uma tem a sua cara

– No VS Code, a extensão oferece interface gráfica nativa e é a forma recomendada de usar o agente por ali, com revisão e edição dos planos antes de aceitar, auto aceite de edições, menção de arquivos com intervalos de linha via @, histórico de conversas e múltiplas conversas em abas ou janelas separadas – Nas IDEs da JetBrains (IntelliJ IDEA, PyCharm, WebStorm e outras), a instalação é como plugin pelo JetBrains Marketplace, com reinício da IDE, e traz visualização interativa de diff e compartilhamento do contexto da seleção

• App desktop: diffs visuais, várias sessões lado a lado, tarefas recorrentes agendadas e sessões iniciadas na nuvem
• Web: roda no navegador sem setup local, serve pra disparar tarefas longas, trabalhar em repositórios que você não tem localmente e rodar tarefas em paralelo. Está disponível em navegadores desktop e no app Claude para iOS

Se você é do tipo que vive no terminal, comece por ele

Se você é do tipo que só sai da IDE pra tomar café, comece pela extensão, o motor é o mesmo

Como o Claude Code lembra do seu projeto: CLAUDE.md e memória

Que mágica é essa de o agente parecer que já conhece o projeto?

Não é mágica, são dois mecanismos que carregam conhecimento entre sessões

O primeiro é o CLAUDE.md: um arquivo markdown de instruções persistentes que você escreve, carregado no início de toda sessão, segundo a documentação de memória

É ali que moram as convenções do projeto, as notas de arquitetura e as regras do tipo sempre faça X

Não precisa escrever do zero: pela mesma documentação, o comando /init gera um CLAUDE.md inicial e o /memory permite refinar depois

O segundo mecanismo é a memória automática: notas que o próprio Claude escreve com base nas suas correções e preferências

Os dois são carregados no início de cada conversa

A diferença pro chat é essa: uma janela de conversa não lê o CLAUDE.md nem os settings do seu repositório, então cada vez que você abre uma nova você conta a mesma história de novo

Quem manda nas edições: os modos de permissão

O medo clássico de quem nunca usou agente é esse: e se ele sair editando meu projeto inteiro?

Se liga nisso, porque é o ponto que mais tranquiliza: as regras de permissão são aplicadas pelo Claude Code, não pelo modelo

Instruções no prompt ou no CLAUDE.md moldam o que o Claude tenta fazer, mas não mudam o que a ferramenta permite

É uma separação importante: pedir bonitinho no arquivo de instruções não é o mesmo que liberar acesso

Pra alternar entre os modos de permissão, o atalho é Shift+Tab

Um dos modos é o acceptEdits: segundo a documentação de modos de permissão, ele serve pra quem prefere revisar as mudanças depois no editor ou via git diff em vez de aprovar cada edição individualmente

Escolha conforme o seu nível de paranoia com o repositório, e não tem resposta errada aqui 😀

O que muda quando o agente lê a documentação antes de codar

No vídeo abaixo eu mostro uma situação que só existe porque a ferramenta roda no meu ambiente

Eu usei ele direto no terminal, dentro de um projeto Next.js que já existia na minha máquina, e não numa janela de chat separada

Adicionei o servidor MCP do Context7 pela linha de comando da própria ferramenta, confirmei a instalação e reiniciei ela pra mudança valer

Depois de reiniciar, conferi a conexão rodando /mcp dentro da sessão e vi o Context7 listado como conectado

Aí veio a parte que eu gosto: precisei autorizar o uso da ferramenta externa antes de ele executar a busca

Ou seja, a execução ficou sob permissão explícita minha, exatamente como descrevi na seção anterior

Pedi pra ele verificar se as rotas protegidas do projeto estavam configuradas corretamente

E ele leu os arquivos reais do projeto pra responder

O retorno apontou problemas concretos no meu código: rotas de API fora do match do middleware e uma rota sem as subrotas cobertas na proteção

Melhor ainda: classificou o risco como baixo e sugeriu uma camada extra de verificação, em vez de simplesmente reescrever o que já estava funcionando

Na minha avaliação, sem a documentação atualizada ele não teria chegado nessa sugestão

A contrapartida que observei é que o caminho via MCP consome bastante token, porque cada pedido dispara uma consulta externa e volta

Por isso eu prefiro a alternativa de gerar uma skill que fica salva localmente no projeto e é consultada como arquivo, sem ida e volta de MCP

Gerei a skill por um comando de terminal separado, fora da sessão do agente, e faço questão de destacar que aquilo não tinha relação com o MCP instalado

O gerador detectou o projeto aberto, escolhi instalar a skill ali dentro e depois abri o arquivo gerado pra revisar o conteúdo

Na hora de usar, eu prefiro citar o nome da skill explicitamente no prompt em vez de torcer pro agente carregar sozinho

A contrapartida da skill é que ela é fixa: só atualiza se eu pedir pra regerar

Recomendo rodar esse tipo de revisão em projetos já prontos, é uma forma fácil de checar se está tudo correto

Dá pra entrar com esse contexto externo no meio de um projeto sem problema, mas eu considero melhor começar assim desde o início pra evitar erro futuro

E olha, a criação de skill não é exclusiva dessa ferramenta, serve pra outras ferramentas de programação com IA também

Nada disso acontece numa caixa de chat, porque nada disso é conversa: é leitura de arquivo real, permissão e execução dentro do seu ambiente

O que você precisa para testar o Claude Code

Antes de sair instalando, confere a lista:

• Conta paga: a ferramenta exige Pro, Max, Team, Enterprise ou Console
• O plano gratuito do Claude.ai NÃO inclui acesso ao Claude Code, então se você só usa o chat no free, esse é o primeiro passo
• Pro custa US$ 20 por mês nos EUA, com preço variando por região
• Max dá tudo do Pro mais uso maior, em duas opções: 5x ou 20x o uso do Pro por sessão de 5 horas, além de limites de saída mais altos
• Chave de API não é necessária: com qualquer assinatura paga do Claude (Pro, Max, Team ou Enterprise) ou conta do Claude Console, você usa sem gerar chave nenhuma

Esse último ponto trava muita gente à toa

Se você já paga o Claude, não precisa criar conta de API separada só pra experimentar

Como instalar e abrir a primeira sessão

Bora ver na prática? Escolha o caminho da sua máquina e siga

1. Instalar no macOS ou Linux pelo instalador oficial

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

O erro comum deste passo é copiar o comando pela metade e o terminal ficar esperando o resto, então cole a linha inteira

2. Instalar no macOS pelo Homebrew

São dois casks: claude-code (canal estável) e claude-code@latest (canal latest)

O erro comum aqui é instalar o canal latest sem querer e depois estranhar comportamento diferente do time, decida o canal antes

3. Instalar por gerenciador de pacotes no Linux

Tem instalação via apt, dnf ou apk em Debian, Fedora, RHEL e Alpine

O erro comum é usar o gerenciador da distro errada, apk é do Alpine e não vai existir no seu Ubuntu

Sobre Windows: o comando exato de instalação por PowerShell eu não consegui confirmar na doc oficial, então prefiro não ensinar passo errado aqui

4. Abrir o terminal na pasta do projeto e iniciar a sessão

claude

O comando é executado dentro do diretório do projeto, esse é o pulo do gato

O erro comum é rodar claude na home do usuário e depois reclamar que ele não achou seus arquivos 😛

5. Fazer login no primeiro uso

O login é feito rodando claude e seguindo os prompts no navegador

O erro comum aqui tem nome: se a variável de ambiente ANTHROPIC_API_KEY estiver definida, ele pede aprovação da chave uma vez em vez de abrir o navegador

Se o navegador não abriu, provavelmente é isso e não um bug

6. Ler o prompt que apareceu

Ao iniciar, o prompt mostra a versão, o modelo atual e o diretório de trabalho

Bate o olho no diretório antes de pedir qualquer coisa, é a checagem que evita dor de cabeça

7. Conhecer os comandos da sessão

Dentro da sessão, /help lista os comandos disponíveis e /resume continua uma conversa anterior

O erro comum é fechar o terminal achando que perdeu tudo, quando dava pra retomar

8. Gerar o arquivo de instruções do projeto

Rode /init pra gerar um CLAUDE.md inicial e depois use /memory pra refinar

O erro comum é pular esse passo e ficar repetindo as mesmas convenções em toda sessão

Vale trocar o chat pelo Claude Code?

Veredito honesto, por perfil

Ganha muito com o agente quem trabalha num projeto real, versionado, com convenções próprias e tarefas repetitivas

Se o seu incômodo é ficar copiando código de um lado pro outro e reexplicando o projeto toda vez, o agente resolve exatamente isso, porque ele lê o codebase e carrega o CLAUDE.md no início de cada sessão

Continua bem servido pelo chat quem usa o Claude pra tirar dúvida solta, entender um conceito, revisar um trecho pequeno ou nem está mexendo em código

E tem o requisito prático: o plano gratuito do Claude.ai não inclui a ferramenta, então pra quem está no free a conversa começa por assinar

As duas coisas convivem numa boa, e é o cenário mais comum

Dúvida conceitual e rascunho de ideia na conversa, trabalho dentro do repositório no agente

Depois que a ferramenta entra na sua rotina, vale conhecer o que orbita ela, tipo o que o Ponytail faz

O que eu não recomendo é decidir sem testar, porque a diferença aqui não é de qualidade de resposta, é de formato de trabalho

Conclusão

Recapitulando o que separa os dois: o chat responde sobre o código que você leva pra conversa, o Claude Code age no seu projeto

Ele lê o codebase, edita arquivos, roda comandos e cuida de git workflows, com permissões aplicadas pela própria ferramenta e não pelo modelo

Roda em terminal, IDE, app desktop e web, todos ligados ao mesmo motor, então CLAUDE.md, settings e servidores MCP valem em qualquer superfície que você escolher

O próximo passo concreto é bem chato de tão simples: abre o terminal na pasta de um projeto real, roda claude e depois /init pra gerar o seu CLAUDE.md

Daí você vê na prática se o formato faz sentido pro seu jeito de trabalhar 🙂

até o próximo post!