Você provavelmente já passou por isso: abre o Claude ou o ChatGPT, cola um trecho de código, pede uma alteração, copia a resposta, volta pro editor, cola, percebe que o contexto tá incompleto, volta pro chat, manda mais um arquivo, e assim por diante. Funciona. Mas é lento e manual — você ainda faz o trabalho de integração.

Claude Code existe pra eliminar esse ciclo.

O que é Claude Code, afinal

Claude Code é um agente de IA da Anthropic que roda direto no terminal. Ele não vive numa janela de chat: você navega até a pasta do seu projeto, digita claude, e ele lê seus arquivos, entende a estrutura e começa a agir.

A distinção que importa é entre assistente e agente.

Um assistente (Copilot Chat, ChatGPT, Claude.ai) responde perguntas. Você pergunta, ele gera uma resposta no painel. Você aplica manualmente o que ele sugeriu.

Um agente age. Claude Code lê seu Program.cs, entende que é uma API ASP.NET Core, identifica que você quer um endpoint novo, e edita o arquivo diretamente. Cria os testes. Roda o dotnet build pra ver se compila. Corrige o que quebrou. Tudo sem você ficar copiando e colando entre janelas.

Mas olha: não é mágica. Ele erra quando o contexto é ambíguo ou quando o projeto é complexo demais. Falo mais sobre isso no final.

A documentação oficial fica em docs.anthropic.com/pt/docs/claude-code. Vale ler quando você já tiver os primeiros usos no currículo.

Como instalar o Claude Code

Você precisa do Node.js 18 ou superior. Com ele instalado, um comando resolve:

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

O executável claude fica disponível globalmente depois disso.

Na primeira execução, ele vai pedir autenticação na conta da Anthropic via browser. Se preferir usar uma chave de API diretamente:

export ANTHROPIC_API_KEY="sk-ant-..."

Coloque essa linha no .bashrc ou .zshrc pra não precisar repetir toda vez.

Planos e custo real (2026)

O ponto que a galera aprende na prática: em projetos com muitos arquivos, o consumo de tokens cresce rápido. Cada sessão do Claude Code envia o contexto do projeto pra API. Quanto mais arquivos ele lê, mais token gasta. A comunidade BR já debateu isso no TabNews, inclusive com técnicas pra economizar tokens.

Se você vai usar diariamente, o Pro com limite mensal é mais previsível. Se é uso esporádico, créditos de API dão mais controle.

Primeiros comandos no projeto C# .NET

Abre o terminal na raiz do projeto e digita:

claude

Você vai ver um prompt interativo. A partir daí, escreve em português mesmo.

Criar um endpoint do zero

cria um endpoint GET /produtos que retorna uma lista de produtos do banco via Entity Framework.
O DbContext já existe no projeto, chama ProdutoDbContext.

O que Claude Code vai fazer:

1. Ler os arquivos do projeto pra entender a estrutura
2. Localizar o ProdutoDbContext e ver quais entidades ele expõe
3. Criar o controller com o endpoint correto
4. Ajustar o Program.cs se precisar registrar a rota ou injeção de dependência

Sem você abrir o editor.

Escrever testes xUnit

escreve testes xUnit pro ProdutosController.
cobre os casos: lista vazia, lista com itens, e produto não encontrado (404).

Ele vai gerar testes realistas, com Moq ou FakeItEasy dependendo do que estiver instalado no projeto, com nomes descritivos, sem inventar comportamentos que não existem no código.

Refatorar um método longo

Cole o método direto no chat, ou aponte o arquivo:

o método ProcessarPedido em Services/PedidoService.cs está muito longo.
extrai a validação pra um método separado e cria uma interface IValidadorPedido.

Ele vai editar o arquivo, criar a interface, e ajustar as injeções. Você revisa o diff antes de aceitar. Claude Code sempre pede confirmação antes de gravar alterações.

Esses três casos cobrem boa parte do uso diário. A partir daí, você vai descobrindo o resto naturalmente.

CLAUDE.md: o arquivo que transforma o agente

Quando você roda claude num projeto pela primeira vez, ele não sabe nada além do que os arquivos mostram. Não conhece suas convenções de nomenclatura, a arquitetura que você escolheu, o que não deve ser mexido.

O arquivo CLAUDE.md na raiz do projeto resolve isso. Tudo que você colocar ali vira instrução permanente pra todas as sessões.

Exemplo pra um projeto real:

# Contexto do projeto

API ASP.NET Core 8 com arquitetura Clean (camadas Domain, Application, Infrastructure, API).
Banco de dados: PostgreSQL via Entity Framework Core.

## Convenções
- Nomes de variáveis em português (padrão do time legado)
- Testes com xUnit + Moq
- Sem comentários em código. O nome do método já explica.
- Migrations via EF Core, nunca script SQL manual

## Restrições
- Não instalar pacotes sem confirmar comigo primeiro
- Não modificar arquivos em /scripts sem perguntar
- Endpoints novos sempre com versionamento (/api/v1/...)

A partir daí, Claude Code vai respeitar essas regras em toda sessão sem você precisar repetir. E quanto melhor você escrever esse contexto, menos ele vai errar.

Isso é o começo do que se chama context engineering. Se você quer ir fundo nesse assunto, estruturando prompts e contextos pra extrair o máximo de ferramentas como Claude Code, temos um curso de Engenharia de Prompt que cobre exatamente isso.

Quando usar Claude Code (e quando não usar)

Claude Code não substitui julgamento técnico. Ele erra. E quando erra em silêncio, gerando código que compila mas faz a coisa errada, o erro é difícil de pegar sem testes.

Casos onde ele brilha:

• Tarefas repetitivas com padrão claro: criar 5 endpoints seguindo o mesmo contrato, gerar DTOs, escrever migrations
• Scaffold rápido pra você ajustar: estrutura inicial de uma feature, arquivos de configuração, setup de testes
• Code review informal: "tem algum problema óbvio nesse método?"
• Refatoração localizada: extrair método, renomear com consistência, adicionar tratamento de erro

Onde você deve ter cuidado:

• Decisões de arquitetura que você mesmo ainda não tem clareza sobre. Se você não sabe o que quer, ele não vai saber também.
• Código que vai pra produção sem revisão humana. Sempre revise os diffs antes de aceitar.
• Projetos sem testes: você perde a capacidade de verificar se ele quebrou algo silenciosamente.

Na prática, a combinação mais produtiva é: Claude Code faz o trabalho pesado, você revisa e decide o que aceita. É uma ferramenta de aceleração pra quem já tem contexto técnico, não um substituto pra ele.

Se você ainda não tem a base em C# e quer entender se essa linguagem faz sentido antes de investir em ferramentas de produtividade, o guia completo sobre o que é C# e por que aprender é o lugar certo pra começar. E se a dúvida é Claude Code vs GitHub Copilot, qual deles faz mais sentido pro seu workflow diário em .NET, tem um comparativo direto entre os dois com análise de custo e casos de uso.