CLAUDE.md для Claude Code по наблюдениям Карпати
Пошаговая инструкция по внедрению одного файла CLAUDE.md, который корректирует поведение Claude Code на основе наблюдений Андрея Карпати о типичных ошибках LLM при написании кода. Источник: [multica-ai/andrej-karpathy-skills](https://github.com/multica-ai/andrej-karpathy-skills).
Требования
- Установленный Claude Code
- Папка с проектом или репозиторий
- Права на создание файлов в корне проекта
Изучить типичные ловушки LLM при кодировании
Перед тем как править поведение модели, стоит разобраться, с чем именно она борется. Андрей Карпати отмечает, что LLM часто теряют нить рассуждения, вносят лишние правки, игнорируют ошибки компиляции и предлагают изменения без оценки последствий. Один файл CLAUDE.md помогает свести такие ситуации к минимуму, задавая чёткие рамки для Claude Code.
Скачать готовый CLAUDE.md из репозитория
Авторы репозитория multica-ai уже собрали наблюдения Карпати в единый файл. Самый быстрый способ начать — скачать его напрямую и положить в корень проекта. CLAUDE.md читается Claude Code перед началом работы и работает как системная инструкция для модели.
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md -o CLAUDE.mdРазместить CLAUDE.md в корне проекта
Убедитесь, что файл лежит в той же папке, из которой вы запускаете Claude Code. Если проектов несколько, скопируйте CLAUDE.md в каждый репозиторий — инструкция действует только там, где находится файл.
ls -la CLAUDE.mdАдаптировать правила под свой стек технологий
Шаблон содержит общие рекомендации, но не знает ваш стек технологий. Откройте CLAUDE.md в редакторе и укажите языки, фреймворки и команды сборки: например, «Python 3.11 с Poetry», «тесты запускаются через pytest». Чем точнее формулировка, тем реже модель предложит код, который не соберётся или не пройдёт проверку.
Проверить поведение Claude Code на тестовой задаче
Проверьте изменение поведения на задаче, которая раньше вызывала нарекания: например, попросите рефакторить функцию с обработкой исключений или добавить фичу без поломки тестов. Сравните ответ до и после подключения CLAUDE.md. Если модель по-прежнему игнорирует правила, уточните формулировку в файле.
Обновлять CLAUDE.md по мере накопления опыта
Инструкция не статична. Каждый раз, когда Claude Code повторяет ту же ошибку, добавьте в CLAUDE.md правило, которое её предотвращает. Со временем файл превращается в базу знаний команды и защищает от регрессии поведения модели.
CLAUDE.md для Claude Code по наблюдениям Карпати
Пошаговая инструкция по внедрению одного файла CLAUDE.md, который корректирует поведение Claude Code на основе наблюдений Андрея Карпати о типичных ошибках LLM при написании кода. Источник: multica-ai/andrej-karpathy-skills.
Предварительные требования
- Установленный Claude Code
- Папка с проектом или репозиторий
- Права на создание файлов в корне проекта
Шаг 1: Изучить типичные ловушки LLM при кодировании
Перед тем как править поведение модели, стоит разобраться, с чем именно она борется. Андрей Карпати отмечает, что LLM часто теряют нить рассуждения, вносят лишние правки, игнорируют ошибки компиляции и предлагают изменения без оценки последствий. Один файл CLAUDE.md помогает свести такие ситуации к минимуму, задавая чёткие рамки для Claude Code.
Шаг 2: Скачать готовый CLAUDE.md из репозитория
Авторы репозитория multica-ai уже собрали наблюдения Карпати в единый файл. Самый быстрый способ начать — скачать его напрямую и положить в корень проекта. CLAUDE.md читается Claude Code перед началом работы и работает как системная инструкция для модели.
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md -o CLAUDE.md
Шаг 3: Разместить CLAUDE.md в корне проекта
Убедитесь, что файл лежит в той же папке, из которой вы запускаете Claude Code. Если проектов несколько, скопируйте CLAUDE.md в каждый репозиторий — инструкция действует только там, где находится файл.
ls -la CLAUDE.md
Шаг 4: Адаптировать правила под свой стек технологий
Шаблон содержит общие рекомендации, но не знает ваш стек технологий. Откройте CLAUDE.md в редакторе и укажите языки, фреймворки и команды сборки: например, «Python 3.11 с Poetry», «тесты запускаются через pytest». Чем точнее формулировка, тем реже модель предложит код, который не соберётся или не пройдёт проверку.
Шаг 5: Проверить поведение Claude Code на тестовой задаче
Проверьте изменение поведения на задаче, которая раньше вызывала нарекания: например, попросите рефакторить функцию с обработкой исключений или добавить фичу без поломки тестов. Сравните ответ до и после подключения CLAUDE.md. Если модель по-прежнему игнорирует правила, уточните формулировку в файле.
Шаг 6: Обновлять CLAUDE.md по мере накопления опыта
Инструкция не статична. Каждый раз, когда Claude Code повторяет ту же ошибку, добавьте в CLAUDE.md правило, которое её предотвращает. Со временем файл превращается в базу знаний команды и защищает от регрессии поведения модели.