Como Usar Claude Code no Terminal: Guia

O que e Claude Code e por que funciona no terminal

Claude Code e a ferramenta de linha de comando da Anthropic pra programar com IA direto no terminal. Sem interface grafica, sem editor visual, sem distracao. Voce abre o terminal, roda o comando, e ele entende seu projeto, le seus arquivos, faz alteracoes e ate executa scripts. Tudo na linha de comando.

Eu comecei a usar no final de 2025 e honestamente mudou minha rotina. Antes eu ficava alternando entre Cursor, terminal e browser o tempo todo. Agora eu abro o terminal, descrevo o que preciso, e ele resolve. A curva de aprendizado e menor do que parece.

A sacada do Claude Code e que ele nao e um autocomplete glorificado. Ele le o contexto do projeto inteiro, entende a arquitetura, e faz mudancas que fazem sentido dentro daquele ecossistema. Se voce pede pra criar um endpoint novo numa API Express, ele olha os endpoints existentes, segue o padrao, e cria consistente.

Diferenca entre Claude Code e editores com IA

Cursor, Copilot e Windsurf funcionam dentro de um editor. Voce ta codando, a IA sugere completions, voce aceita ou rejeita. E reativo. Claude Code e o oposto: voce descreve uma tarefa completa e ele executa do inicio ao fim. E mais proativo.

Requisitos e instalacao

Pra instalar o Claude Code voce precisa de Node.js 18+ e uma chave de API da Anthropic. A instalacao e um comando so.

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

# Verificar instalacao
claude --version

# Primeira execucao - vai pedir a chave de API
claude

Na primeira execucao ele pede pra autenticar. Voce pode usar a chave de API direto ou logar pela conta da Anthropic. Depois disso, e so navegar ate a pasta do seu projeto e rodar claude. Ele detecta a estrutura automaticamente.

Setup completo em 10 minutos

Instalar e so o comeco. O que realmente faz o Claude Code funcionar bem e o setup do projeto. E aqui que a maioria das pessoas erra: comecam a usar sem configurar nada e reclamam que as respostas sao genericas. Obvio que sao, voce nao deu contexto nenhum.

Configuracao do CLAUDE.md no projeto

O CLAUDE.md e um arquivo Markdown que voce coloca na raiz do projeto. O Claude Code le esse arquivo automaticamente toda vez que voce inicia uma sessao. E como um briefing permanente. Voce coloca ali as regras do projeto, padroes de codigo, stack, convencoes de nomenclatura, tudo.

# Projeto: Minha API

## Stack
- Node.js 20 + TypeScript 5.4
- Express com rotas organizadas por dominio
- Prisma ORM + PostgreSQL
- Jest para testes

## Convencoes
- Usar camelCase para variaveis e funcoes
- Nomes de arquivos em kebab-case
- Handlers sempre retornam tipos tipados
- Nunca usar any

## Estrutura
- src/routes/ - Rotas por dominio
- src/services/ - Logica de negocio
- src/repositories/ - Acesso a dados
- src/middleware/ - Middlewares Express

Quanto mais especifico o CLAUDE.md, melhor o resultado. Eu coloco ate exemplos de como quero que o codigo fique. Tipo: 'quando criar um endpoint novo, siga esse template'. Funciona demais.

Permissoes e seguranca

O Claude Code pede permissao antes de fazer alteracoes no filesystem. Por padrao, ele opera em modo interativo: mostra o que vai fazer e espera voce aprovar. Dá pra configurar uma lista de permissoes no CLAUDE.md pra agilizar, tipo: 'pode editar qualquer arquivo em src/, pode rodar npm test, pode fazer git add e git commit'.

10 comandos que voce vai usar todo dia

Depois de meses usando Claude Code, esses sao os comandos que mais rodo. Nao sao comandos do CLI em si, sao prompts que viram parte da minha rotina. Copie e adapte pro seu projeto.

Refatoracao em massa

Esse e o caso de uso onde o Claude Code brilha mais que qualquer outro. Imagina que voce precisa trocar todas as chamadas de uma funcao deprecated por uma nova versao em 30 arquivos. No editor, voce faria find and replace e rezava pra nao quebrar nada. Com Claude Code, voce descreve a mudanca e ele entende o contexto de cada uso.

# Exemplo real: migrar de dayjs pra date-fns em todo o projeto
claude "Migre todas as importacoes e usos de dayjs para date-fns.
Mantenha o mesmo comportamento. Atualize os testes tambem.
Nao esqueca de remover dayjs do package.json."

Ele vai ler todos os arquivos que importam dayjs, entender como cada funcao esta sendo usada, mapear o equivalente em date-fns, fazer a troca, e ainda ajustar os testes. Numa refatoracao dessas, que manualmente levaria um dia inteiro, ele resolve em minutos.

