Claude Code в терминале

Claude Code в терминале: что это значит?

Коротко: Claude Code в терминале - это агент, которого ты запускаешь командой claude из папки проекта. Дальше вы переписываетесь текстом прямо в окне команд, а агент читает файлы этой папки и по твоему разрешению меняет их. Мышь тут почти не нужна: всё делается клавиатурой.

Порядок простой: открываешь окно команд, переходишь в папку с проектом, набираешь claude и пишешь задачу обычными словами. Так и выглядит работа с Claude Code в терминале.

Если ищешь по-русски, клауд код и клод код - это он, агент от Anthropic, подробно о нём - в статье что такое Claude Code.

Флаги запуска сверены со справкой claude --help версии 2.1.278 на моём Mac, остальное - с документацией Anthropic по состоянию на 21 сентября 2026 года. Windows и Linux я руками не проверял, там всё по документации.

Какие разрешения дать агенту, чтобы он не дёргал тебя вопросами, и какие команды закрыть от него насовсем, я показываю в ClaudeBase, в уроках про разрешения.

Где ты сейчас

Коротко: нет программы - начни с установки. На Windows держи под рукой отдельный разбор. Кому удобнее редактор, тем подойдёт VS Code, а из России сначала решают вопрос входа и сети. Найди свою строку ниже.

• Программы ещё нет. Установка по шагам - в отдельной инструкции.
• У тебя Windows. Почти всё ниже работает и там, а ошибки PowerShell и PATH разобраны в статье про Windows.
• Хочешь работать в редакторе. Для панели агента в VS Code есть отдельная статья.
• Ты в России. Вход и сеть - в разборе для России, а оплату разбирает статья как оплатить Claude из России.

Как открыть терминал на Mac, Windows и Linux?

Коротко: на Mac терминал находится через Spotlight по слову Terminal, на Windows его открывает меню Win+X, на Linux - сочетание Ctrl+Alt+T. В каждом случае появится окно с мигающим курсором. Туда вставляются команды, и у каждой системы своё сочетание для вставки, их удобно запомнить сразу.

На Windows есть тонкость: там две разные программы для команд, PowerShell и CMD. Выглядят они похоже, а команды у них разные. Отличить просто: PowerShell начинает строку с PS C:\Users\ИмяПользователя>, у CMD в начале нет букв PS. Команды ниже написаны для PowerShell.

На Linux важен регистр букв. Команда pwd работает, а PWD даёт ошибку.

Как перейти в папку проекта?

Коротко: агенту по умолчанию доступны файлы той папки, из которой ты его запустил. Поэтому сначала переходишь в папку проекта командой cd и только потом запускаешь claude. На Mac путь можно не печатать: папку перетаскивают прямо в окно терминала, а клавиша Tab дописывает имена.

Четыре команды на первый месяц:

В PowerShell это встроенные короткие имена длинных команд. Путь с пробелами бери в кавычки:

cd "/Users/ivan/Documents/Мой проект"

cd "C:\Users\Ivan\Documents\Мой проект"

На Mac путь проще не печатать. Набери cd и пробел, потом перетащи папку из Finder в окно терминала: её полный путь появится в строке, останется нажать Enter. Второй вариант - нажать папку в строке пути внизу окна Finder, удерживая Control, и выбрать «Открыть в Терминале».

Клавиша Tab дописывает имя папки по первым буквам: так устроены и bash на Linux, и PowerShell на Windows.

Под первые опыты заведи отдельную пустую папку. Из домашней папки агента лучше не запускать: там лежит всё сразу, а согласие ей доверять не запоминается и спрашивается при каждом старте.

Как запустить Claude Code в терминале?

Коротко: в папке проекта набери claude и нажми Enter. В первый раз программа попросит войти в аккаунт через браузер, а в каждой незнакомой папке спросит, доверяешь ли ты её файлам. Над полем ввода она покажет свою версию, модель и папку запуска: так видно, где работает агент.

Проверка, что программа стоит:

claude --version

Напечатался номер версии - всё на месте. Не напечатался - возвращайся к установке.

Запуск из папки проекта:

cd путь/к/папке
claude

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

Ещё два способа запуска:

claude "расскажи, что лежит в этой папке"
claude --permission-mode plan

Текст в кавычках после claude открывает сеанс сразу с готовым запросом. Флаг --permission-mode plan сразу включает режим плана: агент изучает папку и расписывает план, а правки ждут твоего одобрения.

Что напечатать первым?

Коротко: сначала посмотри на индикатор режима внизу экрана и при необходимости переключи его, потом задай три запроса, которые ничего не меняют: вопрос о папке, список команд на первый день и план небольшой задачи без правок. Без твоего согласия правки при этом не начнутся.

