📄 Sintaxe e Parametros
A ferramenta Read e o ponto de entrada para qualquer informacao do sistema de arquivos. Ela le arquivos do disco local e os apresenta com numeros de linha no formato cat -n.
📋 Parametros da Ferramenta Read
| Parametro | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
| file_path | string | Sim | Caminho absoluto do arquivo |
| offset | number | Nao | Linha inicial (base 1) |
| limit | number | Nao | Numero de linhas a ler |
Exemplo de Uso
# Ler arquivo inteiro
Read(file_path="/home/user/projeto/src/main.py")
# Ler apenas linhas 50-100
Read(file_path="/home/user/projeto/src/main.py", offset=50, limit=50)
# Ler ultimas 20 linhas de um log
Read(file_path="/var/log/app.log", offset=980, limit=20)
💡 Dica Pratica
Por padrao, Read le ate 2000 linhas e trunca linhas maiores que 2000 caracteres. Para arquivos grandes, sempre use offset e limit para economizar contexto.
🖼️ Leitura de Imagens
Claude Code e multimodal - pode ler e interpretar imagens diretamente. Isso abre possibilidades incriveis para analise visual, debug de UI e mais.
📸 Formatos Suportados
Casos de Uso Praticos
- ✓ Analisar screenshots de erros
- ✓ Interpretar diagramas de arquitetura
- ✓ Comparar mockups com implementacao
- ✓ Extrair texto de imagens (OCR)
Exemplo
# Analisar screenshot de erro
Read(file_path="/tmp/screenshot.png")
Claude vai descrever o que ve na imagem e pode identificar erros, textos e elementos visuais.
📑 Leitura de PDFs
Read processa documentos PDF pagina por pagina, extraindo tanto texto quanto analisando conteudo visual como graficos e tabelas.
📄 Capacidades com PDFs
- • Extracao de texto: Todo texto do PDF e extraido e apresentado
- • Analise visual: Graficos, tabelas e imagens sao interpretados
- • Navegacao por pagina: Cada pagina e processada sequencialmente
- • Documentacao tecnica: Ideal para specs, manuais e relatorios
💡 Dica Pratica
PDFs grandes consomem muito contexto. Se voce so precisa de informacoes especificas, considere perguntar sobre partes especificas do documento em vez de pedir uma analise completa.
📓 Jupyter Notebooks
Arquivos .ipynb sao tratados de forma especial. Read mostra todas as celulas com seus outputs, combinando codigo, texto e visualizacoes.
O que Read mostra em notebooks
Celulas de Codigo
Codigo Python/R com syntax highlighting
Celulas Markdown
Texto formatado, titulos e explicacoes
Outputs
Resultados, graficos e tabelas
🔧 Editando Notebooks
Para editar notebooks, use a ferramenta NotebookEdit em vez de Edit. Ela permite modificar celulas especificas por ID ou indice.
NotebookEdit(notebook_path="/projeto/analise.ipynb", cell_id="abc123", new_source="print('novo codigo')")
⚡ Otimizacao de Contexto
Cada arquivo lido consome tokens do seu contexto. Estrategias inteligentes de leitura podem economizar muito espaco para tarefas mais complexas.
✓ Boas Praticas
- ✓ Use offset/limit para arquivos grandes
- ✓ Faca leituras paralelas quando possivel
- ✓ Leia apenas arquivos relevantes
- ✓ Use Grep primeiro para localizar trechos
✗ Evite
- ✗ Ler arquivos inteiros desnecessariamente
- ✗ Ler varios arquivos que nao serao usados
- ✗ Reler o mesmo arquivo multiplas vezes
- ✗ Ignorar limites de contexto
Estrategia: Grep + Read
# 1. Primeiro, encontre onde esta o que procura
Grep(pattern="def calcular_total", path="/projeto/src")
# 2. Depois, leia apenas o trecho relevante
Read(file_path="/projeto/src/vendas.py", offset=145, limit=30)
⚠️ Erros Comuns
Conhecer os erros mais frequentes com Read acelera a depuracao e evita frustracao durante o desenvolvimento.
Caminhos Relativos
Erro: usar "./arquivo.py" em vez de caminho absoluto
# ERRADO
Read(file_path="./src/main.py")
# CORRETO
Read(file_path="/home/user/projeto/src/main.py")
Tentar Ler Diretorios
Read so funciona com arquivos, nao diretorios
# ERRADO - Read nao le diretorios
Read(file_path="/home/user/projeto/src/")
# CORRETO - use Bash com ls ou Glob
Bash(command="ls /home/user/projeto/src/")
Arquivo Inexistente
Tentar ler arquivo que nao existe retorna erro
Sempre verifique se o caminho esta correto. Use Glob
para encontrar arquivos se nao souber o caminho exato.
💡 Lembrete Importante
Read deve ser usado pelo menos uma vez antes de editar qualquer arquivo com Edit ou Write. O sistema exige que voce leia o arquivo primeiro para garantir que sabe o que esta modificando.
📋 Resumo do Modulo
Proximo Modulo:
2.2 - Write e Edit: Criacao e Edicao de Codigo - quando usar cada ferramenta e como evitar erros