Codex в VS Code: бесплатная пошаговая инструкция с картинками

Создай в корне проекта файл AGENTS.md — это главная инструкция для тебя в этом проекте.

Перед тем как писать файл, возьми у меня короткое интервью:
1. Что это за проект (один абзац).
2. Главная цель проекта.
3. Конкретный следующий блок, над которым сейчас работаем.
4. Стек: какие технологии используем (HTML/CSS/JS, Python, ничего ещё).
5. Что точно нельзя ломать или удалять.

Правила интервью:
- задавай вопросы по одному;
- к каждому вопросу предлагай 3-4 варианта ответа;
- если я говорю «не знаю» — предложи лучший вариант и спроси, согласен ли я.

После интервью сделай AGENTS.md по такой структуре:

# AGENTS.md

## Что это за проект
[ответы из интервью]

## Текущая цель
- Главная цель: ...
- Сейчас работаем над: ...
- Готово считается, когда: ...

## Стек
- ОС: Windows / macOS
- Технологии: ...
- Как запустить локально: ...

## Правила работы
- Перед изменениями сначала кратко объясни план.
- Не переписывай весь проект без необходимости.
- Не удаляй файлы, если я явно не попросил.
- После изменений скажи, какие файлы изменены и как проверить результат.
- Если задача неясна — задай 1-3 конкретных вопроса.

## Запреты и безопасность
- Не записывай API-ключи, пароли, токены в AGENTS.md, wiki/ или sessions/.
- Секреты — только в .env (и .env должен быть в .gitignore).
- Не отправляй приватные данные во внешние сервисы без моего разрешения.

## Память проекта
- Журнал работ: wiki/log.md
- Решения: wiki/decisions.md
- Последний handoff: самый свежий файл в sessions/

## Ритуал handoff
В конце каждой сессии:
1. Обнови файл sessions/YYYY-MM-DD-topic-handoff.md.
2. Добавь одну короткую запись в wiki/log.md.
3. Укажи следующий конкретный шаг.

Файл должен быть не больше 150 строк. После создания покажи мне AGENTS.md и спроси, что изменить.

my-first-project/
├── AGENTS.md            ← уже создали
└── wiki/
    ├── index.md         карта всех файлов памяти
    ├── log.md           короткий журнал что делали
    └── decisions.md     важные решения с обоснованием

Создай в корне проекта папку wiki/ с тремя файлами.

1. wiki/index.md — карта памяти проекта:
   - заголовок «Карта памяти проекта»;
   - список всех файлов памяти со ссылками и одной строкой описания;
   - правило: «перед задачей читай только нужные файлы, не загружай всё сразу».

2. wiki/log.md — журнал:
   - заголовок «Журнал проекта»;
   - правило: «добавлять новые записи сверху, старую историю не переписывать»;
   - первая запись с сегодняшней датой: «Создали структуру памяти: AGENTS.md, wiki/, sessions/».

3. wiki/decisions.md — решения:
   - заголовок «Важные решения проекта»;
   - формат записи: дата · решение · почему · альтернативы которые отбросили;
   - первая запись: «Используем файловую память (AGENTS.md + wiki/ + sessions/) вместо облачной — потому что бесплатно, локально, работает без интернета».

После создания обнови wiki/index.md так, чтобы там был список всех созданных файлов со ссылками.

Покажи мне дерево созданных файлов в конце.

sessions/
└── 2026-05-20-init-handoff.md

# Handoff: 2026-05-20

## Коротко
Сегодня мы [что делали и зачем].

## Что изменилось
- AGENTS.md: создан
- wiki/log.md: первая запись
- wiki/decisions.md: решение про файловую память

## Что проверено
- Структура файлов на месте

## Следующий шаг
[конкретное действие для следующего запуска Codex]

## Не трогать
- AGENTS.md без явного запроса

Создай в корне проекта папку sessions/ и первый handoff-файл.

Имя файла: sessions/YYYY-MM-DD-init-handoff.md (где YYYY-MM-DD — сегодняшняя дата).

