Claude Code: установка и первая сессия

• Терминал и папка с проектом. Лучше учебный репозиторий, который не жалко испортить.
• Аккаунт. По документации, подходят подписки Claude Pro, Max, Team и Enterprise, аккаунт Claude Console (доступ по API) или доступ через поддерживаемого облачного провайдера. Бесплатный тариф claude.ai Claude Code не включает.
• Система: macOS 13+, Windows 10 (1809+), Ubuntu 20.04+, Debian 10+ или Alpine 3.19+, от 4 ГБ памяти и интернет.
• На Windows документация рекомендует установить Git for Windows: тогда Claude Code использует Bash. Без него он работает через PowerShell. Режим песочницы на «родной» Windows не поддерживается, он есть в WSL 2.

Тарифы и цены не приводим: страницы тарифов меняются, ссылки есть в уроке 9.

Документация называет рекомендуемым «нативный» установщик. Команда запускает скрипт с сайта производителя, поэтому берите её только со страницы документации, а не из пересказов (в том числе из этого урока, если адрес изменится).

# macOS, Linux, WSL (нативный установщик)
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# Альтернативы: Homebrew, WinGet, npm (нужен Node.js 22 или новее)
brew install --cask claude-code
winget install Anthropic.ClaudeCode
npm install -g @anthropic-ai/claude-code

Нативная установка обновляется в фоне сама, Homebrew и WinGet — только вручную. Не ставьте npm-пакет через sudo: документация прямо предупреждает об этом. После установки откройте новое окно терминала и проверьте:

claude --version
claude doctor

Первая команда печатает номер версии с пометкой (Claude Code). Вторая выводит диагностику установки и настроек, не запуская сессию. Если оболочка не находит claude, значит, папка установки ещё не в PATH: раздел устранения неполадок в документации разбирает это отдельно.

Перейдите в папку проекта и запустите ассистента:

cd путь/к/проекту
claude

При первом запуске Claude Code предложит войти. Для подписки или Console следуйте подсказкам в браузере. Если у вас задана переменная окружения ANTHROPIC_API_KEY и вы подтвердите её использование, вход пропускается. Не вставляйте ключи в чат и в файлы проекта; хранение ключей разберём в уроке 6.

Первые запросы лучше делать на чтение: «что делает этот проект?», «где точка входа?», «объясни структуру папок». Агент сам читает нужные файлы. Затем попросите мелкую правку, например добавить функцию в учебный файл, и посмотрите, как он показывает изменение и спрашивает разрешение.

Команды оболочки запускают Claude Code, слэш-команды вводят внутри сессии.

Введите / — откроется меню команд, а Tab дополняет имя. Полный список в документации длиннее, чем таблица.

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

Откат правок делает контрольная точка. Перед каждым вашим запросом Claude Code запоминает состояние файлов, которые правит его инструмент редактирования. Дважды нажмите Esc при пустом вводе или введите /rewind: откроется список ваших запросов, и для каждого можно восстановить код, беседу или и то и другое. У механизма есть пределы, которые нужно знать:

• Файл, изменённый только командой оболочки (rm, mv, скрипт), контрольной точкой не отслеживается. Откатывайте такое через git.
• Правки, сделанные вами вручную или другой сессией, обычно не записываются.
• Действия во внешних системах (база, API, деплой) откатить нельзя.
• Контрольные точки хранятся ограниченное время и заменой git не являются.

Поэтому правило курса: перед каждой сессией состояние репозитория закоммичено (урок 7). Контрольная точка — быстрая отмена внутри сессии, git — настоящая страховка.

Следующий урок — Codex: установка и первая сессия. Если вы хотите, чтобы опытный инженер провёл вас через первые недели работы с агентом на вашем проекте, посмотрите техническое наставничество.