Настройка Claude Code

Программа установлена и слушается. Но пока она ничего не знает про ваш проект: ни что вы делаете игру, ни что игра пойдёт на Яндекс Игры, ни какие там правила. Каждый раз объяснять это заново — расточительно и утомительно.

Эта глава про то, как объяснить один раз.

Главный файл: CLAUDE.md

В папке проекта может лежать файл CLAUDE.md. Claude Code читает его сам, при каждом запуске, и считает написанное там постоянными правилами.

Это самая полезная настройка из всех существующих. Один раз потратив полчаса на этот файл, вы перестанете получать ответы вроде «а я не знал, что нельзя».

Создать заготовку можно командой прямо внутри Claude Code:

/init

Программа осмотрит папку и предложит черновик. Дальше его надо дописать под себя.

Что писать в CLAUDE.md

Правило простое: туда идёт то, что не меняется от задачи к задаче. Не «сделай синюю кнопку», а «кнопки в этом проекте всегда синие».

Вот рабочая заготовка для игры под Яндекс Игры. Скопируйте её в CLAUDE.md и поправьте под свою игру.

# Проект

Браузерная HTML5-игра для платформы Яндекс Игры.
Жанр: головоломка. Управление: только мышь и касания.

# Как со мной разговаривать

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

# Стек

- Чистый HTML, CSS и JavaScript. Без сборщиков и фреймворков.
- Никаких внешних библиотек без моего разрешения.
- Вся графика — либо рисуется кодом, либо лежит в папке assets.

# Требования платформы — соблюдать всегда

- Точка входа: index.html в корне архива.
- Имена файлов: только латиница, без пробелов.
- Размер собранного архива не больше 100 МБ.
- Игра не должна зависеть от адреса страницы, на которой открыта.
- Никаких обращений к внешним сайтам за файлами.

# Яндекс Games SDK

- Подключение: <script src="/sdk.js"></script> в head.
- Инициализация: YaGames.init().then((ysdk) => { ... }).
- Обязательно вызвать ysdk.features.LoadingAPI?.ready(),
  когда игра загрузилась и в неё можно играть.
- Обязательно подписаться на события game_api_pause и game_api_resume:
  на паузе гасить звук и останавливать игровой цикл.
- Язык интерфейса брать из ysdk.environment.i18n.lang, а не из браузера.

# Частые причины отказа модерации — проверять перед сборкой

- При клике внутри игры не должно появляться контекстное меню браузера
  и не должно выделяться содержимое страницы.
- Звук игры не должен играть поверх рекламы.
- Звук должен замолкать при переходе на другую вкладку.
- Прогресс должен сохраняться между запусками.
- В консоли браузера не должно быть ошибок.

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

Разрешения: что программа спрашивает

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

Варианты ответа обычно такие:

• разрешить один раз — самое безопасное;
• разрешить такие действия всегда — удобно для рутины вроде чтения файлов;
• отказать — и тут же объяснить, что делать вместо этого.

Первое время отвечайте по одному разу и читайте, что именно предлагается. Это не паранойя, а способ понять, что вообще происходит в вашей папке.

Команды, которые пригодятся

Внутри Claude Code команды начинаются с косой черты. Вот те, что действительно нужны:

Про /clear стоит сказать отдельно, потому что это главный инструмент экономии.

Как не жечь лимит подписки

Claude Code помнит весь разговор целиком. Каждое следующее сообщение отправляется вместе со всей предыдущей перепиской — а значит, чем длиннее разговор, тем дороже каждое сообщение в нём.

Отсюда три простых правила.

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

Формулируйте задачу целиком. «Сделай меню» и потом двадцать уточнений стоят дороже, чем сразу «Сделай стартовое меню с кнопками „Играть“ и „Звук“, кнопки по центру, шрифт крупный, при нажатии „Играть“ запускается игра».

Говорите, что именно не так. «Не работает» заставляет модель гадать и перебирать варианты. «При нажатии на кнопку „Играть“ ничего не происходит, в консоли браузера ошибка ysdk is not defined» — приводит к исправлению с первого раза.

Про выбор модели: более мощная думает лучше, но расходует лимит быстрее. Разумный порядок — сложную архитектурную задачу отдавать мощной модели, а мелкие правки делать экономной. Переключение — командой /model.

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

Помимо CLAUDE.md есть файлы настроек:

• .claude/settings.json в папке проекта — правила для этого проекта;
• ~/.claude/settings.json в домашней папке — общие для всех ваших проектов. На Windows это C:\Users\Имя\.claude\.

На старте туда лезть не нужно. Единственное, что может понадобиться на Windows, — указать путь к Git, если Claude Code его не нашёл:

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

Заведите git с самого начала

Не настройка Claude Code, но относится сюда же. В папке проекта выполните один раз:

git init

Дальше, когда игра дойдёт до работающего состояния, сохраняйте её:

git add -A
git commit -m "работающая версия с меню"

Зачем: рано или поздно очередная правка что-нибудь сломает, и вы захотите вернуться к тому, что работало. Без этих команд возвращаться будет некуда. Claude Code умеет делать коммиты сам — достаточно попросить.

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

• В папке проекта есть CLAUDE.md с правилами платформы и списком причин отказа
• Понятно, как отвечать на запросы разрешений, режим «без вопросов» выключен
• Знакомы команды /clear, /model, /init
• Есть привычка очищать историю между задачами
• Выполнен git init, первая рабочая версия сохранена

Что дальше

Инструмент настроен. Теперь самое интересное — делаем первую игру.