Урок 6Инструменты

Работа с файлами

Read, Write, Edit

Read

Читает файлы, изображения, PDF и ноутбуки

Write

Создаёт новые файлы или полностью заменяет

Edit

Точечные замены строк в существующих файлах

Read — чтение файлов

Инструмент Read читает содержимое файлов и может обрабатывать разные форматы:

Текстовые файлы.ts, .js, .py, .md, etc.

Изображения.png, .jpg, .gif, .webp

PDF.pdf

Jupyter Notebooks.ipynb

JSON/YAML.json, .yaml, .yml

# Примеры использования:

> Прочитай файл src/auth.ts

> Покажи скриншот error.png

> Проанализируй PDF документ

📖 Read может читать до 2000 строк по умолчанию. Для больших файлов используйте offset и limit.

Edit — точечное редактирование

Edit заменяет конкретные строки в файле. Требует точного совпадения текста:

# Claude выполняет:

Edit file: src/utils.ts

- old_string: "return null;"

+ new_string: "return data ?? null;"

Когда использовать

• Исправление багов
• Добавление импортов
• Рефакторинг функций
• Обновление констант

Ограничения

• old_string должен быть уникальным
• Файл должен существовать
• Требуется предварительный Read

Write — создание файлов

Write создаёт новый файл или полностью перезаписывает существующий:

> Создай новый компонент Button

Write file: src/components/Button.tsx

import React from 'react'; export const Button = ({ children }) => { return <button>{children}</button>; };

⚠️ Write полностью заменяет содержимое файла. Для изменения существующих файлов используйте Edit.

Edit vs Write: когда что использовать

Edit

Точечные изменения в существующем файле

Примеры:

• Исправить баг в функции
• Добавить импорт
• Переименовать переменную

✓ Показывает diff, Безопасно, Сохраняет форматирование

✗ Только для существующих файлов

Write

Создание нового файла или полная замена

Примеры:

• Создать новый компонент
• Сгенерировать конфиг
• Написать тест с нуля

✓ Для новых файлов, Полный контроль

✗ Перезаписывает всё, Нужно быть осторожным

Лучшие практики

1.Claude всегда читает файл перед редактированием — это гарантирует точность
2.Предпочитайте Edit для существующих файлов — это безопаснее и показывает diff
3.Используйте Write только для новых файлов или полной перегенерации
4.Для больших файлов указывайте конкретные строки или функции

Этот урок — часть структурированного курса по LLM.

Мой путь обучения

Урок 6Инструменты

Работа с файлами

Read, Write, Edit

Read

Читает файлы, изображения, PDF и ноутбуки

Write

Создаёт новые файлы или полностью заменяет

Edit

Точечные замены строк в существующих файлах

Read — чтение файлов

Инструмент Read читает содержимое файлов и может обрабатывать разные форматы:

Текстовые файлы.ts, .js, .py, .md, etc.

Изображения.png, .jpg, .gif, .webp

PDF.pdf

Jupyter Notebooks.ipynb

JSON/YAML.json, .yaml, .yml

# Примеры использования:

> Прочитай файл src/auth.ts

> Покажи скриншот error.png

> Проанализируй PDF документ

📖 Read может читать до 2000 строк по умолчанию. Для больших файлов используйте offset и limit.

Edit — точечное редактирование

Edit заменяет конкретные строки в файле. Требует точного совпадения текста:

# Claude выполняет:

Edit file: src/utils.ts

- old_string: "return null;"

+ new_string: "return data ?? null;"

Когда использовать

• Исправление багов
• Добавление импортов
• Рефакторинг функций
• Обновление констант

Ограничения

• old_string должен быть уникальным
• Файл должен существовать
• Требуется предварительный Read

Write — создание файлов

Write создаёт новый файл или полностью перезаписывает существующий:

> Создай новый компонент Button

Write file: src/components/Button.tsx

import React from 'react'; export const Button = ({ children }) => { return <button>{children}</button>; };

⚠️ Write полностью заменяет содержимое файла. Для изменения существующих файлов используйте Edit.

Edit vs Write: когда что использовать

Edit

Точечные изменения в существующем файле

Примеры:

• Исправить баг в функции
• Добавить импорт
• Переименовать переменную

✓ Показывает diff, Безопасно, Сохраняет форматирование

✗ Только для существующих файлов

Write

Создание нового файла или полная замена

Примеры:

• Создать новый компонент
• Сгенерировать конфиг
• Написать тест с нуля

✓ Для новых файлов, Полный контроль

✗ Перезаписывает всё, Нужно быть осторожным

Лучшие практики

1.Claude всегда читает файл перед редактированием — это гарантирует точность
2.Предпочитайте Edit для существующих файлов — это безопаснее и показывает diff
3.Используйте Write только для новых файлов или полной перегенерации
4.Для больших файлов указывайте конкретные строки или функции

Этот урок — часть структурированного курса по LLM.

Мой путь обучения