# Read

Завантажує вміст одного файлу з локальної файлової системи. Підтримує простий текст, вихідний код, зображення, PDF та Jupyter-ноутбуки, повертаючи результати з номерами рядків на основі 1 у стилі `cat -n`.

## Коли використовувати

- Читання файлу вихідного коду за відомим шляхом перед редагуванням чи аналізом
- Перегляд файлів конфігурації, lockfile, логів чи згенерованих артефактів
- Перегляд скріншотів чи діаграм, які користувач вставив у розмову
- Витягування конкретного діапазону сторінок з довгого PDF-посібника
- Відкриття ноутбука `.ipynb` для спільного перегляду клітинок з кодом, markdown та виводів клітинок

## Параметри

- `file_path` (string, обовʼязковий): Абсолютний шлях до цільового файлу. Відносні шляхи відхиляються.
- `offset` (integer, необовʼязковий): Номер рядка на основі 1, з якого почати читання. Корисно для великих файлів у парі з `limit`.
- `limit` (integer, необовʼязковий): Максимальна кількість рядків для повернення, починаючи з `offset`. За замовчуванням 2000 рядків з початку файлу, коли опущено.
- `pages` (string, необовʼязковий): Діапазон сторінок для файлів PDF, наприклад `"1-5"`, `"3"` чи `"10-20"`. Обовʼязковий для PDF довших за 10 сторінок; максимум 20 сторінок на запит.

## Приклади

### Приклад 1: Читання маленького файлу повністю
Викличте `Read` лише з `file_path`, встановленим на `/Users/me/project/src/index.ts`. До 2000 рядків повертається з номерами рядків, чого зазвичай достатньо для контексту редагування.

### Приклад 2: Посторінкове читання довгого логу
Використовуйте `offset: 5001` і `limit: 500` на багатотисячному лог-файлі, щоб отримати вузьке вікно без марнування контекстних токенів.

### Приклад 3: Витягування конкретних сторінок PDF
Для 120-сторінкового PDF за `/tmp/spec.pdf` встановіть `pages: "8-15"`, щоб вилучити лише потрібний розділ. Опущення `pages` на великому PDF призведе до помилки.

### Приклад 4: Перегляд зображення
Передайте абсолютний шлях скріншоту PNG чи JPG. Зображення відображається візуально, щоб Claude Code міг міркувати про нього безпосередньо.

## Примітки

- Завжди віддавайте перевагу абсолютним шляхам. Якщо користувач надає один, довіряйте йому як є.
- Рядки довші за 2000 символів обрізаються; розглядайте повернутий вміст як потенційно обрізаний для дуже широких даних.
- Читаєте кілька незалежних файлів? Видайте кілька викликів `Read` в одній відповіді, щоб вони виконувалися паралельно.
- `Read` не може перелічувати каталоги. Використовуйте виклик `Bash` `ls` чи інструмент `Glob` натомість.
- Читання наявного, але порожнього файлу повертає системне нагадування, а не байти файлу, тому обробляйте цей сигнал явно.
- Успішний `Read` потрібен перед тим, як ви зможете використовувати `Edit` на тому самому файлі в поточній сесії.
