Содержание
3. Как указать файл в Claude Code: @, IDE, вставка, путь
Что такое контекстное окно
Контекстное окно - это всё, что Claude Code видит в рамках текущей сессии: системные инструкции, файл CLAUDE.md, ваши сообщения и ответы модели, прочитанные файлы и их содержимое, вывод команд и инструментов.
На момент записи видео у современных моделей окно ограничено одним миллионом токенов. У старых моделей и у Haiku оно меньше - 200 тысяч токенов. В любом случае контекст конечен, бесконечно его не наполнить, поэтому за ним нужно следить и держать в пределах, необходимых для задачи.
Что заполняет контекст
Контекст не пуст уже при запуске сессии, до первого вашего сообщения. В нём лежат системные промпты, CLAUDE.md, инструкции из auto memory, описания навыков, имена MCP-серверов и другая служебная информация.
Дальше он растёт по ходу работы: прочитанные текстовые файлы и изображения, введённые команды, ответы модели. Больше всего места занимает чтение файлов - они большие, поэтому с ними нужно быть осторожным.
Как указать файл в Claude Code: @, IDE, вставка, путь
Символ @. Наберите @ и начните вводить имя файла: появится список файлов проекта. По нему можно перемещаться стрелками вверх и вниз или набрать часть имени, например package.json - поиск идёт по всему проекту. Enter добавляет файл в контекст, и Claude Code обязательно прочитает его при выполнении задачи. Через пробел можно указать несколько файлов подряд.
Выделение в IDE. В VS Code и JetBrains при выделении фрагмента кода он автоматически попадает в контекст, Claude Code показывает выделенные строки. Если кликнуть по пустой области файла, в контекст попадёт весь файл. Это работает, только если установлен плагин Claude Code для вашей IDE.
Копирование и вставка. Скопируйте код или весь файл и вставьте в окно Claude Code. Длинная вставка не выводится целиком, а сворачивается в сжатый вид.
Перетаскивание файла мышью в окно терминала. Поддерживается не во всех операционных системах: в Windows бывают сложности, на macOS обычно работает.
Абсолютный путь к файлу. Скопируйте путь и вставьте его в терминал - Claude Code поймёт, какой файл прочитать. Особенно удобно для картинок. В одном сообщении можно передать несколько файлов.
Windows-пути и WSL
Если вы работаете в Windows с Claude Code внутри WSL (Linux), перетаскивание и копирование путей может сбиваться: в WSL пути другие, и подставленный Windows-путь Claude Code не разберёт. Решение - добавить в глобальный файл CLAUDE.md короткую инструкцию: если работа идёт в WSL, преобразовывать Windows-пути в пути WSL.
Команда /context
Команда /context показывает, сколько окна занято и чем именно: цветная сетка разбита по категориям - системные промпты, системные инструменты, MCP-серверы, сообщения, свободное место. Даже сразу после запуска, когда вы ещё ничего не вводили, заметная часть окна уже занята (в записи - более 11%). Остальное остаётся свободным.
Очистка и сжатие: /clear и /compact
По мере работы окно заполняется, и качество ответов падает, поэтому контекст нужно разгружать. При достижении предела он сжимается автоматически, а настройка автосжатия (autocompact) позволяет задать, при каком количестве токенов это делать. Вручную работают две команды:
- /clear полностью очищает контекст - сессия становится чистой, как новая. Подходит, когда вы начинаете новую задачу, не связанную с текущим контекстом, или поняли, что идёте не туда, и хотите начать заново.
- /compact сжимает контекст: лишнее и повторяющееся выбрасывается, остаётся самое необходимое для продолжения работы в этой же сессии.
После сжатия заново загружаются CLAUDE.md проекта, auto memory, план из режима планирования, до пяти последних прочитанных файлов и вызванные навыки (до 5000 токенов на каждый). В сводку уходят ваши сообщения, ответы Claude Code, вывод команд и другие данные. Сжатие - способ для ответственных операций, применять его нужно осторожно: важные данные могут исчезнуть.
Как экономить контекст
- Давайте модели точные запросы. Если можно сослаться на файл, приложить скриншот или дать важную инструкцию - лучше дать: Claude Code не будет сам искать файлы и забивать контекст лишними чтениями.
- Исследование проекта поручайте субагенту. Он работает в изолированном контексте: вся история чтения файлов остаётся там, а в основной контекст возвращается только результат.
- Если что-то пошло не так, используйте /clear.
- Оптимизируйте справку, навыки и файлы CLAUDE.md, держите их в разумном числе строк. Эту тему мы разберём подробнее в следующих уроках.
Чтобы оставить сообщение, зарегистрируйтесь/войдите на сайт через:
Email - зарегистрироваться / войти