На тарифах Pro, Max и Team первым режимом в терминале по умолчанию будет auto. В нём действия проверяет отдельная модель-классификатор, и агент правит большинство файлов и выполняет большинство команд, не спрашивая тебя. Самый первый сеанс после установки может начаться и в Manual, поэтому смотри на индикатор.

Нажми Shift+Tab. Из режима auto первое нажатие переводит в Manual, внизу появится ⏸ manual mode on: агент будет спрашивать перед большинством правок, команд и обращений к сети. Ещё два нажатия - и включится ⏸ plan mode on, режим плана. Для первых запросов подходят оба.

Первый запрос - про содержимое папки:

Расскажи, что лежит в этой папке и для чего эти файлы. Ничего не меняй.

Второй - про сам инструмент. Документация предлагает спрашивать агента о его собственных возможностях:

Какие команды Claude Code пригодятся мне в первый день? Ответь списком, ничего не запускай.

Третий - план небольшой задачи без исполнения:

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

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

Как читать экран и отвечать на запросы разрешений?

Коротко: над полем ввода - версия, модель и папка, внизу - режим разрешений и подсказки. Когда агент хочет что-то изменить в режиме Manual, он показывает запрос с вариантами ответа: Enter соглашается один раз, Esc отказывает. Постоянное разрешение пишется в файл настроек, с ним стоит быть аккуратнее.

В запросе разрешения Yes разрешает действие один раз, его выбирает простое нажатие Enter. No отказывает, так же работает Esc. Вариант Yes, and don’t ask again весомее, чем кажется: для команд терминала он сохраняет правило навсегда для этого репозитория в файле .claude/settings.local.json, для правок файлов действует до конца сеанса.

Отказ можно объяснить. Встань на No, нажми Tab, напиши причину и нажми Enter: агент её получит и продолжит работу. Отказ без комментария останавливает текущий ход агента.

Что агент делает сам в каждом режиме, показывает таблица в гайде с нуля. Подробный журнал действий агента открывает Ctrl+O.

Режимы и разрешения подробно разобраны в курсе. В уроке «Настройка VS Code и работа в Claude Code» видно, какой режим брать новичку и без каких запретов не работать. Урок «Рабочее окружение: правила проекта и разрешения» и материал «Настройки Claude Code, Codex и VS Code» показывают, как убрать лишние вопросы агента и закрыть опасные команды. Всё это есть в ClaudeBase.

Как остановить агента и выйти?

Коротко: Esc останавливает агента на полуслове и сохраняет уже сделанное, чтобы ты поправил задачу. Двойной Esc на пустом поле открывает откат к прошлой точке разговора. Выход - команда /exit, слово exit или два нажатия Ctrl+D. С одной клавишей легко ошибиться: Ctrl+Z на Mac и Linux прячет программу в фон.

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

Ctrl+Z на Mac и Linux приостанавливает программу и возвращает тебя в обычный терминал. Вернуть агента можно командой fg.

Как продолжить вчерашний разговор?

Коротко: разговоры сохраняются на диск по ходу работы, поэтому выход ничего не стирает. Команда claude -c в той же папке открывает последний разговор, claude -r показывает список прошлых сеансов. Разговору можно дать имя через флаг -n или команду /rename и возвращаться к нему по названию.

claude -c
claude -r

claude -c (полное имя --continue) открывает самый свежий разговор именно в текущей папке, поэтому запускай её оттуда же, где работал вчера. Режим разрешений обычно восстанавливается тот, в котором сеанс закончился, режим плана - исключение.

claude -r (полное имя --resume) открывает список. Стрелки двигают выбор, Enter открывает разговор, пробел показывает его содержимое, Ctrl+A расширяет список до всех проектов на компьютере.

Имя задаётся при запуске или прямо в сеансе:

claude -n otchet-za-sentyabr
claude -r otchet-za-sentyabr

Внутри сеанса то же делают /rename и /resume. Команда /clear начинает разговор с чистого листа, а прежний остаётся в списке. Стрелка вверх в поле ввода листает твои прошлые запросы в этой папке, в том числе из прошлых сеансов.

Как писать длинный запрос и вставлять текст?

Коротко: Enter отправляет сообщение, а новую строку в любом терминале дают Ctrl+J или обратная косая черта перед Enter. Shift+Enter работает сам не везде. Длинная вставка сворачивается в метку, но уходит агенту целиком, а большие логи удобнее положить в файл. Картинки вставляются из буфера.

Четыре способа сделать перенос строки:

1. Ctrl+J - работает в любом терминале без настройки.
2. \ и сразу Enter - тоже везде.
3. Shift+Enter - сам работает в iTerm2, Apple Terminal, Windows Terminal, Ghostty, Kitty, WezTerm и Warp.
4. Option+Enter на Mac - после включения Option как клавиши Meta, про неё ниже.

