Перейти к тексту

Claude Code: работа с coding-агентом3. Знакомство с Claude Code

Промпт в терминале: @, Ctrl+S и картинки

Засчитывается, когда отвечены все вопросы квиза

Зачем это нужно

Вы точно знаете, какой файл агент должен прочитать: конфиг, спеку, модуль с багом. Если описать его словами, агент начнёт искать сам — потратит несколько вызовов инструментов и, возможно, найдёт не тот файл. Если вы на середине длинного промпта поняли, что сначала нужна короткая правка, жалко терять черновик. А ошибку в интерфейсе проще показать скриншотом, чем пересказывать. На все три случая в поле ввода Claude Code есть свой приём.

Как это устроено

@ — ссылка на файл. Наберите @, и откроется меню путей: начните печатать часть имени, стрелками выберите файл, Enter или Tab вставит путь в промпт. Ссылок в одном промпте может быть несколько. Путь можно написать и сам — относительный или абсолютный:

Explain the logic in @src/utils/auth.js

Когда вы отправляете такой промпт, Claude Code сразу включает содержимое файла в разговор. Агенту не нужно вызывать Read tool и ждать: файл уже в контексте первого запроса. Есть ограничения.

  • Файл включается, если укладывается в лимит Read tool — по умолчанию 25 000 токенов. Текстовый файл больше 256 КБ не включается.
  • Ссылка на каталог (@src/components) даёт список файлов, а не их содержимое.
  • Вместе с файлом в контекст попадают CLAUDE.md из его каталога и родительских каталогов.

Ctrl+S — отложить промпт. Если в поле ввода есть текст, Ctrl+S убирает его в stash и очищает поле. Вы пишете и отправляете другое сообщение, а потом нажимаете Ctrl+S на пустом поле — и черновик возвращается целиком: текст, позиция курсора, вставленное содержимое и режим ввода.

Картинки. Скопируйте изображение и вставьте его в поле ввода: Ctrl+V, в iTerm2 — Cmd+V, в Windows и WSL — Alt+V. В промпте появится метка [Image #N], на которую можно сослаться в тексте. Ещё два способа — перетащить файл в окно Claude Code или указать путь к изображению прямо в промпте.

Практика

В репозитории Cadence запустите Claude Code и наберите @pack. В меню появится package.json — выберите его через Tab. Допишите вопрос:

@package.json which scripts run the tests, and what does each one do?

Отправьте и посмотрите на ответ: агент отвечает сразу, без отдельного шага чтения файла, — его содержимое пришло вместе с промптом.

Теперь проверьте stash: начните печатать длинный промпт, нажмите Ctrl+S — поле очистится. Отправьте короткий вопрос, дождитесь ответа, нажмите Ctrl+S ещё раз — черновик вернулся.

Подводные камни

  • Огромный файл через @. Файл больше лимита через @ в контекст не попадёт вовсе. Укажите агенту нужный фрагмент или попросите прочитать файл частями.
  • Stash не возвращается сам. После отправки другого сообщения поле остаётся пустым, пока вы снова не нажмёте Ctrl+S.
  • Ctrl+V не вставляет картинку в WSL. Если терминал перехватывает Ctrl+V, используйте Alt+V.
  • @ и контроль доступа. Файл по @ включается без вызова инструмента, поэтому PreToolUse hooks на это чтение не срабатывают. Если вы ограничиваете чтение через hooks, учитывайте это.

Вывод: если вы знаете, какой файл нужен агенту, дайте его через @, а не описывайте словами.

Проверь себя

Источники

Текст подготовлен с помощью LLM и может содержать неточности.