---
title: "Файлы"
id: "343"
type: "page"
slug: "files"
published_at: "2026-05-19T11:30:45+00:00"
modified_at: "2026-06-13T00:52:52+00:00"
url: "https://pastukhov.com/code/docs/files"
markdown_url: "https://pastukhov.com/code/docs/files.md"
excerpt: "Диалоговое окно «Файлы» предоставляет комплексный интерфейс для управления файлами проекта прямо в браузере. Просматривайте структуру…"
---

# Файлы

[https://pastukhov.com/code/docs/files.md](https://pastukhov.com/code/docs/files.md)

Диалоговое окно «Файлы» предоставляет комплексный интерфейс для управления файлами проекта прямо в браузере. Просматривайте структуру файлов, редактируйте код, создавайте новые файлы и папки, переименовывайте элементы, перемещайте содержимое между папками и удаляйте ненужные файлы — всё в одном удобном интерфейсе.

## Открытие диалогового окна «Файлы»

Откройте диалоговое окно «Файлы», нажав кнопку «Файлы» в области ввода сообщений или на панели Git. Диалог также открывается при нажии на значок редактирования файла на панели Git, кнопки «Редактировать файл» в представлении diff или когда Claude редактирует файл через сообщения инструментов.

Диалог отображается как большое перекрывающее окно с двумя основными секциями: дерево файлов слева, показывающее структуру проекта, и панель редактора справа для просмотра и редактирования содержимого файлов. Такая конструкция с разделёнными панелями позволяет быстро перемещаться между файлами, сохраняя видимость и возможность редактирования кода.

При открытии с панели Git или из сообщения инструмента диалог автоматически выбирает и отображает соответствующий файл. В противном случае он открывается с последним просмотренным файлом или с выбором по умолчанию.

### Открытие файлов с панели Git:

- **Значок редактирования** — У каждого файла на панели Git есть значок ручки; нажмите его, чтобы открыть этот файл в диалоге «Файлы»
- **Кнопка «Файлы»** — На панели Git есть своя кнопка «Файлы», которая открывает диалог в корне проекта
- **Редактировать файл в diff** — В представлении diff Git есть кнопка «Редактировать файл», которая открывает изменённый файл в редакторе

### Просмотр файлов в диалоге «Навыки»:

Диалог «Навыки» включает собственный просмотрщик файлов для просмотра и редактирования файлов, связанных с навыками (например, `SKILL.md`), отдельно от диалога «Файлы».

## Дерево файлов

Дерево файлов слева от диалогового окна «Файлы» отображает всю структуру проекта в иерархическом сворачиваемом формате. Папки отображаются со значками, указывающими, развернуты они или свёрнуты, а файлы показывают значки в зависимости от их типа.

### Навигация по дереву:

- **Нажмите на папку**, чтобы развернуть или свернуть её содержимое
- **Нажмите на файл**, чтобы открыть его в панели редактора справа
- **Дважды нажмите на папку**, чтобы развернуть её и одновременно просмотреть её свойства

### Клавиатурные сокращения:

- **Клавиши со стрелками** — Перемещение вверх и вниз по файлам и папкам
- **Enter** — Открыть выбранный файл или развернуть/свернуть выбранную папку
- **Delete** — Удалить выбранный файл или папку (с подтверждением)
- **+ (плюс)** — Развернуть выбранную папку
- **– (минус)** — Свернуть выбранную папку
- **F2** — Переименовать выбранный файл или папку

Дерево файлов сохраняет состояние развёртывания, поэтому при закрытии и повторном открытии диалога папки остаются развёрнутыми или свёрнутыми в соответствии с вашим последним взаимодействием. Это позволяет легко сохранить предпочтительный вид структуры проекта.

## Редактор файлов

Редактор файлов справа от диалогового окна «Файлы» предоставляет полный набор функций для редактирования кода прямо в браузере. При выборе файла из дерева его содержимое появляется в редакторе, готовое для просмотра и изменения.

### Функции редактора:

- **Подсветка синтаксиса** — Код цветом кодируется на основе языка программирования, что упрощает чтение и понимание структуры
- **Номера строк** — Отображаются вдоль левого края для удобства ссылки при обсуждении конкретных строк
- **Автосохранение** — Изменения сохраняются автоматически при вводе, предотвращая случайную потерю данных
- **Счётчик токенов** — Счётчик внизу редактора отображает текущее количество токенов для файла, полезно для понимания ограничений использования API
- **Выбор темы** — Выберите из нескольких цветовых тем (светлая, тёмная или высококонтрастная) в соответствии с вашими визуальными предпочтениями

Редактор поддерживает стандартные операции редактирования текста, включая ввод, удаление, выбор текста, копирование, вставку и отмену/повтор. Вы также можете использовать клавиатурное сокращение **Ctrl+S** (или **Cmd+S** на Mac) для ручного сохранения изменений в любое время, даже если включено автосохранение.

Большие файлы загружаются эффективно, и редактор остаётся отзывчивым даже со значительными кодовыми базами. Подсветка синтаксиса адаптируется автоматически на основе расширения файла, поэтому TypeScript, JavaScript, Python, HTML, CSS и другие языки отображаются правильно без ручной настройки.

## Запуск скриптов

При открытии shell-скрипта (файла `.sh`) в редакторе в заголовке редактора появляется кнопка «Запустить». Нажмите её, чтобы выполнить скрипт — вывод отображается в реальном времени в диалоговом окне «Вывод скрипта».

### Диалоговое окно «Вывод скрипта»:

Диалог показывает имя скрипта, репозиторий, к которому он принадлежит, и счётчик прошедшего времени в заголовке. Вывод появляется строка за строкой по мере выполнения скрипта с автоматической прокруткой к последнему выводу. Если вы прокрутите вверх для просмотра предыдущего вывода, автопрокрутка приостанавливается и появляется кнопка прокрутки вниз.

- **Кнопка «Копировать»** — Копирует полный вывод в буфер обмена. Отключена во время выполнения скрипта для предотвращения неполных копий
- **Кнопка «Остановить»** — Анимированная кнопка остановки в заголовке завершает скрипт. Закрытие диалога также останавливает выполнение
- **Звук завершения** — Звук воспроизводится при завершении скрипта, поэтому вы получите уведомление, даже если диалог не сфокусирован

### Подсветка синтаксиса вывода:

Вывод скрипта автоматически анализируется и подсвечивается с использованием правил, определённых в файле `output.parser`, расположенном в каталоге `.pastukhov/` вашего проекта. Строки, соответствующие шаблонам ошибок, подсвечиваются красным, а шаблоны предупреждений — оранжевым. Тот же формат парсера используется для вывода сборки (`build.parser`) и вывода развёртывания (`deploy.parser`).

Файл парсера использует простой формат с блоками `[ERROR]` и `[WARNING]`, каждый из которых содержит регулярные выражения, применяемые к отдельным строкам. Для многострочных шаблонов (например, трассировок Python) заключите регулярное выражение в двойные фигурные скобки: `{{regex}}`. Строки, начинающиеся с `#`, являются комментариями.

```
# Shell command not found
[ERROR]
.*command not found
[/ERROR]

# Python traceback (multi-line)
[ERROR]
^Traceback \(most recent call last\)\:
{{.*}}
[/ERROR]
```

Редактируйте файл `output.parser` в диалоге «Файлы», чтобы настроить подсветку строк. Изменения вступят в силу при следующем выполнении скрипта — перезапуск сервера не требуется.

## Создание файлов и папок

Добавляйте новые элементы в свой проект с помощью панели инструментов в верхней части диалогового окна «Файлы» или контекстного меню при нажатии правой кнопкой мыши. Оба метода предоставляют одинаковые функции, поэтому выберите тот, который более удобен для вашего рабочего процесса.

### Чтобы создать новый файл:

- Нажмите кнопку «Новый файл» на панели инструментов или нажмите правой кнопкой мыши в дереве файлов и выберите «Новый файл»
- Появится диалоговое окно с предложением ввести имя файла
- Введите имя, включая расширение (например: `helper.ts` или `styles.css`)
- Если вы хотите создать файл внутри определённой папки, укажите путь (например: `src/utils/helper.ts`)
- Нажмите Enter или кнопку «Создать» для подтверждения

### Чтобы создать новую папку:

- Нажмите кнопку «Новая папка» на панели инструментов или нажмите правой кнопкой мыши в дереве файлов и выберите «Новая папка»
- Появится диалоговое окно с предложением ввести имя папки
- Введите имя папки (например: `components` или `tests`)
- Для создания вложенных папок используйте прямые слэши (например: `src/components/ui`)
- Нажмите Enter или кнопку «Создать» для подтверждения

При создании нового файла редактор автоматически открывает его, чтобы вы могли начать добавлять содержимое. Новые папки появляются в дереве файлов и могут быть развёрнуты для отображения их содержимого (изначально пустого). Система автоматически проверяет имена файлов, чтобы убедиться, что они не содержат недопустимых символов и не конфликтуют с существующими элементами в том же месте.

## Переименование файлов и папок

Переименовывайте файлы и папки для лучшей организации проекта или исправления ошибок в именах. Операция переименования обновляет имя элемента, сохраняя его содержимое и расположение в иерархии.

### Чтобы переименовать элемент:

1. Выберите файл или папку в дереве файлов, нажав на них один раз
2. Нажмите клавишу **F2** или нажмите правой кнопкой мыши и выберите «Переименовать» в контекстном меню
3. Появится диалоговое окно с текущим именем с выделенным текстом
4. Введите новое имя (для файлов включите расширение)
5. Нажмите Enter или кнопку «Переименовать» для подтверждения изменения

Система проверяет новое имя, чтобы убедиться, что оно не конфликтует с существующими элементами в той же родительской папке. Если вы попытаетесь переименовать файл в имя, которое уже существует, операция не удастся, и вы увидите сообщение об ошибке, объясняющее конфликт.

Переименование папки автоматически обновляет пути всех файлов и подпапок внутри неё, поэтому вам не нужно вручную обновлять ссылки. Однако, если ваш код содержит жёстко заданные пути к файлам или операторы импорта, ссылающиеся на старое имя, вам нужно будет обновить их вручную после завершения операции переименования.

## Перемещение файлов и папок

Перемещайте файлы и папки в другие места вашего проекта для реорганизации структуры. Эта операция перемещает элемент, сохраняя его содержимое и свойства.

### Чтобы переместить элемент:

1. Выберите файл или папку в дереве файлов, нажав на них один раз
2. Нажмите правой кнопкой мыши и выберите «Переместить» в контекстном меню
3. Появится диалоговое окно выбора папки, показывающее структуру вашего проекта
4. Перейдите по дереву, чтобы найти папку назначения
5. Нажмите на папку назначения для её выбора, затем нажмите «Переместить» для подтверждения

При перемещении папки всё её содержимое (файлы и подпапки) перемещается вместе с ней, сохраняя внутреннюю структуру. Операция проверяет, что место назначения не содержит элемента с тем же именем, предотвращая случайную перезапись.

Перемещение файлов и папок автоматически обновляет их внутренние пути. Однако, как и при переименовании, если ваш код содержит относительные пути или операторы импорта, основанные на старом расположении, вам может потребоваться обновить эти ссылки вручную. Например, перемещение служебного файла из `src/utils/` в `src/lib/` требует обновления всех операторов `import`, ссылающихся на старый путь.

## Удаление файлов и папок

Удаляйте ненужные файлы и папки из вашего проекта с помощью функции удаления. Эта операция окончательно удаляет элементы, поэтому система требует подтверждения для предотвращения случайной потери данных.

### Чтобы удалить элемент:

1. Выберите файл или папку в дереве файлов, нажав на них один раз
2. Нажмите клавишу **Delete** или нажмите правой кнопкой мыши и выберите «Удалить» в контекстном меню
3. Появится диалоговое окно подтверждения с просьбой подтвердить удаление
4. Проверьте имя и путь элемента, чтобы убедиться, что вы выбрали правильный
5. Нажмите «Удалить» для окончательного удаления элемента или «Отмена» для прерывания операции

При удалении папки все файлы и подпапки внутри неё также удаляются. Диалог подтверждения показывает общее количество элементов, которые будут удалены, помогая вам понять объём операции перед подтверждением.

**Важно:** Удаление окончательное и не может быть отменено. Нет корзины или папки для удалённых файлов. Если вы случайно удалите важные файлы, вам может потребоваться восстановить их из резервной копии (если она доступна) или воссоздать вручную. Всегда дважды проверяйте диалог подтверждения перед продолжением удалений.

## Хлебные crumbs файлов

Панель хлебных crumbов появляется в верхней части панели редактора файлов, отображая полный путь к открытому в данный момент файлу. Хлебные crumbs обеспечивают быструю навигацию и помогают понять расположение файла в структуре вашего проекта.

Например, если у вас есть файл по пути `src/utils/helper.ts`, хлебные crumbs отображаются как:

`src › utils › helper.ts`

Каждый сегмент в хлебных crumbах можно нажать. Нажатие на имя папки открывает эту папку в дереве файлов (или открывает расположение папки, если она сейчас не видна), а нажатие на имя файла ничего не делает, так как файл уже открыт. Хлебные crumbs особенно полезны при работе с глубоко вложенными файлами, так как они обеспечивают быстрый способ вернуться к родительским каталогам без ручной прокрутки по дереву.

При переключении между файлами в редакторе хлебные crumbs автоматически обновляются, чтобы отразить путь текущего файла. Панель хлебных crumbов также служит визуальным индикатором того, какой файл сейчас активен, помогая сохранять контекст при последовательном редактировании нескольких файлов.

**[← Чат](/code/docs/chat)**

**[Сборка и развёртывание →](/code/docs/build-deploy)**