Терминал для Claude Code: открыть и запустить с нуля
Пошагово для человека, который окно команд раньше не открывал: где оно лежит на Windows и macOS, какой командой ставится Claude Code, из какой папки его запускать и что делать, когда терминал отвечает «command not found».
Терминал — это окно, в котором компьютеру дают команды текстом. Чтобы запустить в нём Claude Code, нужно сделать ровно четыре вещи: открыть терминал (Cmd + Пробел → Terminal на macOS, Win + X → «Терминал» на Windows), выполнить одну команду установки, командой cd перейти в папку проекта и набрать claude. Программировать для этого не надо, и Node.js ставить тоже не надо. Ниже — каждый шаг с разбором мест, где новички спотыкаются чаще всего.
Что узнаешь из гайда
- Как открыть терминал на Windows, macOS и Linux
- Чем PowerShell отличается от CMD и почему из-за этого падает установка
- Что такое рабочая папка и откуда НЕ надо запускать агента
- Клавиши сессии: прервать, выйти, перенести строку
- Что делать, если пишет command not found
Часть 1 · Основа
Что такое терминал и зачем он Claude Code
Главное
Терминал — это текстовый пульт к вашему компьютеру. Claude Code работает там, потому что ему нужно читать и менять файлы в вашей папке и запускать команды, а не показывать кнопки.
В обычной работе вы открываете папку двойным щелчком. В терминале то же самое делается словом: вы пишете cd Documents и оказываетесь в «Документах». Разница только в способе, набор действий тот же. Именно поэтому Claude Code — программа для терминала: агент должен уметь открыть файл, поправить его, запустить проверку и показать результат, и текстовый интерфейс для этого удобнее любого окна с кнопками.
Anthropic отдельно держит руководство для тех, кто терминал никогда не открывал — и первым же абзацем там сказано: пользоваться Claude Code можно, даже если вы не видели терминал ни разу. Этот гайд идёт тем же путём, но с русскими названиями пунктов меню и разбором ошибок, на которые официальная справка отвечает одной строкой.
Требования, которые стоит проверить заранее
macOS 13.0 и новее, Windows 10 версии 1809 и новее, Ubuntu 20.04+, Debian 10+ или Alpine 3.19+. Плюс 4 ГБ оперативной памяти и процессор x64 либо ARM64. Оболочка подойдёт любая из четырёх: Bash, Zsh, PowerShell или CMD. Отдельно: бесплатный план claude.ai доступ к Claude Code не даёт — нужна подписка Pro, Max, Team, Enterprise или учётная запись Console.
Часть 2 · Открыть окно
Как открыть терминал на своей системе
Главное
Три сочетания клавиш на три системы. Признак, что получилось, один и тот же: окно с мигающим курсором.
| Система | Что нажать |
|---|---|
| macOS | Cmd + Пробел, набрать Terminal, нажать Enter. Вставка в окно — Cmd + V |
| Windows | Win + X, выбрать «Терминал» или «Windows PowerShell». Вставка — Ctrl + V или правый клик |
| Linux | Ctrl + Alt + T либо «Терминал» в меню приложений. Вставка — Ctrl + Shift + V |
Ничего настраивать в этом окне перед установкой не надо. В официальной справке по конфигурации терминала первая же фраза звучит так: Claude Code работает в любом терминале без настройки, и страница нужна только если что-то конкретное ведёт себя не так, как вы ждёте. Так что тему «шрифты, темы, tmux» спокойно откладываем на потом.
Часть 3 · Развилка Windows
PowerShell или CMD: как понять, где вы
Главное
У Windows две командные программы, и они выглядят почти одинаково, но команды у них разные. Отличить можно по первым двум буквам строки: PS в начале — PowerShell, без PS — CMD.
Это самая частая причина, по которой у новичка «не ставится Claude». Человек берёт команду из первой попавшейся статьи, вставляет её не в ту оболочку и получает ошибку, которая ничего не объясняет. Anthropic на этот случай прямо перечисляет, какое сообщение что означает.
| Что написал терминал | Что это значит |
|---|---|
| The token «&&» is not a valid statement separator | Вы в PowerShell, а вставили команду для CMD. Возьмите вариант с irm |
| «irm» is not recognized as an internal or external command | Вы в CMD, а вставили команду для PowerShell. Возьмите вариант с curl ... install.cmd |
| A parameter cannot be found that matches parameter name «fsSL» | Тоже PowerShell: он подменяет curl своей командой и не понимает её флаги |
| «bash» is not recognized as the name of a cmdlet | Взята команда для macOS или Linux. На Windows нужна виндовая команда установщика |
Git for Windows ставить не обязательно
Claude Code запускается на Windows и без него. Git for Windows даёт Git Bash, и тогда агент выполняет команды через Bash; без него он использует PowerShell. Учить сам Git для этого не нужно. Подробности виндовой связки, включая WSL, — в гайде Claude Code на Windows.
Часть 4 · Установка
Одна команда установки на вашу оболочку
Главное
Скопировать одну строку, вставить в терминал, нажать Enter. По окончании появится Claude Code successfully installed!
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdФлаги в первой команде не украшение. -L внутри -fsSL заставляет curl идти по переадресации: 27 августа 2026 года мы дёрнули адрес с московского сервера и получили 302 на downloads.claude.ai, где и лежит настоящий скрипт установки. Без -L команда просто ничего не скачает.
Это не единственный способ: есть Homebrew, WinGet, пакеты для Linux и установка через npm. Сравнение способов, требования каждого и разбор пяти типовых ошибок — в отдельном гайде скачать и установить Claude Code. Здесь берём самый короткий путь, чтобы не уводить в сторону от терминала.
Node.js для этого не нужен
Русские инструкции часто начинаются с «сначала поставьте Node.js» — это лишний шаг и лишняя точка отказа. Мы проверили: на сервере, где команды node и npm вообще не существуют, установленный официальным скриптом Claude Code спокойно отвечает на claude --version. Node нужен только тем, кто сознательно ставит пакет через npm, — про этот путь и другие способы установки отдельный разбор в гайде скачать и установить Claude Code.
Часть 5 · Проверка
Убедиться, что всё встало
claude --versionОтвет вида 2.1.247 (Claude Code) означает, что программа на месте. Номер последнего выпуска на 27 августа 2026 года — именно 2.1.247: адрес downloads.claude.ai/claude-code-releases/latest отдаёт его обычным текстом, и это же официальная диагностическая проверка сетевого доступа из документации. Из Москвы адрес отвечает HTTP/2 200 без всяких обходных путей.
Если хочется более подробной картины — что именно установлено, куда, в каком состоянии конфигурация, — есть встроенная диагностика:
claude doctorЧасть 6 · Где запускать
Рабочая папка: откуда запускать claude
Главное
Claude Code видит ту папку, из которой вы его запустили, и всё, что внутри неё. Поэтому сначала cd в проект, потом claude — а не наоборот.
# перейти в папку проекта
cd Documents/moy-proekt
# посмотреть, что внутри
ls
# запустить агента уже здесь
claudecd Documents\moy-proekt
dir
claudeКоманда cd — от change directory, «сменить папку». Чтобы подняться на уровень выше, пишут cd .. с двумя точками. Чтобы проверить, где вы сейчас находитесь, на macOS и Linux помогает pwd, на Windows — cd без аргументов. Этих трёх команд хватает на всю работу.
Откуда запускать не надо
Из домашней папки целиком и с рабочего стола. Агент в этом случае получает в обзор все ваши документы, загрузки и случайные архивы: контекст засоряется, ответы становятся хуже, а риск случайной правки не того файла растёт. Заведите отдельную папку под проект — этого достаточно.
Часть 7 · Первый запуск
Первая сессия: вход и первая задача
Наберите claude и нажмите Enter. При первом запуске откроется браузер с формой входа в учётную запись Claude — дальше по подсказкам на экране. После входа вы окажетесь на приветственном экране, и с этого момента можно писать задачи обычными словами по-русски.
Сессия целиком текстовая: мышкой в ней ничего нажать нельзя, перемещение — стрелками. Перед тем как создать или изменить файл, агент спросит разрешение, и подтверждение — это Enter на варианте «Yes». Хорошая первая задача звучит буквально так: «сделай простую html-страницу, которая пишет привет» — файл появится в текущей папке, и его можно открыть двойным щелчком.
Четыре команды, которых хватит на первый вечер
claude — запустить сессию. /help — список доступных команд. Esc — прервать агента, не выходя из сессии. exit или двойной Ctrl + D — закрыть сессию. Всё остальное можно узнавать по мере надобности; полный набор — в методичке все команды Claude Code.
Часть 8 · Клавиши
Перенос строки и другие клавиши сессии
Главное
Enter отправляет сообщение. Чтобы перенести строку внутри одного сообщения, жмите Ctrl + J — работает везде. Shift + Enter работает не во всех терминалах.
Это первое, обо что спотыкаются люди с опытом мессенджеров: привычный Shift + Enter иногда просто отправляет недописанный текст. Поддержка зависит от эмулятора терминала, и Anthropic ведёт по ним отдельную таблицу.
| Терминал | Shift + Enter |
|---|---|
| Windows Terminal, Apple Terminal, iTerm2, Ghostty, Kitty, WezTerm, Warp | Работает сразу, без настройки |
| VS Code, Cursor, Alacritty, Zed | Включается разовой командой /terminal-setup внутри сессии |
| gnome-terminal, терминалы JetBrains (PyCharm, Android Studio) | Недоступен. Используйте Ctrl + J или обратный слеш и Enter |
Команду /terminal-setup нужно выполнять именно в том терминале, который вы используете, и не изнутри tmux или screen — ей нужно записать настройку в конфигурацию самого окна. Остальные тонкости интерфейса — тема гайда горячие клавиши Claude Code.
Часть 9 · Разбор ошибки
Если терминал пишет command not found
Главное
Программа установлена, но оболочка не знает, где её искать. Лечится добавлением каталога установки в PATH и открытием нового окна терминала.
PATH — это список папок, в которых оболочка ищет команды. Установщик кладёт файл в ~/.local/bin/claude на macOS и Linux и в %USERPROFILE%\.local\bin\claude.exe на Windows. Если этой папки в списке нет, вы получаете command not found: claude на macOS и Linux или «claude» is not recognized на Windows — при полностью рабочей установке.
Мы воспроизвели это на живом сервере: команда which -a claude не вывела ничего, хотя файл лежал на месте и был символической ссылкой на ~/.local/share/claude/versions/2.1.245. Дело было ровно в отсутствии каталога в PATH у той оболочки.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --versionecho 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
claude --versionНа Windows каталог добавляется в пользовательскую переменную PATH через PowerShell или через «Переменные среды» в системных настройках, после чего терминал надо перезапустить. Остальные типовые сбои установки — конфликт двух установок, ошибки прав, HTML вместо скрипта — разобраны в гайде скачать и установить Claude Code.
Отдельная ловушка: расширение для VS Code не кладёт claude в PATH. Оно носит внутри свою копию CLI для собственной панели чата, поэтому после установки только расширения файла ~/.local/bin/claude просто не существует.
Часть 10 · Альтернатива
Если терминал не нужен вообще
Терминал — не единственный вход. У Claude есть настольное приложение для macOS, Windows и Linux, и Claude Code встроен прямо в него: вкладка Code, выбор папки мышкой, наглядный просмотр правок, параллельные сессии. Node.js и отдельный CLI при этом не нужны — приложение уже содержит всё необходимое.
Разумная развилка выглядит так. Нужен просто ассистент по файлам и коду, командная строка пугает — берите приложение, разбор в гайде Claude Desktop, а различия вкладок Chat, Cowork и Code разобраны в гайде режимы Claude. Нужны запуск на сервере по SSH, свои скрипты и автоматизация — тогда терминал, и этот гайд как раз про него.
Короткий порядок на весь гайд
Открыть терминал → на Windows понять, PowerShell это или CMD → выполнить свою команду установки → проверить claude --version → cd в папку проекта → набрать claude и войти в учётную запись → писать задачи текстом, Esc прерывает, exit закрывает.
FAQ
Частые вопросы
Что такое терминал простыми словами?
Терминал — это окно, в котором вы даёте компьютеру команды текстом, а не мышкой. На macOS программа так и называется «Терминал», на Windows это PowerShell или приложение «Терминал», на Linux — «Терминал» в меню приложений. Claude Code живёт именно там, потому что ему нужно читать файлы и запускать команды в вашей папке, а не рисовать интерфейс. Уметь программировать для этого не нужно: команд для старта ровно три.
Как открыть терминал для Claude Code на Windows?
Нажмите Win + X и выберите в меню «Терминал» или «Windows PowerShell». Откроется окно с мигающим курсором. Проверьте, где вы оказались: строка вида PS C:\Users\Имя> означает PowerShell, строка C:\Users\Имя> без PS — это CMD. Это важно, потому что команда установки у них разная, а чужая команда выдаст ошибку.
Как открыть терминал на Mac?
Нажмите Cmd + Пробел, наберите Terminal и нажмите Enter. Откроется окно с мигающим курсором — это и есть терминал. Вставка в него работает через Cmd + V, на Linux — через Ctrl + Shift + V. Никаких настроек перед установкой Claude Code делать не нужно: он работает в любом терминале без конфигурации.
Какой командой запустить Claude Code в терминале?
Командой claude. Наберите её в терминале и нажмите Enter — при первом запуске откроется браузер для входа в учётную запись. Перед этим командой cd перейдите в папку проекта, потому что Claude Code работает с тем каталогом, из которого запущен. Проверить, что программа вообще установлена, можно командой claude --version.
Терминал пишет command not found: claude. Что делать?
Установка прошла, но каталог с программой не попал в переменную PATH — список мест, где оболочка ищет команды. Установщик кладёт файл в ~/.local/bin/claude на macOS и Linux и в %USERPROFILE%\.local\bin\claude.exe на Windows. Нужно добавить этот каталог в PATH и открыть новое окно терминала. Разбор остальных ошибок установки — в гайде скачать и установить Claude Code.
Как выйти из Claude Code в терминале?
Наберите exit и нажмите Enter либо дважды нажмите Ctrl + D на пустой строке. Если нужно не выйти, а прервать работу агента посреди задачи, нажмите Esc — сессия при этом останется открытой. Команда /help показывает полный список доступных команд внутри сессии.
Почему Shift + Enter не переносит строку в Claude Code?
Enter в Claude Code отправляет сообщение. Перенос строки без отправки гарантированно даёт Ctrl + J или обратный слеш и следом Enter — эти два способа работают в любом терминале. Shift + Enter зависит от эмулятора: в Windows Terminal, Apple Terminal, iTerm2, Ghostty, Kitty, WezTerm и Warp он работает сразу, во встроенных терминалах VS Code, Cursor, Alacritty и Zed включается разовой командой /terminal-setup, а в gnome-terminal и терминалах JetBrains недоступен вовсе.
Можно ли пользоваться Claude Code вообще без терминала?
Да. У Claude есть настольное приложение для macOS, Windows и Linux, внутри которого Claude Code работает с графическим интерфейсом: вкладка Code, выбор папки мышкой, просмотр правок и параллельные сессии. Node.js и отдельный CLI для этого не нужны. Терминал остаётся нужен, если вы хотите запускать команду claude вручную, работать по SSH на сервере или встраивать агента в скрипты.
Читать дальше
Платформа и сообщество, где я по шагам показываю, как поставить ИИ на рутину: контент, код, продажи, аналитика. Заходи и забирай рабочие связки, которыми пользуюсь сам.
Посмотреть, что внутриtelegram
Канал с полезными материалами про нейросети
Разборы, новые инструменты и приёмы по ИИ — то, чем пользуюсь сам, без воды. Подпишись, чтобы не потерять.
