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

Claude Code — агент для программирования от Anthropic. Он работает в терминале (а также в приложении для компьютера, в VS Code и JetBrains): читает ваш проект, отвечает на вопросы по коду, сам правит файлы, запускает команды и тесты, делает коммиты. В отличие от чата, где код приходится копировать туда-обратно, Claude Code работает прямо в папке проекта и доводит задачу до результата.

Это руководство для новичка: что нужно для старта, как установить Claude Code на Windows, macOS и Linux, как войти, первые команды, CLAUDE.md, режимы разрешений, MCP и как не упираться в лимиты. Все команды сверены с официальной документацией Anthropic на сентябрь 2026 года.

Что нужно для старта

• Аккаунт с доступом. Подписка Claude Pro, Max, Team или Enterprise (Claude Code входит в тариф) либо аккаунт Claude Console с предоплаченным балансом API. Бесплатного тарифа для Claude Code нет. Если вы в России, способы оплаты разобраны в статье как оплатить Claude из России.
• Система. macOS 13+, Windows 10 1809+ (или Windows Server 2019+), Ubuntu 20.04+, Debian 10+, Alpine 3.19+.
• Железо. От 4 ГБ оперативной памяти, процессор x64 или ARM64. Модель работает в облаке Anthropic, так что мощная видеокарта не нужна.
• Интернет и терминал: Bash, Zsh, PowerShell или CMD.

Важно: в официальных требованиях указано, что Claude Code работает из стран, которые поддерживает Anthropic. Россия в этот список не входит — учитывайте это и прочитайте раздел про блокировки аккаунтов в статье об оплате.

Установка Claude Code

Рекомендуемый способ — нативный установщик: он сам обновляет Claude Code в фоне.

Система	Команда
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 (macOS)	brew install --cask claude-code
WinGet (Windows)	winget install Anthropic.ClaudeCode

Проверьте установку:

claude --version

Команда должна вывести номер версии с пометкой «(Claude Code)». Установки через Homebrew и WinGet сами не обновляются — периодически запускайте brew upgrade claude-code или winget upgrade Anthropic.ClaudeCode.

Особенности Windows

• Права администратора не нужны.
• Если PowerShell пишет, что && — неверный разделитель, вы запускаете команду для CMD в PowerShell. Если CMD не знает команду irm — наоборот. В PowerShell строка начинается с PS C:\.
• Желательно поставить Git for Windows: тогда Claude Code использует Bash для команд. Без него он работает через PowerShell.
• Можно работать и внутри WSL 2 — это удобно, если проект на Linux-инструментах, и только в WSL 2 поддерживается песочница для команд.

Не любите терминал? У Claude Code есть приложение для компьютера (macOS, Windows, Linux) и расширения для VS Code и JetBrains — функции те же, интерфейс графический.

Вход в аккаунт

Откройте терминал в папке проекта и запустите Claude Code:

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

При первом запуске откроется браузер для входа. Выберите способ, которым у вас оплачен доступ: подписка Claude (Pro, Max, Team, Enterprise) или Claude Console с API-балансом. После входа данные сохраняются, повторно логиниться не нужно. Сменить аккаунт — команда /login внутри сессии. Если в системе задана переменная ANTHROPIC_API_KEY, Claude Code предложит использовать этот ключ вместо входа.

Первая сессия: с чего начать

1. Разберитесь в проекте. Спросите обычным языком: «что делает этот проект?», «какие технологии используются?», «где обрабатывается авторизация?». Claude сам прочитает нужные файлы.
2. Создайте CLAUDE.md. Команда /init — Claude изучит проект и запишет в файл CLAUDE.md главное: как собрать, как запустить тесты, стиль кода. Этот файл он читает в начале каждой сессии.
3. Маленькая правка. «Добавь проверку пустого email в форме регистрации». Claude покажет изменения и спросит разрешение на запись файла.
4. Тесты и git. «Запусти тесты и почини упавшие», «сделай коммит с понятным сообщением», «создай ветку для этой задачи».

Совет из документации Anthropic: формулируйте конкретно. Не «почини баг», а «почини баг, из-за которого после неверного пароля пользователь видит пустой экран». Большие задачи разбивайте на шаги, а перед изменениями просите Claude сначала изучить код.

Основные команды

Команда	Что делает
claude	Запустить интерактивную сессию
claude "задача"	Запустить сессию сразу с задачей
claude -p "вопрос"	Выполнить один запрос и выйти — удобно для скриптов и CI
claude -c	Продолжить последний разговор в этой папке
claude -r	Выбрать и продолжить один из прошлых разговоров
/help	Список команд внутри сессии
/init	Создать CLAUDE.md с описанием проекта
/clear	Очистить историю разговора — начать задачу с чистого листа
/login	Войти или сменить аккаунт
/exit или Ctrl+D дважды	Выйти