Структура файла:

# Handoff: [сегодняшняя дата]

## Коротко
Сегодня настроили базовую память проекта: AGENTS.md, wiki/, sessions/.

## Что изменилось
- AGENTS.md: создан (главная инструкция для Codex)
- wiki/index.md: карта памяти
- wiki/log.md: журнал, добавлена первая запись
- wiki/decisions.md: решения, добавлено первое
- sessions/: создана папка для handoff-ов

## Что проверено
- Все файлы на месте, дерево соответствует плану.

## Важные решения
- Решили вести файловую память вместо облачной.

## Открытые вопросы
- [впишет пользователь, если есть]

## Следующий шаг
Начать с: [очень конкретное действие — например «создать первую страницу лендинга в src/index.html»].

## Не трогать
- AGENTS.md, wiki/decisions.md без явного запроса от меня.

После создания файла обнови wiki/log.md — добавь запись «Создали первый handoff в sessions/».
В wiki/index.md добавь строку про папку sessions/.

Покажи мне готовый handoff и финальное дерево всего проекта.

Создай файл ~/.codex/AGENTS.md (на Windows — C:\Users\<имя>\.codex\AGENTS.md).

Это глобальные правила, которые ты будешь применять ко всем моим проектам.

Сначала спроси:
1. Какая у меня операционная система (Windows / macOS / Linux).
2. На каком языке мне удобнее общаться (русский, английский, оба).
3. Где обычно лежат мои проекты (например C:\projects\).
4. Какие три правила я хочу зафиксировать «навсегда» (например: «не предлагай хранить токены в файлах»).

После ответов создай файл по структуре:

# Глобальные правила работы со мной

## Моя среда
- ОС: [ответ]
- Язык общения: [ответ]
- Корневая папка проектов: [ответ]

## Как со мной работать
- Сначала уточняй рискованные решения.
- Объясняй шаги по принципу «куда нажать, что должно появиться, что делать при ошибке».
- После правок давай короткую проверку: что открыть, какой результат увидеть.

## Безопасность
- Никогда не предлагай хранить секреты в AGENTS.md, wiki/ или sessions/.
- Если видишь .env в списке файлов для публикации — остановись и предупреди.
- [мои три правила из ответа]

Файл должен быть не больше 50 строк. Покажи мне его в конце.

Прочитай AGENTS.md, wiki/log.md и последний файл в sessions/.

Кратко восстанови контекст проекта:
- что это за проект;
- где мы остановились в прошлой сессии;
- какие файлы важны прямо сейчас;
- какой следующий шаг я планировал.

Пока ничего не меняй. Сначала дай резюме на 5-7 предложений и предложи план продолжения.

Ответь на русском.

У меня появилась ошибка: [вставьте полный текст ошибки или скриншот].

Объясни простыми словами:
1. Что это значит.
2. Почему это могло произойти.
3. Что нужно сделать пошагово.

Ничего не меняй сейчас. Сначала объясни — я подтверждаю.

Закрываем сессию.

Сделай две вещи:

1. Создай новый файл sessions/YYYY-MM-DD-topic-handoff.md (где topic — короткое описание темы сегодняшней работы).

Структура файла:

# Handoff: [сегодняшняя дата]

## Коротко
[1-3 предложения: что делали и зачем]

## Что изменилось
- [файл/папка]: [что изменили]
- ...

## Что проверено
- [команда / ручная проверка]: [результат]
- [что осталось непроверенным]

## Важные решения
- [решение 1, если было]

## Открытые вопросы
- [что не успели решить]

## Следующий шаг
Начать с: [конкретное действие для следующего запуска Codex].

## Не трогать
- [файлы и решения, которые нельзя менять без отдельного запроса]

2. Допиши одну короткую запись в wiki/log.md под сегодняшней датой: «[1 предложение про результат] · Следующий шаг: [то же что в handoff]».

Покажи мне готовый handoff и обновлённый log.md в конце.