Установка и подготовка Claude Code

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

В этой главе мы поставим Claude Code, войдём в аккаунт, разберёмся, когда он спрашивает разрешение, а когда действует сам, и подготовим папку игры так, чтобы агент с первой сессии знал правила Яндекс Игр.

Чем это отличается от чата в браузере

Разница не в модели, а в доступе. У агента в терминале есть инструменты: он читает и пишет файлы, ищет по проекту, запускает команды оболочки и видит их результат. Из этого складывается цикл, который в чате приходится крутить руками — скопировать код, вставить, запустить, скопировать ошибку обратно.

Для игры под Яндекс Игры выигрыш конкретный: агент видит проект целиком и не выдумывает названия ваших функций, сам запускает локальный сервер и ловит ошибки в консоли, а требования к сборке можно описать один раз и дальше применять командой.

Чего он не делает: не проходит модерацию за вас и не заменяет проверку в реальном окружении. Требования платформы проверяет живой модератор, а поведение рекламы и сохранений видно только в черновике на самой площадке.

Что нужно до установки

Claude Code требует платного аккаунта: подписки Claude Pro, Max, Team или Enterprise либо аккаунта Claude Console с предоплаченными кредитами. Бесплатный тариф Claude.ai доступ к Claude Code не включает. Отдельный вариант — подключение через Amazon Bedrock, Google Cloud Agent Platform или Microsoft Foundry, но для одиночной разработки игры это лишнее усложнение.

Системные требования по официальной документации:

Про регион: Anthropic публикует список стран, где сервис доступен, и он периодически меняется. Проверьте его до оплаты подписки, а не после — это сэкономит вам разбирательства с возвратом.

Установка

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

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

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Альтернативные способы, если нативный установщик по какой-то причине не подходит:

Про npm-пакет стоит сказать отдельно, потому что многие материалы до сих пор подают его как основной путь. Он рабочий, но с оговорками: начиная с версии 2.1.198 пакет требует Node.js 22 или новее (на более старой версии npm выдаст предупреждение EBADENGINE, но установка пройдёт). При этом @anthropic-ai/claude-code ставит тот же нативный бинарник, что и установщик, — Node нужен только для установки, во время работы claude его не использует. И не запускайте установку через sudo npm install -g: это создаёт проблемы с правами.

Проверка

claude --version

Рабочая установка печатает номер версии и подпись, например 2.1.211 (Claude Code). Более подробная диагностика — без запуска сессии, только чтение:

claude doctor

Она покажет, откуда установлен бинарник, есть ли ошибки в файлах настроек и что пошло не так при последней попытке обновления.

Отдельно про Windows

Claude Code работает на Windows нативно, ставить WSL необязательно. Но есть нюанс: без Git for Windows агент выполняет команды через PowerShell, а с ним — через Git Bash, и тогда становится доступен привычный POSIX-инструментарий. Для разработки игры под Яндекс Игры разницы почти нет, но Git вам всё равно понадобится для версионирования, так что поставить его стоит.

Если Claude Code не нашёл Git Bash сам, путь указывается в settings.json:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Второй вариант на Windows — поставить всё внутрь WSL 2 и запускать claude в терминале WSL. Смысл в этом есть, если проект и без того живёт в Linux-окружении; для HTML5-проекта без сборки нативной установки достаточно.

Обновления

Нативная установка проверяет обновления при старте и периодически во время работы, скачивает их в фоне, и новая версия применяется при следующем запуске. Установки через Homebrew, WinGet и системные пакетные менеджеры обновляются вручную.

Применить обновление немедленно:

claude update

Есть два канала: latest (по умолчанию, новые версии сразу) и stable (примерно недельная задержка, релизы с крупными регрессиями пропускаются). Для работы над игрой, которую вы собираетесь отправлять на модерацию, stable — разумный выбор: меньше шансов поймать свежий баг инструмента посреди подготовки сборки. Канал задаётся в ~/.claude/settings.json:

{
  "autoUpdatesChannel": "stable"
}

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

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

cd path/to/my-game
claude

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

Полезные команды вокруг аккаунта:

