Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Claude Code

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Claude Code é o agente de programação de linha de comando que lê e edita o repositório, executa comandos e conduz tarefas de código inteiras a partir de instrução em linguagem natural.

Um modelo de linguagem sozinho só recebe texto e devolve texto: não lê arquivo, não escreve arquivo, não roda comando. O Claude Code é a camada que dá esse poder ao modelo. Ele lê os arquivos do projeto, envia ao modelo o que importa, recebe a resposta e a transforma em edições e comandos. Por isso é o exemplo de referência de harness: mesmo sem nenhuma configuração extra, programar com ele já é programar com um harness mínimo, e cada arquivo de contexto, agente, skill ou hook acrescentado estreita o caminho que o modelo pode seguir.

A ferramenta é proprietária da Anthropic, trabalha com a família de modelos Claude e tem suporte formal, ao contrário de alternativas abertas que dependem da comunidade.

Como o contexto de uma sessão é montado

O ponto de partida é o CLAUDE.md, arquivo padrão enviado junto em toda chamada, mesmo numa mensagem simples. Ele descreve o que o projeto é e o que não é, e aponta para arquivos de contexto mais específicos, como convenções de código e a stack obrigatória. Ao redor dele fica a pasta de configuração da ferramenta, que existe em dois níveis: a do projeto, válida só ali, e a global, na pasta do usuário, reutilizável em qualquer repositório. Nos dois níveis ficam comandos, skills, definições de agentes e o arquivo de settings onde se registram os hooks. Ao digitar uma barra no terminal, a lista de comandos junta os arquivos locais e os globais.

Os recursos que estendem esse núcleo têm notas próprias: Subagentes para delegar partes do trabalho em paralelo, Agent Teams para agentes que conversam entre si, Skills de IA para ensinar procedimentos e Hooks de Verificação em Agentes de Código para regras que o agente não consegue ignorar.

Terminal, extensão e perguntas durante a execução

O terminal é a interface mais completa: mostra cada subagente como um indicador separado. A extensão para editor facilita escolher o modelo, mas esconde a execução paralela. O terminal não fica bloqueado enquanto o agente trabalha: o comando /btw permite perguntar algo no meio de uma implementação, como quantas tarefas já terminaram ou quantos testes faltam, sem abrir outra sessão. O comando /model troca o modelo na mesma conversa.

Limites de uso e escolha de modelo por etapa

Na assinatura, o consumo é medido em duas janelas: uma que reseta a cada 5 horas e pode chegar a 100% antes de voltar a zero, e uma semanal, que limita o total da semana. A ferramenta mostra o custo estimado em dólares de cada geração e a porcentagem já consumida das duas janelas. As ordens de grandeza ajudam a planejar: gerar cinco specs de um protótipo custou pouco mais de um dólar e 11% da janela de 5 horas; uma única análise de um projeto grande com o modelo mais caro esgotou uma janela inteira; um dia de uso intenso desse modelo passou de 100 dólares.

Daí sai uma decisão por etapa. O modelo mais capaz, e mais caro, fica com a escrita das specs, porque specs melhores produzem um harness e um código melhores. A implementação, que gera muito mais volume, roda num modelo de custo menor e ainda forte em código. Com specs e tarefas registradas em arquivo, uma janela que acaba no meio do trabalho não perde o fio: a implementação retoma do ponto em que parou quando a cota renova.

Contexto também custa

Todo contexto injetado automaticamente ocupa janela: um hook que junta design, esquema do banco e estado do git no início da sessão melhora as respostas, mas consome mais. No extremo, uma aplicação legada que gerava cerca de 10 milhões de tokens de entrada para uns 100 mil de saída precisou ser quebrada em componentes menores para que usar IA nela continuasse viável.

O detalhamento dessas métricas, e como levá-las a um painel, está em Telemetria de Uso e Custo do Claude Code.