O Claude Code coloca o modelo de IA mais capaz da Anthropic direto no seu terminal, para você escrever, editar, depurar e publicar código em português simples. Este artigo mostra a configuração, seus primeiros comandos de verdade, operações com arquivos, fluxos de trabalho com git e os atalhos de produtividade que realmente importam no dia a dia do desenvolvimento.
Se você passou o último ano vendo ferramentas de programação com IA se multiplicarem em cada IDE, extensão de navegador e painel SaaS, talvez esteja se perguntando qual delas realmente combina com o seu jeito de trabalhar. O Claude Code é a resposta da Anthropic para essa pergunta, e ele adota uma abordagem deliberadamente diferente: em vez de ficar numa barra lateral ou numa aba do navegador, roda diretamente dentro do seu terminal. Você digita. Ele responde. Ele lê seus arquivos. Escreve e edita código. Executa comandos. E faz tudo isso sem exigir que você saia do ambiente onde já faz o seu melhor trabalho.
Este artigo percorre os pré-requisitos, a instalação, seus primeiros comandos, fluxos de trabalho do dia a dia e as configurações que importam quando você vai além do básico.
No momento em que você executa claude no terminal, a experiência é diferente de uma interface de chat. O Claude Code é um assistente de programação agêntico: ele não se limita a responder perguntas, ele executa ações. Lê arquivos, escreve código, roda comandos de shell e percorre a estrutura do seu projeto com base em instruções em português simples.
A diferença importa por motivos concretos. Um chatbot entrega texto para você copiar e colar. O Claude Code abre o arquivo. Um chatbot perde o contexto quando você cola um trecho. O Claude Code lê toda a sua base de código e mantém tudo isso em contexto durante a sessão inteira. Um chatbot espera sua próxima mensagem. O Claude Code consegue encadear várias etapas: rodar um teste, ler a falha, corrigir o código e executar o teste de novo, em uma única operação contínua.
É isso que a Anthropic quer dizer com "agêntico": o modelo executa ações reais em um ambiente real, e não apenas gera texto para você colocar em prática manualmente.
O Claude Code tem acesso a tudo no diretório do seu projeto por padrão. Veja com o que ele trabalha:
O modelo que alimenta tudo isso é o próprio Claude. Se você quiser experimentar os recursos do Claude no navegador antes de levar prompts para o seu fluxo de trabalho no terminal, o PicassoIA dá acesso direto ao Claude Opus 4.7 e ao Claude 4 Sonnet.
O Claude Code roda sobre Node.js. Antes de qualquer coisa, verifique sua versão:
node --version
Você precisa de Node 18 ou superior. Se estiver usando uma versão mais antiga, atualize pelo nvm, pelo gerenciador de pacotes do seu sistema ou pelo instalador oficial em nodejs.org. O gerenciador de pacotes npm vem junto com o Node, então não é preciso nada extra para ele.
Aqui está uma referência rápida:
| Requisito | Versão mínima | Comando de verificação |
|---|---|---|
| Node.js | 18.x ou superior | node --version |
| npm | 8.x ou superior | npm --version |
| Acesso à API da Anthropic | Conta ativa | console.anthropic.com |
O Claude Code se conecta à API da Anthropic pela sua conta. Você vai precisar de uma credencial de API do Anthropic Console. Se você já usa a API do Claude em outro projeto, a mesma credencial funciona. Criar uma conta nova e gerar um token leva menos de cinco minutos.
💡 Nota de segurança: guarde sua credencial de API em uma variável de ambiente ou no chaveiro do sistema. Nunca a escreva diretamente em um arquivo de projeto nem a envie para o controle de versão. O Claude Code cuida do armazenamento seguro automaticamente depois da primeira etapa de autenticação.
A cobrança passa pela sua conta na Anthropic, com tarifas padrão de API, contabilizadas por token, da mesma forma que o uso direto da API. Para a maioria dos desenvolvedores que usam o Claude Code em trabalho diário de verdade, os custos ficam parecidos com uma assinatura SaaS de nível intermediário por mês, embora isso varie bastante conforme a frequência com que você roda sessões longas com vários arquivos.
Instale o Claude Code globalmente via npm:
npm install -g @anthropic-ai/claude-code
Essa é toda a instalação. Sem dependências adicionais, sem etapa de build, sem configuração de Docker. Quando a instalação terminar, o comando claude fica disponível em qualquer lugar do seu sistema.
Verifique se funcionou:
claude --version
Você deve ver uma string de versão na saída. Se o comando não for encontrado, verifique se o diretório de binários globais do npm está incluído no seu PATH. No macOS com nvm, geralmente é ~/.nvm/versions/node/<version>/bin. No Linux com uma instalação de sistema do Node, normalmente é /usr/local/bin ou /usr/bin.
Na primeira vez que você executar claude, ele vai guiá-lo por uma configuração única:
claude
Você será solicitado a colar sua credencial de API da Anthropic. O Claude Code a criptografa e armazena no armazenamento seguro do seu sistema, então você não precisará digitá-la de novo nas próximas sessões.
Depois da autenticação, você chega a um REPL interativo com um prompt e um cursor piscando. Pronto. A ferramenta está pronta para uso.
> _
Algumas flags que vale conhecer desde o início:
| Flag | Efeito |
|---|---|
--print | Saída única, sem modo interativo |
--help | Lista todas as opções disponíveis |
--version | Mostra a versão instalada |
--dangerously-skip-permissions | Aprova automaticamente todas as gravações de arquivos e comandos |
O ponto de partida mais natural é pedir ao Claude Code que crie algo novo. Entre em um diretório de projeto e abra uma sessão:
claude
Depois, digite seu pedido em português simples:
Create a Python script that reads a CSV file and outputs a statistical summary for each column.
O Claude Code escreve o script no seu diretório de trabalho, escolhe um nome de arquivo sensato, adiciona imports e tratamento de erros adequados e mostra exatamente o que produziu. Você não especificou nome de arquivo, assinaturas de funções nem formato de docstring. Ele inferiu tudo isso a partir do contexto e das convenções padrão do Python.
A natureza conversacional do Claude Code aparece com mais clareza quando você faz perguntas de acompanhamento:
Now add support for reading from multiple CSV files and merging them before generating the summary.
O Claude Code lê o arquivo que acabou de criar, interpreta a estrutura existente e o estende sem quebrar o que já funciona. Esse vaivém é o que o diferencia dos geradores de código de uma única tentativa: cada acompanhamento se apoia no estado real do seu projeto, e não em um trecho copiado e colado em uma janela de chat.
Em bases de código existentes, o fluxo também é direto. Abra uma sessão na raiz do projeto e descreva a mudança:
In src/api/users.js, the getUserById function makes two separate database calls when one would be sufficient. Fix it.
O Claude Code lê o arquivo, localiza a função, a reescreve e mostra um diff antes de fazer qualquer alteração. Você pode aprovar, rejeitar ou pedir outra abordagem. O ciclo de editar e depois confirmar mantém você no controle de cada modificação sem desacelerar o fluxo de trabalho.
Para mudanças mais amplas, você pode ser menos prescritivo sobre a implementação:
Refactor the authentication middleware in src/middleware/ to use async/await instead of callbacks.
O Claude Code percorre o diretório, lê todos os arquivos relevantes e aplica a refatoração de forma consistente em tudo, em uma única operação.
Uma grande vantagem em relação às ferramentas simples de autocompletar é a capacidade do Claude Code de trabalhar em vários arquivos em uma única sessão. Você pode pedir para ele:
O modelo mantém o contexto da sua base de código durante a sessão e raciocina explicitamente sobre as relações entre os arquivos. Ele não se limita ao que está aberto no seu editor, e não exige que você reúna e cole manualmente trechos relevantes de código em uma janela de chat.
O Claude Code se integra ao Git sem nenhuma configuração. Dentro de uma sessão, descreva sua intenção e deixe que ele cuide da parte mecânica do shell:
Commit the changes I just made with a meaningful commit message.
O Claude Code executa git diff --staged, lê o que mudou, escreve uma mensagem adequada com base no conteúdo real do diff e executa o commit. Ou:
Create a new branch for the payment refactor and push it to origin.
Criação de branch, checkout e push, tudo feito em sequência sem que você digite um único comando do Git.
💡 Dica: peça ao Claude Code para explicar o plano do Git antes de executar. Digite
explain what you're about to doantes de qualquer operação do Git para receber uma prévia, em português simples, dos comandos exatos que ele vai rodar.
Isso é especialmente útil para desenvolvedores que sabem exatamente o que querem fazer, mas às vezes precisam consultar a flag certa para um caso específico. O Claude Code já conhece todas elas.
Por padrão, o Claude Code pede sua confirmação antes de gravar arquivos ou executar comandos de shell. Toda ação potencialmente irreversível recebe um prompt de y/n antes de ser executada. Essa é a configuração certa para bases de código de produção e para qualquer projeto que você preze.
Quando você está prototipando rapidamente em um diretório descartável, pode pular esses prompts:
claude --dangerously-skip-permissions
Ou conceda aprovação automática para a sessão inteira a partir do próprio prompt interativo.
| Modo | Comportamento | Melhor para |
|---|---|---|
| Padrão | Confirma antes de todas as gravações e comandos | Código de produção, projetos reais |
| Aprovação automática | Executa imediatamente, sem prompts | Prototipagem, scripts descartáveis |
| Somente leitura | Sem gravação de arquivos nem execução de comandos | Revisão de código, sessões de perguntas e respostas |
Para o trabalho diário em projetos reais, o modo padrão é o correto. Os prompts de confirmação custam dois segundos e protegem você de sobrescritas acidentais ou de mudanças aplicadas no lugar errado.
Para prototipagem rápida em um diretório temporário, a aprovação automática acelera bastante a iteração. Você pode testar uma dúzia de variações de um script em minutos, sem interromper o fluxo criativo.
Para ler e revisar código desconhecido, vale usar o comportamento somente leitura de propósito. O Claude Code consegue ler uma base de código inteira, explicar como ela funciona, responder perguntas de arquitetura e rastrear fluxos de dados sem tocar em um único arquivo do seu repositório.
Quando um teste está falhando e o stack trace não é imediatamente óbvio, o ciclo de depuração do Claude Code reduz bastante o tempo até a solução:
The test suite is failing. Read the output in /tmp/test-results.log and identify the root cause.O Claude Code lê o log, percorre os arquivos de código relevantes e identifica o que está causando a falha. Na maioria dos casos, ele também propõe uma correção. Você aprova, o teste roda de novo e passa.
O que antes levava 30 minutos lendo stack traces, procurando a função relevante e rastreando cadeias de chamadas agora leva alguns minutos de conversa.
Antes de abrir um pull request, use o Claude Code como revisor de primeira passagem:
Review my changes in this branch compared to main. Focus on logic errors, missing error handling, and anything that would fail under edge cases.
O Claude Code executa git diff main, lê cada arquivo alterado e produz uma lista estruturada de problemas com referências específicas de linha. Ele não vai pegar tudo o que um revisor humano pegaria, mas costuma detectar os erros óbvios antes que sua equipe perca tempo com eles.
💡 Dica de prompt: peça para ele ser crítico. Experimente:
Assume this code will be reviewed by a senior engineer who values correctness and simplicity. Be specific about what is wrong and why.A qualidade do feedback melhora bastante com um enquadramento mais direcionado.
Para mudanças sistemáticas em uma base de código inteira, descreva a regra e deixe o Claude Code aplicá-la em escala:
We are renaming the User model to Account across the entire codebase. Update all references, including imports, variable names, type annotations, and database migration files.
O Claude Code analisa tudo, monta uma lista de mudanças, mostra o alcance do que vai modificar, espera sua confirmação e então executa. Uma renomeação que levaria 40 minutos de busca e substituição no editor pode terminar em menos de cinco minutos.
O mais importante ao formular pedidos de refatoração é a precisão sobre o escopo e a regra aplicada. Quanto mais exatamente você descrever o que muda e o que permanece igual, com mais precisão e consistência o Claude Code aplicará a mudança em milhares de linhas.
O Claude Code procura um arquivo CLAUDE.md na raiz do seu projeto no início de cada sessão. É ali que você guarda instruções específicas do projeto que devem valer para toda interação:
# MyProject
## Architecture
- Backend: Express.js with TypeScript
- Database: PostgreSQL via Prisma ORM
- Tests: Vitest, not Jest
## Conventions
- Use named exports, never default exports
- Error handling follows a Result type pattern, not try/catch
- All database calls go through the service layer, never directly in route handlers
Com um CLAUDE.md no lugar, você não precisa reexplicar as convenções do projeto no início de cada sessão. O Claude Code lê o arquivo automaticamente e aplica essas regras a todos os arquivos que escreve ou edita durante aquela sessão.
Esse é um dos investimentos de maior retorno que você pode fazer ao trabalhar com o Claude Code em um projeto real. Vinte linhas de contexto do projeto, escritas uma vez, melhoram a qualidade de todas as sessões seguintes. Usuários experientes do Claude Code mantêm seus arquivos CLAUDE.md da mesma forma que mantêm o README.md: atualizam sempre que as convenções mudam e tratam o arquivo como um documento vivo.
O Claude Code é alimentado pelos modelos Claude da Anthropic, a mesma arquitetura de IA criada para raciocínio complexo, análise de contexto longo e geração precisa de código. Se você quiser rascunhar e testar prompts no navegador, comparar as saídas dos modelos antes de escolher uma abordagem ou simplesmente rodar uma tarefa rápida sem abrir uma sessão de terminal, o PicassoIA dá acesso direto a toda a linha Claude, sem nenhuma configuração.
O Claude Opus 4.7 é a opção mais capaz para raciocínio pesado, planejamento de arquitetura e tarefas complexas com várias etapas. O Claude 4.5 Sonnet é o cavalo de batalha para programação e escrita do dia a dia, com um excelente equilíbrio entre velocidade e precisão. Para respostas rápidas e tarefas mais leves, o Claude 4.5 Haiku é a opção mais veloz da família Claude.
O PicassoIA também reúne a linha completa de modelos de IA de fronteira em um só lugar. O GPT-5 traz os recursos mais recentes de raciocínio e geração da OpenAI. O DeepSeek R1 oferece o desempenho de modelos de pesos abertos. O Gemini 2.5 Flash serve para tarefas multimodais rápidas. Tudo acessível por uma única interface, sem nenhuma configuração de API do seu lado.
Se você já usa o Claude Code todo dia no terminal, reserve quinze minutos no PicassoIA. Rascunhe seus prompts no navegador, teste como diferentes modelos respondem ao mesmo pedido e leve para as sessões do terminal o que funcionar. As duas ferramentas se complementam: uma para quando você está no meio de uma sessão de código com arquivos abertos, e outra para quando quer pensar em uma abordagem antes de se comprometer com ela.
Escolha seu idioma