Geracao de testes

Outro uso que virou parte da minha rotina. Eu termino de codar um servico, abro o terminal e peco pro Claude Code gerar os testes. Ele olha a implementacao, identifica os edge cases, e cria testes que realmente testam algo util. Nao sao aqueles testes inuteis que so verificam se a funcao existe.

claude "Crie testes unitarios para src/services/payment-service.ts.
Cubra: cenarios de sucesso, falha de pagamento, timeout,
valores invalidos e limites. Use Jest + mocks para dependencias externas.
Siga o padrao dos testes existentes em __tests__/."

Code review automatico

Antes de abrir PR, eu rodo um code review com Claude Code. Ele analisa o diff, aponta problemas de seguranca, performance, tipagem e legibilidade. Nao substitui review humano em 100% dos casos, mas pega muita coisa que passaria batido numa revisao rapida. Mais pra frente vou mostrar como automatizar isso com Git hooks.

Integracoes avancadas: Git hooks e CI/CD

Aqui e onde a coisa fica realmente interessante. Claude Code no terminal significa que voce pode chamar ele de qualquer script. Git hooks, GitHub Actions, scripts de deploy. Qualquer lugar que roda shell pode usar Claude Code.

Meu setup favorito e um pre-commit hook que roda review automatico. Toda vez que eu faco git commit, o hook pega o diff, passa pro Claude Code, e se ele encontrar algo critico, bloqueia o commit. Parece exagero, mas ja me salvou de subir segredo hardcoded e SQL injection.

#!/bin/bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)

if [ -z "$DIFF" ]; then
  exit 0
fi

RESULT=$(echo "$DIFF" | claude --print \
  "Analise este diff e responda APENAS com OK ou PROBLEMA: [descricao].
   Verifique: segredos expostos, SQL injection, imports faltando,
   console.log esquecido em producao.")

if echo "$RESULT" | grep -q "PROBLEMA"; then
  echo "Code review encontrou problemas:"
  echo "$RESULT"
  exit 1
fi

exit 0

Pra CI/CD, a logica e parecida. No GitHub Actions voce pode rodar Claude Code como step pra revisar PRs automaticamente, gerar changelogs, ou validar que o codigo segue os padroes do time.

# .github/workflows/ai-review.yml
name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Run AI Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          DIFF=$(git diff origin/main...HEAD)
          claude --print "Faca code review deste diff. Formato: markdown com categorias (seguranca, performance, legibilidade). $DIFF"

Claude Code vs Cursor vs Copilot: quando usar cada um

Essa e a pergunta que mais recebo. A resposta curta: depende da tarefa. A resposta longa e que eu uso os tres, em momentos diferentes.

Claude Code e imbativel pra tarefas que envolvem multiplos arquivos, refatoracao, geracao de testes e automacoes. Cursor e melhor pra edicao visual e explorar codigo novo. Copilot e bom pra autocomplete rapido enquanto voce ta no flow.

No meu dia a dia, eu comeco o dia com Claude Code fazendo as tarefas pesadas: testes que estao faltando, refatoracoes planejadas, code reviews de PRs. Depois mudo pro Cursor pra codar features novas de forma mais interativa. E o Copilot fica ligado o tempo todo fazendo autocomplete.

Dicas que eu queria ter recebido no dia 1

Depois de meses usando, juntei uma lista de coisas que teriam acelerado muito meu aprendizado. Compartilho aqui pra voce nao passar pelas mesmas dores.

Erros comuns que travam iniciantes

O erro numero um e prompt vago. Se voce escreve 'arruma esse bug', sem dizer qual bug, qual o comportamento esperado, qual o stack trace, o resultado vai ser fraco. Trate o Claude Code como um dev junior muito rapido: ele precisa de contexto claro.

Outro erro classico e nao usar o CLAUDE.md. Eu ja vi gente reclamando que o Claude Code gera codigo em JavaScript quando o projeto e TypeScript. Bastava ter colocado 'TypeScript strict' no CLAUDE.md.

O terceiro erro e aceitar tudo sem revisar. A IA e boa, mas nao e perfeita. Sempre leia o diff antes de commitar. Um git diff rapido antes do commit salva muita dor de cabeca.

Meu workflow diario com Claude Code

Pra fechar, vou mostrar como e um dia tipico meu usando Claude Code. Nao e nada mirabolante, e uma rotina que qualquer dev pode adotar.

Esse fluxo me economiza umas 2-3 horas por dia em comparacao com codar tudo manualmente. Nao e magica, e que as tarefas repetitivas e mecanicas sao delegadas pra IA enquanto eu foco nas decisoes de arquitetura e logica de negocio.