Claude Code CLI: Programação com IA · Capítulo 9 de 23 · 18 min
Ler, comparar e editar documentos com IA
Arquivos do seu computador lidos, comparados e editados pelo Claude, com o exemplo real do projeto Papers.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA.
Ler e editar arquivos no seu computador é o que o Claude Code faz de mais útil no dia a dia. Diferente de um chatbot no navegador, ele tem acesso real ao seu sistema de arquivos.
Para ler, peça ao Claude que abra o arquivo e explique
# Peça para ler um arquivo específico:
> Leia o arquivo geo_daily.py e me explique o que ele faz
# Peça para analisar a estrutura de um projeto:
> Liste todos os arquivos .py neste projeto e me diga o que cada um faz
# Peça para encontrar algo específico:
> Encontre onde está definida a função entity_checker neste projetoUm exemplo real ajuda. No projeto Papers da Brasil GEO, há scripts Python que coletam e analisam dados de pesquisa empírica. Imagine que você quer entender o que o script faz:
# Você entra na pasta do projeto:
cd C:/Sandyboxclaude/papers
claude
# E pede:
> Leia o arquivo principal do projeto e me explique:
> 1. Qual é o objetivo deste projeto?
> 2. Quais bibliotecas ele usa?
> 3. Como ele se conecta ao banco de dados?
> 4. Quais são as funções principais?Para editar, diga o que mudar
# Pedir para corrigir um erro:
> O script entity_checker.py está dando erro na conexão.
> Corrija o problema.
# Pedir para adicionar uma funcionalidade:
> Adicione uma função ao citation_monitor.py que gere
> um relatório em formato CSV com as citações dos últimos 30 dias.
# Pedir para refatorar (melhorar o código):
> Refatore a função de coleta de dados para usar async/await
> e tornar a execução mais rápida.Na edição, o Claude Code mexe no arquivo diretamente. Antes, mostra o que vai alterar (em formato diff, com linhas vermelhas para remoção e verdes para adição) e, se você tiver permissões configuradas, aplica a mudança automaticamente.
Em vez de pedir ao Claude para escrever o arquivo inteiro de novo, peça para editar apenas a parte necessária. É mais rápido e consome menos tokens. Por exemplo: "Na função process_data, troque o formato de saída de JSON para CSV" em vez de "Reescreva o arquivo inteiro".
Exemplo prático com o projeto Papers
# Cenário: você quer criar um novo relatório no projeto Papers
> Leia a estrutura do projeto e me diga quais relatórios já existem.
# Claude lê os arquivos e responde com a lista.
> Agora crie um novo script chamado relatorio_semanal.py que:
> 1. Leia os dados da tabela citations no banco SQLite
> 2. Filtre apenas os últimos 7 dias
> 3. Calcule a média de citações por plataforma
> 4. Salve o resultado em um arquivo relatorio.csv
> 5. Imprima um resumo no terminalA leitura de arquivos rende mais quando você aponta o Claude para uma pasta inteira e pede a comparação. Vários relatórios mensais viram uma leitura só, com a tendência e os alertas já destacados. Suponha uma clínica que salva um relatório de atendimentos por mês: apontado para a pasta, o Claude mostra numa tabela em que mês os retornos de pacientes caíram.
Faça o mesmo com a sua pasta de relatórios usando o pedido pronto abaixo e confira dois números da tabela contra o arquivo original. Se os dois baterem, você pode confiar na leitura comparada.
Crie um arquivo de teste, peça ao Claude Code para lê-lo e explicar o conteúdo. Depois, peça para fazer uma alteração específica e verifique se o arquivo foi modificado corretamente.
Perguntas frequentes deste capítulo
O Claude pode apagar ou estragar meu arquivo ao editar? Como me protejo?
Por que pedir para editar só a parte necessária em vez de reescrever o arquivo inteiro?
Dá para o Claude ler uma pasta inteira de relatórios e comparar de uma vez?
O Claude enxerga meus arquivos de verdade ou preciso colar o conteúdo no chat?
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- CursoSetup Completo: do zero ao Claude Code
- CursoAgentes de código para executivossugerido pelo grafo3 capítulos de “Claude Code CLI: Programação com IA” usam conceitos apresentados em “Agentes de código para executivos”.
- CursoMCP para quem decidesugerido pelo grafo7 capítulos de “Claude Code CLI: Programação com IA” usam conceitos apresentados em “MCP para quem decide”.
- CursoIA Local na Práticasugerido pelo grafo“IA Local na Prática” e “Claude Code CLI: Programação com IA” são da mesma trilha, tratam de assuntos próximos, e o primeiro é de nível inicial.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup Completo: do zero ao Claude CodeTrabalhe com o Claude Code dentro do VS CodeExaminar conexões de Trabalhe com o Claude Code dentro do VS Code
- VS Code: Do Zero ao Editor ProfissionalClaude Code: o que um líder faz sem programarExaminar conexões de Claude Code: o que um líder faz sem programar
- Segundo cérebro com IAEscrever um arquivo que todo assistente de IA entendeExaminar conexões de Escrever um arquivo que todo assistente de IA entende
- Setup de Vibecoding no MacCLAUDE.md — a memória do Claude sobre vocêExaminar conexões de CLAUDE.md — a memória do Claude sobre você
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.