Alexandre Caramaschi

doi:10.2139/ssrn.6460680

Claude Code CLI: Programação com IA · Capítulo 9 de 23 · 18 min

Ler, comparar e editar documentos com IA

Veja como o Claude Code lê, analisa e edita arquivos do seu projeto -- com exemplo real do projeto Papers.

Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.

Conceito

Uma das funcionalidades mais poderosas do Claude Code é ler e editar arquivos no seu computador. Diferente de um chatbot no navegador, ele tem acesso real ao seu sistema de arquivos.

Leitura de arquivos -- peça ao Claude para ler e explicar

text

# 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 projeto

Vamos usar um exemplo real. No projeto Papers da Brasil GEO, temos scripts Python que coletam e analisam dados de pesquisa empírica. Imagine que você quer entender o que o script faz:

text

# 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?

Edição de arquivos -- peça ao Claude para modificar

text

# 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.

O Claude Code edita os arquivos diretamente. Ele 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.

Na prática

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

text

# 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 terminal

A 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.

PromptComparativo de relatórios mensais com tendências e alertas

PAPEL E CONTEXTO
Você é um analista que lê relatórios mensais e transforma a pilha em uma leitura única, com tendências e alertas. Escreve em português do Brasil, para quem decide e não tem tempo de abrir arquivo por arquivo.

DADOS DE ENTRADA
A pasta [caminho da pasta de relatórios] contém os relatórios mensais dos últimos [número] meses, em PDF, Word ou planilha, um por mês.

TAREFA
1. Leia todos os relatórios e identifique os indicadores que aparecem em todos os meses.
2. Monte a série de cada indicador mês a mês e calcule a variação em relação ao mês anterior.
3. Aponte as tendências de alta e de queda que se sustentam por dois meses ou mais.
4. Levante os alertas: quedas fortes, números fora do padrão e indicadores que sumiram de um mês para o outro.

FORMATO DE SAÍDA
Uma tabela com os indicadores nas linhas e os meses nas colunas, seguida de dois blocos em tópicos: tendências e alertas. Feche com três recomendações.

CRITÉRIOS
- Não compare indicadores com nomes ou unidades diferentes como se fossem o mesmo; se a nomenclatura variar entre meses, pergunte antes de unificar.
- Liste os meses ou arquivos que você não conseguiu ler e por quê.
- Registre o que você assumiu ao interpretar um indicador ambíguo.

Checkpoint

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?

Antes de aplicar qualquer mudança, ele mostra um diff, com o vermelho indicando o que sai e o verde o que entra, e a alteração só ocorre depois que você aceita. Leia esse diff como leria um controle de alterações no Word: se algo parecer errado, recuse. E se uma edição já aplicada não ficou boa, o /rewind devolve o código ao ponto anterior sem depender do Git.

Por que pedir para editar só a parte necessária em vez de reescrever o arquivo inteiro?

Porque é mais rápido, gasta menos tokens e fica muito mais fácil de revisar. Quando você pede 'altere apenas a cláusula de prazo', o diff sai curto e você confere num relance; quando ele reescreve tudo, você precisa reler o documento inteiro para ter certeza de que nada se perdeu no caminho. Peça edições cirúrgicas sempre que o resto do arquivo já estiver bom.

Dá para o Claude ler uma pasta inteira de relatórios e comparar de uma vez?

Dá. Ele tem acesso real ao sistema de arquivos, então você pode apontar uma pasta com vários documentos e pedir 'leia estes três relatórios e monte uma tabela com as diferenças de número entre eles'. Funciona bem para comparar versões de uma proposta, planilhas exportadas em texto ou fechamentos mensais. Deixe os arquivos na pasta do projeto e diga com clareza o que quer comparar.

O Claude enxerga meus arquivos de verdade ou preciso colar o conteúdo no chat?

Ele enxerga de verdade. Como tem acesso ao sistema de arquivos da pasta onde você rodou o comando, basta citar o nome do arquivo e pedir para ler, explicar ou editar, sem colar nada. Isso muda o jeito de trabalhar: em vez de copiar trechos soltos, você conversa sobre os documentos que já estão no seu computador.

Claude Code CLI: Programação com IA · Capítulo 9 de 23 · 18 min

Ler, comparar e editar documentos com IA

Veja como o Claude Code lê, analisa e edita arquivos do seu projeto -- com exemplo real do projeto Papers.

Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.

Conceito

Uma das funcionalidades mais poderosas do Claude Code é ler e editar arquivos no seu computador. Diferente de um chatbot no navegador, ele tem acesso real ao seu sistema de arquivos.

Leitura de arquivos -- peça ao Claude para ler e explicar

text

# 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 projeto

Vamos usar um exemplo real. No projeto Papers da Brasil GEO, temos scripts Python que coletam e analisam dados de pesquisa empírica. Imagine que você quer entender o que o script faz:

text

# 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?

Edição de arquivos -- peça ao Claude para modificar

text

# 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 prática

Exemplo prático com o projeto Papers

text

# 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 terminal

PromptComparativo de relatórios mensais com tendências e alertas

PAPEL E CONTEXTO
Você é um analista que lê relatórios mensais e transforma a pilha em uma leitura única, com tendências e alertas. Escreve em português do Brasil, para quem decide e não tem tempo de abrir arquivo por arquivo.

DADOS DE ENTRADA
A pasta [caminho da pasta de relatórios] contém os relatórios mensais dos últimos [número] meses, em PDF, Word ou planilha, um por mês.

TAREFA
1. Leia todos os relatórios e identifique os indicadores que aparecem em todos os meses.
2. Monte a série de cada indicador mês a mês e calcule a variação em relação ao mês anterior.
3. Aponte as tendências de alta e de queda que se sustentam por dois meses ou mais.
4. Levante os alertas: quedas fortes, números fora do padrão e indicadores que sumiram de um mês para o outro.

FORMATO DE SAÍDA
Uma tabela com os indicadores nas linhas e os meses nas colunas, seguida de dois blocos em tópicos: tendências e alertas. Feche com três recomendações.

CRITÉRIOS
- Não compare indicadores com nomes ou unidades diferentes como se fossem o mesmo; se a nomenclatura variar entre meses, pergunte antes de unificar.
- Liste os meses ou arquivos que você não conseguiu ler e por quê.
- Registre o que você assumiu ao interpretar um indicador ambíguo.

Checkpoint

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?

Ler, comparar e editar documentos com IA

Leitura de arquivos -- peça ao Claude para ler e explicar

Edição de arquivos -- peça ao Claude para modificar

Exemplo prático com o projeto Papers

Perguntas frequentes deste capítulo

Privacidade e cookies

Ler, comparar e editar documentos com IA

Leitura de arquivos -- peça ao Claude para ler e explicar

Edição de arquivos -- peça ao Claude para modificar

Exemplo prático com o projeto Papers

Perguntas frequentes deste capítulo

Privacidade e cookies