Claude Code в терминале: что это значит?
Коротко: Claude Code в терминале - это агент, которого ты запускаешь командой claude из папки проекта. Дальше вы переписываетесь текстом прямо в окне команд, а агент читает файлы этой папки и по твоему разрешению меняет их. Мышь тут почти не нужна: всё делается клавиатурой.
Порядок простой: открываешь окно команд, переходишь в папку с проектом, набираешь claude и пишешь задачу обычными словами. Так и выглядит работа с Claude Code в терминале.
Если ищешь по-русски, клауд код и клод код - это он, агент от Anthropic, подробно о нём - в статье что такое Claude Code.
Команды сверены с документацией Anthropic и справкой CLI 2.1.312 на macOS 30 октября 2026 года. Ответ модели на запрос и запуск на Windows и Linux здесь не проверялись.
Какие разрешения дать агенту, чтобы он не дёргал тебя вопросами, и какие команды закрыть от него насовсем, я показываю в ClaudeBase, в уроках про разрешения.
Где ты сейчас
- Программы ещё нет. Установка по шагам - в отдельной инструкции.
- У тебя Windows. Почти всё ниже работает и там, а ошибки PowerShell и PATH разобраны в статье про Windows.
- Хочешь работать в редакторе. Для панели агента в VS Code есть отдельная статья.
- Ты в России. Вход и сеть - в разборе для России, а если после оплаты аккаунт заблокировали - читай разбор блокировки после оплаты.
Как открыть терминал на Mac, Windows и Linux?
| Система | Как открыть | Как вставить скопированное |
|---|---|---|
| macOS | Cmd+Space, набрать Terminal (в русской системе приложение называется «Терминал»), Enter |
Cmd+V |
| Windows | Win+X, пункт Windows PowerShell или Terminal |
Ctrl+V или правая кнопка мыши |
| Linux | Обычно Ctrl+Alt+T или поиск Terminal в меню приложений |
Ctrl+Shift+V |
На Windows есть тонкость: там две разные программы для команд, PowerShell и CMD. Выглядят они похоже, а команды у них разные. Отличить просто: PowerShell начинает строку с PS C:\Users\ИмяПользователя>, у CMD в начале нет букв PS. Команды ниже написаны для PowerShell.
В Windows Terminal можно открыть разные оболочки. Если работаешь через WSL, ставь и запускай Claude Code в терминале своего Linux-дистрибутива; команды PowerShell туда не копируй.
Как перейти в папку проекта?
Четыре команды на первый месяц:
| Что нужно | macOS и Linux | Windows PowerShell |
|---|---|---|
| Узнать, где я сейчас | pwd |
pwd |
| Посмотреть, что в папке | ls |
ls или dir |
| Перейти в папку | cd путь |
cd путь |
| Подняться на уровень выше | cd .. |
cd .. |
В PowerShell это встроенные короткие имена длинных команд. Путь с пробелами бери в кавычки:
cd "/Users/ivan/Documents/Мой проект"
cd "C:\Users\Ivan\Documents\Мой проект"
На Mac путь проще не печатать. Набери cd и пробел, потом перетащи папку из Finder в окно терминала: её полный путь появится в строке, останется нажать Enter. Второй вариант - нажать папку в строке пути внизу окна Finder, удерживая Control, и выбрать «Открыть в Терминале».
Клавиша Tab дописывает имя папки по первым буквам: так устроены и bash на Linux, и PowerShell на Windows.
Под первые опыты заведи отдельную пустую папку. Из домашней папки агента лучше не запускать: там лежат другие проекты и личные файлы. Рабочая папка задаёт начало работы, но сама по себе не изолирует агента от остального диска.
Как запустить Claude Code в терминале?
Если программа ещё не установлена, официальные команды установки Anthropic такие:
| Где устанавливаешь | Команда |
|---|---|
| macOS, Linux, WSL | curl -fsSL https://claude.ai/install.sh | bash |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex |
Это загрузка и запуск официального установщика. Node.js для него не нужен. Способы установки и ошибки подробно разобраны в отдельной инструкции. В WSL установка и запуск идут внутри Linux. По Advanced setup, проверено 30 октября 2026 года, Git for Windows в нативной Windows необязателен: без него агент выполняет команды через PowerShell.
После установки открой новое окно терминала. Из папки проекта выполни:
pwd
ls
claude --version
claude
pwd должен показать путь к нужному проекту, ls - его файлы, claude --version - номер версии. Например, в проверке 30 октября получен 2.1.312 (Claude Code). У тебя номер может отличаться.
При первом запуске появится вход через браузер; в новой папке - вопрос о доверии к её файлам. Подойдут подписка Claude с доступом к Code или Console с оплатой API. Как выбрать вход, разобрано в статье про ключ и подписку.
После входа появится поле диалога, над ним - версия, модель и рабочая папка. Строки с именем модели недостаточно для проверки: убедись, что агент отвечает на вопрос. Выбор модели - в статье про Opus.
Для первого знакомства можно сразу открыть режим плана:
claude --permission-mode plan
Команды cd, ls и claude -c вводятся в обычном терминале. Внутри открытого агента пишут задачу или команду с /, например /help. Чтобы снова перейти к командам терминала, сначала выйди через /exit.
Что напечатать первым?
Проверь индикатор внизу окна. Shift+Tab переключает режимы; нажимай до ⏸ plan mode on, не считай нажатия. По документации режимов, проверено 30 октября 2026 года, стартовый режим зависит от версии программы, настроек и ограничений организации. Проверяй надпись внизу окна.
Plan mode предназначен для изучения и подготовки плана. В нём агент может выполнять команды терминала для изучения проекта. Если программа запущена с флагом обхода разрешений (--dangerously-skip-permissions или --allow-dangerously-skip-permissions), в интерактивном терминале блокировка правок в plan mode не действует. Второй флаг только добавляет обход в список режимов, но этого уже достаточно для исключения. Для примеров ниже запускай сеанс без этих флагов.
Первый запрос - про содержимое папки:
Расскажи, что лежит в этой папке и для чего эти файлы. Ничего не меняй.
Второй - про сам инструмент. Документация предлагает спрашивать агента о его собственных возможностях:
Какие команды Claude Code пригодятся мне в первый день? Ответь списком, ничего не запускай.
Третий - план небольшой задачи без исполнения:
Составь план: разложить файлы из этой папки по подпапкам по типу. Сначала покажи план, ничего не перемещай.
Готово, когда ответ соответствует твоей папке. Сравни его со списком ls, который получил до запуска:
| Результат | Как проверить |
|---|---|
| Агент перечислил файлы | Названия совпадают с ls; по пустой папке он не описывает готовый проект |
| Агент предложил план | Пока обсуждаешь его, файлы задачи не должны быть изменены |
| Ответа нет, появилась ошибка входа или лимита | Установка работает, но первый запрос ещё не выполнен; разборы входа и лимитов |
| Агент начал действие, которого ты не просил | Нажми Esc и уточни задачу |
Это проверка, которую можно повторить на своём компьютере. Формулировки ответов различаются; дословного «правильного ответа» здесь нет. Как задавать следующие задачи, объясняет статья про промпт.
Как читать экран и отвечать на запросы разрешений?
| Что видишь | Что это значит |
|---|---|
| версия, модель и папка над полем ввода | где запущен агент и на какой модели он отвечает |
⏸ manual mode on |
Manual: агент спрашивает перед правками и командами |
⏵⏵ accept edits on |
правки файлов и простые файловые команды идут без вопросов |
⏸ plan mode on |
изучение и план; исключение, если сеанс запущен с флагом обхода разрешений, разобрано выше |
⏵⏵ auto mode on |
действия проверяет классификатор вместо тебя |
esc to interrupt |
агент работает, Esc его остановит |
? for shortcuts |
на пустом поле ? открывает список клавиш |
[Pasted text #1 +120 lines] |
длинная вставка свёрнута в метку, но уйдёт целиком |
В запросе разрешения Yes разрешает действие один раз, его выбирает простое нажатие Enter. No отказывает, так же работает Esc. Вариант Yes, and don’t ask again для команд Bash обычно сохраняет правило для этого репозитория в .claude/settings.local.json. Для правок файлов разрешение действует до конца сеанса. Место сохранения может отличаться на Windows и вне Git-репозитория.
Отказ можно объяснить. Встань на No, нажми Tab, напиши причину и нажми Enter: агент её получит и продолжит работу. Отказ без комментария останавливает текущий ход агента.
Подробный журнал действий агента открывает Ctrl+O. Постоянные разрешения настраивай по отдельной инструкции: здесь достаточно выбрать режим для первого сеанса.
Режимы и разрешения подробно разобраны в курсе. В уроке «Настройка VS Code и работа в Claude Code» видно, какой режим брать новичку и без каких запретов не работать. Урок «Рабочее окружение: правила проекта и разрешения» и материал «Настройки Claude Code, Codex и VS Code» показывают, как убрать лишние вопросы агента и закрыть опасные команды. Всё это есть в ClaudeBase.
Как остановить агента и выйти?
| Клавиша | Что делает |
|---|---|
Esc |
останавливает текущий ответ, сделанное сохраняется |
Ctrl+C |
прерывает работу, а на пустом поле первое нажатие чистит ввод, второе закрывает программу |
Esc дважды |
на пустом поле открывает меню отката, то же делает /rewind |
Ctrl+D дважды |
на пустом поле закрывает программу; первое нажатие покажет подсказку |
У отката есть граница: он возвращает правки, которые агент сделал своими инструментами, а файлы, изменённые командами терминала, не отслеживает. Поэтому команды, которые удаляют или перемещают файлы, поначалу разрешай по одной.
Ctrl+Z на Mac и Linux приостанавливает программу и возвращает тебя в обычный терминал. Вернуть агента можно командой fg.
Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF
Как продолжить вчерашний разговор?
claude -c
claude -r
claude -c (полное имя --continue) открывает самый свежий разговор именно в текущей папке. Сначала вернись туда командой cd. Если запускаешь команду из другой папки, нужного разговора в ней может не быть.
claude -r (полное имя --resume) открывает список. Стрелки двигают выбор, Enter открывает разговор, пробел показывает его содержимое, Ctrl+A расширяет список до всех проектов на компьютере.
Имя задаётся при запуске или прямо в сеансе:
claude -n otchet-za-sentyabr
claude -r otchet-za-sentyabr
Внутри сеанса то же делают /rename и /resume. Команда /clear начинает разговор с чистого листа, а прежний остаётся в списке. Стрелка вверх в поле ввода листает твои прошлые запросы в этой папке, в том числе из прошлых сеансов.
Как писать длинный запрос и вставлять текст?
Четыре способа сделать перенос строки:
Ctrl+J- работает в любом терминале без настройки.\и сразуEnter- тоже везде.Shift+Enter- сам работает в iTerm2, Apple Terminal, Windows Terminal, Ghostty, Kitty, WezTerm и Warp.Option+Enterна Mac - после включения Option как клавиши Meta, про неё ниже.
Длинная вставка может свернуться в метку вида [Pasted text #1 +120 lines], а при отправке уходит весь текст. Целый файл или длинный лог проще сохранить на диск и попросить агента прочитать его по пути.
Ещё три символа в поле ввода:
@- подсказывает пути к файлам, чтобы сослаться на нужный.!в начале - выполняет команду терминала напрямую, её вывод попадает в разговор, и агент на него отвечает./в начале - открывает список команд и скиллов; полный список - в шпаргалке команды Claude Code.
Картинку из буфера вставляет Ctrl+V, в iTerm2 - Cmd+V, на Windows - Alt+V.
Что настроить в терминале один раз?
| Что мешает | Что сделать |
|---|---|
| Shift+Enter отправляет сообщение в VS Code, Cursor, Zed или Alacritty до версии 0.16 | один раз выполнить /terminal-setup |
| В gnome-terminal и терминале JetBrains нет Shift+Enter | пользоваться Ctrl+J |
| На Mac не работают сочетания с Option | «Терминал» → «Настройки» → «Профили» → «Клавиатура», флажок «Использовать клавишу Option как метаклавишу» |
| Нет сигнала, когда агент закончил | в Ghostty и Kitty есть уведомления; в iTerm2 их нужно включить. Настройка preferredNotifChannel: "terminal_bell" отправляет сигнал терминалу; в Apple Terminal для звука ещё нужен флажок Audible bell |
| Экран мерцает, прокрутка прыгает | /tui fullscreen |
| Цвета не подходят к терминалу | /theme, вариант auto подстраивается под светлый или тёмный фон |
В Apple Terminal команда /terminal-setup включает Option как Meta и выключает звуковой сигнал терминала. Если при первом запуске ты согласился на предложенную настройку терминала, это уже сделано. Остальные настройки агента - в статье Claude Code: настройка с нуля.
Что делать, если терминал пишет ошибку?
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 с номером сессии, которой нет: номер набран с ошибкой, разговор удалён или шёл на другом компьютере. Открой claude --resume без номера и нажми Ctrl+A.
Чек-лист
- Открываю терминал на своей системе и вставляю в него скопированную команду.
- Командой
pwdвижу, в какой папке нахожусь, и перехожу в папку проекта черезcd. - Командой
claude --versionполучаю номер версии, запускаюclaudeи нахожу свою рабочую папку. - Вижу
⏸ plan mode on, задаю вопрос и сверяю перечисленные файлы с выводомls. - Останавливаю ответ клавишей
Escи выхожу командой/exit. - Возвращаюсь к разговору командой
claude -cиз той же папки.
Терминал освоен - что дальше?
- Заведи файл правил проекта. Команда
/initсобирает заготовку, а как её дописать, объясняет статья про CLAUDE.md. - Настрой разрешения под себя. Порядок - в настройке с нуля, расход и лимиты - в отдельном разборе.
- Держи под рукой шпаргалку. Команды на каждый день собраны на одной странице.
В ClaudeBase есть урок «Рабочее окружение: правила проекта и разрешения» и материал «Настройки Claude Code, Codex и VS Code». Они пригодятся после первого запуска: чтобы записать правила для своего проекта и настроить, какие действия агент согласует с тобой. Подписчику доступен код подключения базы к агенту через MCP - он сможет искать материалы под задачу. Как устроен доступ, написано на странице ClaudeBase.
Запустить Claude Code на своей модели из терминала - инструкция для Ollama.
Ветки и PR из терминала и @claude на GitHub.
Про баланс: Credit balance is too low.
Источники
Проверено по документации Anthropic 30 октября 2026 года. Команды и условия могут меняться; перед повторной установкой сверяй страницу для своей системы.