Стартовый репозиторий курса: подготовка к работе с Claude Code и Codex
GPT и Gemini поспорили, что важнее в AGENTS.md: аудит или память
Репозиторий-стартер для курса по надёжной разработке с помощью ИИ-инструментов кодирования почти пустой: основная настройка навыков пройдёт во второй сессии, а здесь описана подготовка перед вводным созвоном. Нужно установить Node.js LTS, Git, Visual Studio Code, аккаунт GitHub, а также Claude Code или Codex с платной лицензией, затем клонировать репозиторий. В примере чата показан важный принцип: API-ключ хранится только в локальной .env-файле и не попадает в коммит. Репозиторий использует AGENTS.md как единый источник правил для ИИ-агентов и содержит простой пример навыка для первой проверки.
Этот репозиторий — стартовая заготовка для курса «Надёжная и безошибочная разработка с помощью ИИ-инструментов кодирования». Он намеренно почти пустой: основная настройка проверенных навыков и наборов будет проходить вживую на второй сессии, а не в этом репозитории. Здесь описана только подготовка проекта перед стартовым созвоном. Автор просит заранее установить Node.js LTS, Git и Visual Studio Code, создать аккаунт на GitHub, а также установить Claude Code или Codex. Оба инструмента требуют платной лицензии, если вы хотите программировать с помощью ИИ. Затем нужно клонировать репозиторий командой git clone. На подготовку обычно уходит от одного до двух часов в зависимости от состояния компьютера и опыта. На стартовом созвоне проверяется, что node --version и git --version работают без ошибок, что VS Code открывается, GitHub-аккаунт существует, выбранный инструмент запускается, а репозиторий успешно склонирован. Установка наиболее удачных наборов навыков и инициализация проекта сознательно вынесены на вторую сессию. Для этого нужен только работающий клиент Claude Code или Codex. В репозитории есть маленький рабочий пример — командный чат с Claude в файле src/chat.ts. Главное в нём не сам чат, а принцип: API-ключ никогда не хранится в коде. Он лежит только в локальном файле .env, который не попадает в коммит и не отслеживается Git. Во время выполнения ключ загружается через пакет dotenv, а код обращается к нему через process.env. Для запуска нужно выполнить npm install, скопировать .env.example в .env, вписать реальный ANTHROPIC_API_KEY и запустить npm run chat. Этот же шаблон работы с секретами будет использоваться на всём курсе. Отдельный фронтенд для этого примера планируется собрать на четвёртой сессии. Репозиторий рассчитан на совместную работу с Claude Code и Codex. В корне лежит файл AGENTS.md — единый источник правил для всех ИИ-агентов. В нём описан контекст проекта и важные ограничения, например запрет хранить секреты в коде и требование делать git-коммиты вручную. Файл CLAUDE.md существует только как указатель для Claude Code, чтобы тот смотрел в AGENTS.md. Благодаря этому правила управляются в одном месте. После установки инструментов и клонирования можно проверить настройку: открыть терминал, перейти в папку проекта и запустить claude или codex. В каталоге docs/beispiel-skill/SKILL.md лежит простой пример навыка. Благодаря AGENTS.md ИИ может применить его по короткой команде, не набирая полный путь. Для проверки чата нужно установить зависимости через npm install и запустить npm run chat, предварительно создав .env. В сопровождающих материалах есть краткая шпаргалка по командам терминала, пошаговая инструкция по настройке GitHub SSH-ключа и минимальный шаблон навыка, который пригодится на пятой сессии. Для начинающих разработчиков такой подход полезен тем, что даёт готовую воспроизводимую среду для экспериментов с ИИ-ассистентами и сразу закрепляет правильную привычку не хранить секреты в коде.