Claude Code: с чего начать — гайд для новичка

Коротко

Claude Code — это терминальный ИИ-агент от Anthropic, который читает код вашего проекта, правит файлы и запускает команды прямо в консоли. Чтобы начать: установите CLI (curl -fsSL https://claude.ai/install.sh | bash на macOS/Linux или npm install -g @anthropic-ai/claude-code), запустите команду claude в папке проекта, войдите через подписку Claude Pro/Max или API-ключ, выполните /init — и можно давать первую задачу обычным текстом. Дальше подключаете MCP-серверы (claude mcp add) и скилы, чтобы агент видел свежую документацию, базу данных и браузер. Ниже — пошагово, с таблицей команд.

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

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

Что понадобится на старте:

• Терминал (на Windows подойдёт PowerShell или Windows Terminal).
• Платный доступ: подписка Claude Pro, Max, Team, Enterprise или ключ Anthropic API из консоли. На бесплатном тарифе Claude.ai доступа к Claude Code нет — это честная оговорка, о неё спотыкаются почти все новички.
• Для npm-установки — Node.js 22+ (нативный установщик Node.js не требует).

Если вы ещё выбираете между Claude Code, Cursor и VS Code, посмотрите разбор в статье Claude Code vs Cursor vs VS Code — там про переносимость навыков и когда что удобнее.

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

На момент публикации (июль 2026) рекомендуемый способ — нативный установщик: он ставит платформенный бинарник и не зависит от Node.js. npm-пакет тоже работает и под капотом устанавливает тот же бинарник.

Важно: npm-пакет ставят без sudo — установка через sudo ломает права и потом мешает обновлениям. После установки проверьте версию:

claude --version

Если команда вернула номер версии — CLI на месте. Обновляется он сам, но принудительно можно вызвать claude update.

Как авторизоваться в Claude Code?

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

claude

При первом запуске CLI предложит войти. Есть два пути:

1. Подписка (Pro/Max). Откроется браузер, вы подтверждаете вход через аккаунт Anthropic по OAuth. Самый простой вариант, если у вас уже есть подписка.
2. API-ключ. Переменная окружения ANTHROPIC_API_KEY используется для прямого доступа к API с ключом из консоли Anthropic. Оплата идёт по токенам. Переключить или задать ключ позже можно через /config.

Сменить способ входа в любой момент помогает команда /login. Всё, авторизация — разовая процедура, дальше CLI помнит ваш выбор.

Первый проект и базовые команды

Зайдите в папку проекта (например, cd my-app) и запустите claude. Первым делом выполните команду /init — она создаёт файл CLAUDE.md.

CLAUDE.md — это файл памяти проекта: агент читает его в начале каждой сессии и держит там правила, стек, соглашения по коду. Чем аккуратнее этот файл, тем реже агент делает не то, что вы ждёте. Дальше просто пишите задачу человеческим языком, например: «добавь роут /health, который возвращает статус 200 и версию приложения».

Качество ответа сильно зависит от того, как поставлена задача. Если агент постоянно «не понимает», сначала прочитайте как ставить задачу, чтобы агент понял — это экономит больше времени, чем любые настройки.

Команды в Claude Code начинаются со слэша. Вот минимум, который стоит запомнить сразу:

Две команды спасают чаще всего: /clear — когда диалог «поехал» и агент путается в старом контексте, и /compact — когда сессия длинная и контекст вот-вот переполнится. Подробный разбор возможностей CLI и практических приёмов есть в карточке Claude Code в арсенале.

Как подключить MCP-серверы?

MCP (Model Context Protocol) — это стандарт, по которому агент получает доступ к внешним инструментам: документации, базам данных, браузеру, GitHub. Без MCP агент знает только ваши файлы; с MCP он может, например, читать актуальные доки библиотеки или гонять реальные запросы к БД.

Подключение — одной командой. Базовый синтаксис:

claude mcp add <имя> <транспорт и параметры>

Транспортов три: stdio (локальный процесс или npm-пакет), http (облачные инструменты, рекомендуется) и sse (устаревший, берите http, если есть выбор). У серверов есть область видимости — scope:

• по умолчанию — local: сервер виден только вам и только в текущем проекте;
• --scope user — во всех ваших проектах (хранится в ~/.claude.json);
• --scope project — в файле .mcp.json в корне проекта, коммитится в git и работает у всей команды.

Проверить, что подключилось, можно командой /mcp внутри сессии или claude mcp list в терминале.

С чего начать новичку: context7 даёт агенту свежую документацию библиотек (лечит галлюцинации по устаревшим API), а github — работу с issue и pull request. Карточки обоих серверов и полный каталог с командами подключения — в разделе MCP-серверы. И обязательно прочитайте про безопасное подключение MCP: сторонний сервер получает доступ к вашему окружению, и доверять ему вслепую не стоит.

Какие скилы поставить новичку?

Скилы (Skills) — это упакованные наборы инструкций под конкретную задачу: ревью кода, генерация коммитов, SEO-аудит. Плагины — это формат доставки, а скилы — содержимое: плагины вы устанавливаете, а скилами пользуетесь. Вызываются они слэш-командой с неймспейсом, например /commit-commands:commit.

Установка идёт через маркетплейс:

/plugin install <имя>@<маркетплейс>

Официальный маркетплейс подключён из коробки. После установки вызовите скил его слэш-командой — он выполняет свою работу и останавливается. Начните с малого: один-два скила под ваши повторяющиеся задачи, а не всё подряд — иначе список команд разрастётся и вы в нём утонете. Обзор проверенных вариантов — в разделе Скилы Claude.

Как не потратить неделю на настройку?

Честная правда: установить Claude Code — минут пять. А вот довести его до состояния, когда он стабильно делает то, что нужно, — это уже недели проб. Нужно написать грамотный CLAUDE.md, подобрать и связать MCP-серверы, настроить субагентов, скилы и команды под свой стек и не сломать безопасность. Для новичка это самая дорогая по времени часть.

Именно эту сборку закрывает наш движок Quest — готовый набор правил, агентов, MCP-связок и скилов для Claude Code и Cursor, собранный так, чтобы агент работал предсказуемо с первого дня. Можно собрать конфигурацию под свой проект в студии или посмотреть, что входит в движок. Это не замена этому гайду — скорее способ пропустить месяц набивания шишек. А базовые команды и MCP всё равно полезно знать: движок ими и пользуется.

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

Нужна ли платная подписка для Claude Code?

Да. Работает с подпиской Claude Pro, Max, Team, Enterprise или с ключом Anthropic API (оплата по токенам). На бесплатном тарифе Claude.ai доступа к Claude Code нет.

Чем ставить — через npm или нативным установщиком?

На момент июля 2026 рекомендуется нативный установщик (install.sh / install.ps1) — он не требует Node.js. npm-пакет тоже поддерживается и ставит тот же бинарник под капотом; выбирайте его, если у вас уже настроен Node.js 22+.

Обязательно ли подключать MCP, чтобы начать?

Нет. Для первых задач хватит чистого CLI: агент уже видит ваши файлы, правит код и запускает команды. MCP добавляют позже, когда нужна свежая документация, доступ к БД или браузеру.

Что делать, если агент делает не то?

Сначала выполните /clear, чтобы сбросить накопившийся контекст. Затем уточните формулировку задачи и запишите правила проекта в CLAUDE.md — большинство «непониманий» лечится именно этим, а не сменой модели.

Как понять, что закончился контекст?

Команда /context показывает, сколько контекстного окна занято. Когда цифра близка к пределу, выполните /compact — CLI сожмёт историю диалога, сохранив суть, и вы продолжите без потери нити.