claude auth status   # показать, под кем вы вошли
claude auth login    # войти или сменить аккаунт
claude auth logout   # выйти

Внутри уже запущенной сессии для смены аккаунта есть slash-команда /login.

Как выглядит работа

Claude Code — интерактивная сессия: вы пишете задачу обычным текстом, агент читает нужные файлы сам, вручную «прикреплять контекст» не надо. Основные команды запуска:

Режим -p пригодится позже, когда будете собирать проверки перед отправкой на модерацию: он работает в пайпах, например cat build.log | claude -p "объясни ошибку".

Первая задача

Проверить связку проще всего на чём-то безобидном. Создайте пустую папку, запустите в ней claude и попросите:

создай минимальный index.html с канвасом на весь экран
и подписью «привет» по центру, без внешних зависимостей

Агент покажет, какой файл собирается создать. Если он спросит подтверждения — согласитесь. Дальше откройте файл в браузере: если подпись на месте, всё работает.

Отсюда стоит вынести две привычки. Первая — формулировать задачу проверяемо и с ограничениями: «без внешних зависимостей», «в одном файле», «не меняй index.html». Для Яндекс Игр это особенно важно, потому что половина требований платформы — про то, чего в сборке быть не должно, и задать это сразу проще, чем вычищать потом.

Вторая — сначала дать агенту осмотреться, потом просить менять. «Разбери, как устроен игровой цикл» перед «добавь паузу» даёт заметно более аккуратные правки.

Режимы разрешений

Это единственная настройка, в которой стоит разобраться до того, как агент начнёт трогать код. Режим определяет, какие действия выполняются без вопроса к вам.

Переключение — Shift+Tab прямо во время сессии. Из auto первое нажатие переводит в default, дальше цикл идёт default → acceptEdits → plan → снова default. Активный режим виден в строке состояния: ⏸ manual mode on, ⏵⏵ accept edits on, ⏸ plan mode on, ⏵⏵ auto mode on.

Задать режим на старте можно флагом:

claude --permission-mode plan

В каком режиме сессия стартует по умолчанию, зависит от тарифа и способа запуска: на планах Pro, Max и Team в терминале это auto, на Enterprise и при работе через ключ Claude Console — default. Первая сессия сразу после установки или обновления тоже стартует в default. Свой вариант по умолчанию задаётся ключом permissions.defaultMode в ~/.claude/settings.json:

{
  "permissions": {
    "defaultMode": "default"
  }
}

Два режима стоит пояснить отдельно. plan — исследование без правок: агент читает файлы и предлагает план, но исходники не трогает, пока вы план не утвердите; войти в него можно тем же Shift+Tab или префиксом /plan для одного запроса. В auto действия проверяет вторая модель-классификатор — вопросов на каждый шаг нет, но и полного отключения проверок тоже.

Практическая рекомендация для разработки игры: начинайте задачу в plan, когда просите спроектировать структуру проекта или разобрать чужой код, переключайтесь в acceptEdits, когда идёт быстрая итерация по геймплею, и возвращайтесь в ручной режим на моменте интеграции SDK и подготовки сборки — там цена ошибки выше, потому что она всплывёт уже на модерации.

Slash-команды

Команды, начинающиеся со слэша, — это управление самой сессией, а не запрос к модели. Наберите /, чтобы увидеть список; команда распознаётся только в начале сообщения, остальной текст становится её аргументом.

Свои команды тоже можно добавлять — в Claude Code они называются skills и лежат в .claude/skills/ внутри проекта или в ~/.claude/skills/ для всех проектов. По сути это markdown-файл с инструкцией, который подставляется в диалог при вызове по имени. Для игры это удобный способ упаковать рутину: одна команда собирает архив для загрузки, вторая прогоняет чек-лист требований по коду. Мы вернёмся к ним ближе к главе про публикацию, когда появится что автоматизировать.

Подготовка проекта: CLAUDE.md

Каждая сессия начинается с чистого контекста. Чтобы не объяснять одно и то же заново, в корне проекта кладут файл CLAUDE.md — он загружается в начало каждой сессии автоматически. Файл может лежать в ./CLAUDE.md или ./.claude/CLAUDE.md; личные заметки, которые не идут в репозиторий, — в ./CLAUDE.local.md, а общие для всех ваших проектов — в ~/.claude/CLAUDE.md.