Полезные клавиши: / показывает доступные команды и скиллы, Tab дополняет команду, стрелка вверх листает историю, Shift+Tab переключает режим разрешений.

Режимы разрешений: сколько свободы дать агенту

По умолчанию Claude Code спрашивает разрешение перед изменением файлов и выполнением команд. Это безопасно, но на длинных задачах утомляет. Shift+Tab переключает режимы: можно разрешить правку файлов без подтверждения или включить режим плана, в котором Claude сначала только исследует и предлагает план, ничего не меняя. Новичкам советуем: для незнакомого проекта — режим плана, для рутинной работы в своём репозитории с git — автоматическая правка файлов, а команды, которые что-то удаляют или отправляют наружу, всегда подтверждайте вручную.

CLAUDE.md: главный инструмент качества

CLAUDE.md — это инструкция для агента, которая лежит в корне проекта. Чем точнее она, тем реже Claude ошибается. Что туда писать:

• как собрать и запустить проект, как запускать тесты и линтер;
• стиль кода и договорённости команды;
• что нельзя трогать (сгенерированные файлы, миграции, секреты);
• особенности окружения: «в проде PostgreSQL, локально SQLite».

Если Claude повторяет одну и ту же ошибку — добавьте правило в CLAUDE.md, и в следующих сессиях он её учтёт.

Расширения: MCP, скиллы, субагенты

• MCP-серверы подключают внешние инструменты: базу данных, браузер, GitHub, Figma, трекер задач. Что это и какие стоит подключить — в статье лучшие MCP-серверы для AI-агентов.
• Скиллы — готовые навыки с инструкциями, которые Claude подгружает под задачу. Пример — Graphify, который строит граф знаний по проекту.
• Субагенты — помощники с отдельным контекстом, которым Claude поручает части большой задачи.
• Автоматизация в CI. Официальный GitHub Action запускает Claude Code в pull request — подробнее в статье ИИ-агенты для тестирования.

Лимиты и расходы

На подписке у Claude Code есть лимиты использования, которые обновляются через промежутки времени. Pro подходит для периодической работы, Max (от $100 в месяц) — для тех, кто кодит с Claude каждый день: он даёт в 5 или 20 раз больше лимитов, чем Pro. При работе через Console вы платите за токены. Как тратить меньше:

• начинайте новую задачу с /clear, чтобы не таскать за собой старый контекст;
• давайте узкие задачи и указывайте, какие файлы смотреть;
• держите CLAUDE.md коротким и по делу;
• для простых задач выбирайте более быструю модель.

Можно ли запускать Claude Code на локальной модели

Да, через Ollama: она умеет подключать Claude Code к локальным и облачным открытым моделям одной командой ollama launch claude. Бесплатно и без отправки кода в облако, но качество зависит от модели и вашего железа, а для больших репозиториев нужен контекст от 64 тысяч токенов. Как поставить Ollama — в статье Ollama: установка и первые шаги.

Claude Code или другие агенты

У Claude Code есть сильные конкуренты: OpenAI Codex, Cursor, GitHub Copilot, открытые Cline и OpenCode. Если коротко: Claude Code силён в работе с большим репозиторием из терминала и в многошаговых задачах, Cursor удобнее тем, кто живёт в редакторе, Codex — тем, у кого уже есть подписка ChatGPT. Сравнение Claude Code с агентом общего назначения — в статье Claude Code или OpenClaw.

Частые вопросы

Сколько стоит Claude Code?

Отдельно он не продаётся: входит в подписки Claude Pro ($20 в месяц или $17 при оплате за год), Max (от $100) и командные тарифы. Второй вариант — Claude Console с оплатой за токены.

Есть ли бесплатный Claude Code?

Официально нет: бесплатный тариф Claude не включает Claude Code. Бесплатно можно запускать Claude Code на локальных открытых моделях через Ollama, но это другие модели, не Claude.

Как установить Claude Code на Windows?

Откройте PowerShell и выполните irm https://claude.ai/install.ps1 | iex (права администратора не нужны). Для CMD есть своя команда, также можно поставить через WinGet. Желательно установить Git for Windows.

Нужно ли знать программирование, чтобы пользоваться Claude Code?

Для простых задач — нет, достаточно описывать, что нужно, обычным языком. Но чтобы проверять результат и не пропустить ошибку, базовое понимание кода и git сильно помогает.

Чем Claude Code отличается от обычного Claude в чате?

Чат только отвечает, а Claude Code действует: сам читает файлы проекта, правит их, запускает команды и тесты, работает с git. Это агент, а не собеседник.

Работает ли Claude Code в России?

Россия не входит в список стран, которые поддерживает Anthropic. Пользователи из РФ оплачивают подписку через посредников и зарубежные карты, но риск блокировки аккаунта есть — подробности в статье про оплату Claude.