Claude Code: como instalar e começar a usar

4.2 Context Window

A context window (janela de contexto) é a quantidade de texto que o modelo consegue “ver” de uma vez — incluindo o histórico da conversa, os arquivos lidos e o código gerado. Quando a janela de contexto fica cheia, o agente começa a “esquecer” o início da conversa.

Os modelos Claude atuais suportam até 200.000 tokens de contexto — o equivalente a cerca de 150.000 palavras ou um projeto com muitos arquivos abertos simultaneamente.

Na prática, para projetos de análise econômica:

• Um script R de 500 linhas ocupa aproximadamente 3.000–5.000 tokens
• Uma sessão longa de debugging pode consumir 20.000–50.000 tokens
• Projetos com muitos arquivos abertos via @-mentions enchem o contexto mais rápido

Sinais de que o contexto está se esgotando:

• O agente começa a repetir informações ou perder o fio do raciocínio
• Respostas ficam menos precisas sobre arquivos discutidos no início da sessão

Como gerenciar:

• Use /compact para compactar o histórico sem perder o contexto essencial
• Use /clear para iniciar uma nova sessão quando mudar de tarefa
• Seja cirúrgico com @-mentions — inclua apenas os arquivos realmente necessários

4.3 Modos de operação

O Claude Code possui diferentes modos que controlam como o agente age antes de executar tarefas. Compreendê-los é essencial para trabalhar com segurança e eficiência.

"Antes de fazer qualquer alteração, me mostre um plano detalhado do que você pretende fazer."

5.1 O que é e por que ele é essencial

Claude Code não mantém memória entre sessões. Cada vez que você inicia uma nova conversa, o agente parte do zero. O arquivo CLAUDE.md resolve esse problema: ele é um documento Markdown na raiz do seu projeto que o Claude Code lê automaticamente no início de cada sessão.

Pense no CLAUDE.md como um briefing que você entrega a um novo assistente no primeiro dia de trabalho. Ele contém tudo que o agente precisa saber sobre o projeto, suas preferências e as regras que deve seguir.

Caso você não tenha um CLAUDE.md na sessão, mas já possui arquivos e estrutura de projeto, você pode usar /init para que o agente crie um CLAUDE.md inicial baseado no que ele consegue inferir do projeto. Depois, você pode editar e expandir esse arquivo para torná-lo mais completo.

Se você estiver usando o Claude Code em uma sessão do VS Code, que já tenha o arquivo CLAUDE.md, o comando /memory abre o arquivo para edição rápida. O agente pode criar ou atualizar esse arquivo para você — basta pedir.

5.2 O que incluir

Um bom CLAUDE.md deve conter:

• Descrição do projeto — o que o projeto faz, qual seu objetivo
• Estrutura de diretórios — onde ficam dados, scripts, saídas
• Tecnologias e dependências — linguagens, pacotes, versões
• Convenções de código — estilo, idioma de variáveis, padrões de nomenclatura
• Comandos frequentes — como rodar, testar, compilar
• Regras e restrições — o que o agente nunca deve fazer

5.3 Exemplo completo para um projeto de economia

# CLAUDE.md — Projeto Análise IPCA

Relatório em Quarto (.qmd) com uma síntese do IPCA no Brasil, seguindo as diretrizes do projeto:

### Contexto do projetos
- Projeto de análise macroeconômica com dados públicos (BCB, IBGE);
- Organização baseada em scripts R para coleta, tratamento e visualização;
- Saídas devem ser reprodutíveis e salvas na pasta `output/`.

### Tecnologias
- Linguagem: R
- Pacotes: tidyverse, ggplot2, GetBCBData ou rbcb, sidrar
- Série 433 (IPCA Var. % Mensal no SGS); Série 13521 (Meta para a inflação % Per. Anual; Tabela 7060 (IPCA Mensal por grupos no SIDRA)
- Formato do relatório: Quarto (.qmd)

### Convenções
- Usar nomes em snake_case;
- Comentários e textos em português;
- Gráficos com título, subtítulo e fonte;
- Código organizado e legível, com etapas claras (coleta, transformação, visualização).

### O que o relatório deve conter
- Download dos dados do IPCA (índice cheio e grupos);
- Gráfico da variação mensal;
- Gráfico da inflação acumulada em 12 meses com meta e bandas a partir de 2018;
- Gráfico sazonal por ano (x = mês, y = IPCA mensal), incluindo média histórica;
- Gráfico de contribuição dos grupos do IPCA (Mensal);
- Breve interpretação dos resultados ao longo do relatório.

### Saída
- Salvar como `output/ipca_relatorio.qmd`.