На Windows Shift+Enter иногда отправляет сообщение вместо переноса, в трекере Claude Code на это есть открытое обращение 92771.

Вставка длиннее 800 знаков или трёх строк сворачивается в метку вида [Pasted text #1 +120 lines], а при отправке уходит весь текст. Целый файл или длинный лог проще сохранить на диск и попросить агента прочитать его по пути.

Ещё три символа в поле ввода:

• @ - подсказывает пути к файлам, чтобы сослаться на нужный.
• ! в начале - выполняет команду терминала напрямую, её вывод попадает в разговор, и агент на него отвечает.
• / в начале - открывает список команд и скиллов; полный список - в шпаргалке команды Claude Code.

Картинку из буфера вставляет Ctrl+V, в iTerm2 - Cmd+V, на Windows - Alt+V.

Что настроить в терминале один раз?

Коротко: по документации агент работает в любом терминале без настройки. Настраивать стоит, только если что-то конкретное мешает: Shift+Enter отправляет сообщение, не работают сочетания с Option или экран мерцает. На каждый случай хватает одной команды или флажка, остальное можно не трогать.

В Apple Terminal команда /terminal-setup включает Option как Meta и выключает звуковой сигнал терминала. Если при первом запуске ты согласился на предложенную настройку терминала, это уже сделано. Остальные настройки агента - в статье Claude Code: настройка с нуля.

Что делать, если терминал пишет ошибку?

Коротко: ниже пять сообщений, которые терминал печатает при типичных промахах новичка: программа не найдена, папка удалена, macOS не пускает терминал в Документы, опечатка в команде, неверный номер сессии. Заголовки совпадают с текстом на экране, так что искать можно прямо по нему.

command not found: claude

Программа стоит, но её папки нет в PATH - списке мест, где система ищет команды. Точную команду исправления установщик печатает в блоке Setup notes в конце установки, после неё открой новое окно терминала. На Windows то же выглядит как 'claude' is not recognized. Разбор - в статьях про установку и Windows.

The current directory no longer exists

Папку, из которой ты запустил агента, удалили или переместили. Перейди в существующую папку и запусти claude снова. Если папку создали заново по тому же пути, выйди из неё и зайди обратно.

Operation not permitted

Так отвечает команда ls, когда macOS закрыла терминалу доступ к Рабочему столу, Документам, Загрузкам или iCloud Drive. Агент в такой папке сообщает Can't read the current directory с кодом ошибки. Закрой терминал через Cmd+Q, открой снова и вернись в папку. Не помогло - открой «Системные настройки» → «Конфиденциальность и безопасность» → «Файлы и папки» и включи доступ для терминала.

Unknown command

Полный текст выглядит как Unknown command: /hepl. Did you mean /help?. Это опечатка либо команда, недоступная в твоём сеансе. Набери / и выбери нужную из списка.

No conversation found with session ID

Такой ответ приходит на claude --resume с номером сессии, которой нет: номер набран с ошибкой, разговор удалён после срока хранения (по умолчанию 30 дней) или шёл на другом компьютере. Открой claude --resume без номера и нажми Ctrl+A.

Чек-лист

Коротко: терминал перестаёт пугать, когда ты уверенно делаешь шесть вещей из списка. Проверить каждую можно за минуту прямо сейчас, на своей машине. Не выходит какой-то пункт - вернись к разделу выше, где он разобран: пункты идут в том же порядке, что и разделы.

• Открываю терминал на своей системе и вставляю в него скопированную команду.
• Командой pwd вижу, в какой папке нахожусь, и перехожу в папку проекта через cd.
• Запускаю claude и нахожу над полем ввода свою рабочую папку.
• Переключаю режим через Shift+Tab и вижу ⏸ plan mode on или ⏸ manual mode on.
• Останавливаю ответ клавишей Esc и выхожу командой /exit.
• Возвращаюсь к разговору командой claude -c из той же папки.

Терминал освоен - что дальше?

Коротко: когда агент в терминале запускается и останавливается по Esc, ему нужно рабочее место: файл правил, чтобы сеанс не начинался с пересказа, разумные разрешения и пара готовых скиллов под твои задачи. Ниже три шага в порядке пользы и ссылки на разборы.

1. Заведи файл правил проекта. Команда /init собирает заготовку, а как её дописать, объясняет статья про CLAUDE.md.
2. Настрой разрешения под себя. Порядок - в настройке с нуля, расход и лимиты - в отдельном разборе.
3. Держи под рукой шпаргалку. Команды на каждый день собраны на одной странице.

В ClaudeBase я собрал уроки про разрешения и рабочее окружение, настройки, готовые скиллы и агентов. Читать базу целиком не нужно: к агенту её подключают по MCP одной командой, и дальше он сам ищет в ней то, что нужно под задачу. Как устроен доступ, написано на странице ClaudeBase.