Сгенерировать заготовку можно командой /init — агент осмотрит проект и опишет, что нашёл. Но самое ценное в этом файле — то, что из кода не выводится. Для игры под Яндекс Игры это правила платформы, на которых чаще всего ошибаются модели, обученные на устаревших туториалах.

Вот рабочая заготовка, которую имеет смысл положить в проект прямо сейчас:

# Игра для Яндекс Игр

## Стек
Чистый JavaScript, без сборки. Точка входа — index.html в корне.
Ничего не выносить в node_modules-зависимости рантайма: сборка
загружается на платформу одним ZIP-архивом.

## Правила Yandex Games SDK (актуально на сентябрь 2026)
- SDK подключается тегом <script src="/sdk.js"></script>.
  URL https://yandex.ru/games/sdk/v2 — устаревший загрузчик,
  не использовать.
- Инициализация: const ysdk = await YaGames.init();
- ysdk.getPlayer() принимает только { signed }. Опции scopes нет.
- Лидерборды — через ysdk.leaderboards.getDescription / setScore /
  getPlayerEntry / getEntries. Метод ysdk.getLeaderboards() устарел.
- flush — второй аргумент setData(data, flush).
  Метода player.flush() не существует.
- Обязательно вызывать ysdk.features.LoadingAPI?.ready(),
  когда игра полностью загружена.

## Ограничения сборки
- В архиве ровно один index.html в корне.
- Имена файлов и папок — без пробелов и кириллицы.

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

Важная оговорка про природу этого файла: CLAUDE.md — это контекст, а не жёсткая настройка. Агент читает его и старается следовать, но гарантии исполнения нет, особенно если инструкции размытые или противоречат друг другу. Если какое-то правило должно выполняться всегда и без исключений, его место не в CLAUDE.md, а в хуках — но это тема отдельной главы.

Автопамять

Параллельно работает автопамять: агент сам записывает то, что вы поправили или объяснили, чтобы не спрашивать в следующий раз. Заметки хранятся локально обычными markdown-файлами — их можно прочитать, отредактировать или удалить. Посмотреть накопленное и выключить автопамять можно через /memory. Разделение простое: CLAUDE.md — правила, которые пишете вы, автопамять — выводы, которые агент делает сам.

Где живут настройки

Настройки разложены по нескольким файлам, и полезно понимать, что из этого попадает в репозиторий:

Правило простое: всё, что относится к самой игре и должно работать одинаково у всех, — в .claude/settings.json и CLAUDE.md рядом с кодом. Личные предпочтения — на уровень пользователя.

Если что-то пошло не так

Три ситуации покрывают большинство проблем на старте.

claude: command not found после установки — почти всегда каталог с бинарником не попал в PATH. Перезапустите терминал: установщик правит окружение, а уже открытая сессия его не перечитывает.

Агент ведёт себя странно или падает на старте — запустите claude --safe-mode, он отключает пользовательские расширения и настройки. Если в безопасном режиме всё в порядке, дело в вашей конфигурации, и claude doctor покажет, в каком именно файле ошибка.

Ответы стали хуже к концу длинной сессии — вероятно, переполнен контекст. Посмотрите /context, сожмите диалог через /compact или начните новый через /clear: тащить историю задачи про геймплей в задачу про интеграцию SDK смысла нет.

Короткий чек-лист

Перед следующей главой убедитесь, что у вас:

• claude --version печатает номер версии;
• claude doctor не показывает ошибок;
• claude auth status показывает вошедший аккаунт;
• создана папка проекта с CLAUDE.md;
• вы знаете, как переключить режим разрешений через Shift+Tab.

Что дальше

Инструмент готов, но игры пока нет. В следующей главе соберём минимальный работающий каркас HTML5-игры — index.html, канвас, игровой цикл — в той структуре, которую потом без переделок можно упаковать в ZIP для Яндекс Игр. Это будет первая настоящая задача для Claude Code, и заодно проверка, что связка «вы — агент — проект» работает так, как задумано.