Claude Code: установка, настройка и первый запуск

Claude Code — агент Anthropic для работы с кодом. В терминале он читает проект, редактирует файлы и запускает команды: например, сборку, тесты или Git.

Ниже — установка на Windows, macOS и Linux, первый запуск и настройка CLAUDE.md. Начнём с небольшой задачи, чтобы проверить работу агента и разобраться в разрешениях.

Требования и доступ к Claude Code

Нужен платный доступ. Подойдёт подписка Claude Pro, Max, Team или Enterprise либо аккаунт Claude Console с оплатой за использование API. Бесплатный тариф claude.ai Claude Code не включает.
География. Сервис работает в странах из списка поддерживаемых Anthropic. России и Беларуси в нём нет, поэтому официально из России Claude Code недоступен. Учитывай это заранее, особенно для рабочих проектов.
Система. macOS 13 и новее, Windows 10 версии 1809 и новее, Ubuntu 20.04+, Debian 10+, Alpine 3.19+. Нужно не меньше 4 ГБ оперативной памяти и подключение к интернету.

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

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

Рекомендуемый способ — официальный установщик. Он ставит готовую программу и сам обновляет её в фоне. Node.js для него не нужен.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

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

Другие варианты — через менеджеры пакетов. Они не обновляются сами: обновлять нужно командой менеджера.

# macOS, Homebrew; обновление: brew upgrade claude-code
brew install --cask claude-code

# Windows, WinGet; обновление: winget upgrade Anthropic.ClaudeCode
winget install Anthropic.ClaudeCode

Есть и пакет npm @anthropic-ai/claude-code, ему нужен Node.js 22 или новее. Устанавливать его через sudo npm install -g не стоит: это приводит к проблемам с правами.

После установки открой новое окно терминала и проверь:

claude --version   # покажет версию, например 2.1.289 (Claude Code)
claude doctor      # проверит установку и настройки

Если терминал отвечает, что команда claude не найдена, папка установки не попала в PATH. Обычно помогает закрыть и снова открыть терминал. На Windows стоит поставить Git for Windows: с ним Claude Code выполняет команды через Bash, без него — через PowerShell.

Первый запуск в папке проекта

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

cd ~/Projects/my-site
claude

При первом запуске пройди вход в аккаунт. Для повторного входа используй /login внутри сессии.

Запускай агента из корня проекта: эта папка определяет основной рабочий контекст. Так ему проще найти исходники и правила, а тебе — контролировать область изменений.

Начни с вопросов, а не с правок. Писать можно по-русски:

«Что делает этот проект и как он устроен?»
«Как собрать проект и запустить локально?»
«Где в теме выводится шапка сайта?»

Файлы добавлять в разговор не нужно: агент сам находит и читает нужные. Потом можно переходить к задаче: «Добавь в шапку ссылку на Telegram, стили — как у соседних ссылок».

Режимы работы и разрешения

Claude Code может менять файлы и запускать команды. Режим разрешений определяет, какие действия выполняются сразу, а какие требуют подтверждения. Доступные режимы переключаются через Shift+Tab; их набор зависит от версии и настроек.

в ручном режиме default запросы разрешений зависят от инструмента и ранее заданных правил;
в режиме планирования сначала изучает код и предлагает план, а правит только после одобрения — удобно для больших задач;
в автоматическом режиме auto потенциально значимые действия проверяются автоматически. Доступность и стартовый режим зависят от плана и настроек; подробности — в документации разрешений.

Перед крупной задачей сохрани рабочее состояние в Git и проверь изменения через diff. Коммит поможет вернуть код, но не отменит действия во внешних сервисах или изменения базы данных.

CLAUDE.md — инструкции для проекта

Правила проекта удобно хранить в CLAUDE.md в корне репозитория. Они помогают агенту учитывать команды сборки, структуру каталогов и договорённости команды.

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

# Сайт my-site

- Тема WordPress лежит в wp-content/themes/mytheme, сборка: npm run build.
- Стили пишем в src/scss, файлы в build/ руками не правим.
- Префикс функций темы — mytheme_.
- Перед завершением задачи запускать npm run build и проверять страницу локально.
- Не коммитить без моего подтверждения.

Держи файл коротким и конкретным. Убирай повторы и устаревшие указания; подробные инструкции можно вынести в отдельные файлы со ссылками.
Личные правила для всех проектов кладут в ~/.claude/CLAUDE.md, например «отвечай по-русски».
Личные правила для одного проекта, которые не нужно коммитить, кладут в CLAUDE.local.md и добавляют его в .gitignore.

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

Команда	Что делает
`claude`	Запускает интерактивную сессию
`claude "задача"`	Запускает сессию сразу с задачей
`claude -p "вопрос"`	Отвечает один раз и завершает работу; удобно в скриптах
`claude -c`	Продолжает последний разговор в этой папке
`claude -r`	Показывает прошлые разговоры, чтобы продолжить один из них
`/clear`	Очищает разговор, чтобы начать новую задачу
`/help`	Показывает все команды
`/exit`	Завершает сессию

Как ставить задачи и проверять изменения

Конкретная задача. Не «исправь баг», а «после ввода неверного пароля форма входа показывает пустой экран — найди причину и исправь».
Сначала изучить, потом менять. Попроси разобраться в коде и предложить план, а правки разреши после.
Одна задача — один разговор. Между несвязанными задачами вызывай /clear: длинная история мешает агенту сосредоточиться.
Проверка результата. Попроси запустить тесты или сборку и сам посмотри изменения перед коммитом. Чаще всего агент ошибается не в синтаксисе, а в догадках о том, что ты имел в виду.
Секреты отдельно. Не вставляй пароли и ключи в запросы и держи их в файлах, которые не попадают в git.

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

Обновление и удаление

Версия из официального установщика обновляется сама. Обновить сразу можно командой claude update.
Удалить её на macOS и Linux: rm -f ~/.local/bin/claude и rm -rf ~/.local/share/claude.
Настройки и история хранятся в ~/.claude и ~/.claude.json. Удаляй их, только если не нужны прежние настройки.