Раздел А · Запуск · Шаг 1 из 11
Установите VS Code
Зачем: VS Code — это редактор, в котором живёт Codex. Сам редактор не нужно учить — мы будем работать через окно агента справа. Редактор нам нужен только как «оболочка».
Что сделать
- Откройте сайт code.visualstudio.com.
- Нажмите большую синюю кнопку Download.
- Выберите версию для своей системы — Windows или Mac.
- Установите как обычное приложение (везде нажимайте «Далее»).
- Запустите VS Code — должно открыться рабочее окно.
📷 Сюда вставить скриншот
Главная страница code.visualstudio.com с кнопкой Download для вашей системы
A1.jpg
На Mac: после скачивания перетащите иконку VS Code в папку «Программы» и запустите оттуда, а не из «Загрузок».
Раздел А · Запуск · Шаг 2 из 11
Подключите Codex
Зачем: Codex — это AI-помощник от OpenAI. Он живёт прямо внутри VS Code и работает через чат-окно справа. Вы будете писать туда задачи как обычные сообщения, прикладывать скриншоты, файлы, ссылки.
Что сделать
- В VS Code слева нажмите иконку Extensions — она выглядит как набор кубиков.
- В поле поиска сверху напишите:
Codex - В списке найдите расширение Codex от OpenAI (с галочкой проверенного автора).
- Нажмите синюю кнопку Install.
- Если попросит войти в аккаунт — войдите в свой ChatGPT-аккаунт.
📷 Сюда вставить скриншот
Панель Extensions в VS Code: в поиске «Codex», первый результат — расширение от OpenAI с кнопкой Install
A2.jpg
Важно: Codex входит в платный план ChatGPT (Plus, Pro, Business). Без подписки расширение установится, но при первом запросе попросит подписку.
Раздел А · Запуск · Шаг 3 из 11
Откройте папку проекта
Зачем: Codex всегда работает внутри одной папки — это «корень» вашего проекта. Все правила, файлы памяти, ваши документы будут жить там. Один проект = одна папка.
Что сделать
- Создайте на компьютере пустую папку — например на диске C: создайте
C:\projects\my-first-project (или в любом удобном месте). - В VS Code сверху нажмите File → Open Folder (или Ctrl+K Ctrl+O).
- Выберите вашу созданную папку → Select Folder.
- VS Code попросит подтвердить, что вы доверяете содержимому — нажмите Yes, I trust the authors.
📷 Сюда вставить скриншот
VS Code с открытой пустой папкой проекта — слева в Explorer видно имя папки и пусто внутри
A3.jpg
Совет по имени папки: без пробелов и кириллицы. Хорошо: my-landing, client-arka. Плохо: Мой проект, Тестовая папка.
Раздел А · Запуск · Шаг 4 из 11
Откройте окно Codex
Зачем: Это главное окно вашей работы. Сюда вы пишете задачи, вставляете скриншоты и файлы, читаете ответы агента. Терминал нам не понадобится — всё через это окно.
Что сделать
- В VS Code справа найдите иконку Codex (логотип OpenAI) — нажмите её, и откроется панель чата.
- Если её нет — нажмите Ctrl+Shift+P, введите
Codex и выберите Codex: Open Codex Sidebar. - Создайте новый поток: значок «карандашик» сверху панели или команда Codex: New Thread in Codex Sidebar.
📷 Сюда вставить скриншот
Открытая панель Codex справа в VS Code, поле ввода готово к первому сообщению
A4.jpg
Как работать с окном Codex
- Текст — пишите задачу обычным языком, как в чате с человеком.
- Скриншоты — копируете изображение в буфер обмена (Win+Shift+S) и вставляете в поле через Ctrl+V. Codex видит изображения.
- Файлы — пишете в поле
@ и выбираете файл из проекта. - Длинные тексты — вставляйте целиком, ничего обрезать не нужно.
Терминал внизу VS Code открывать не нужно. Codex сам запустит нужные команды, когда они понадобятся — он спросит у вас разрешение, прежде чем выполнить.
Раздел Б · Память проекта · Шаг 5 из 11
Создайте AGENTS.md
Зачем: Это главный файл проекта. Codex читает его перед каждой работой и понимает: что это за проект, какие правила, чего нельзя. Без него агент работает «вслепую» и каждый раз начинает с нуля.
Что сделать
- В окне Codex вставьте промпт ниже.
- На вопросы Codex отвечайте по очереди — он сам соберёт ваш файл.
- В конце Codex покажет вам готовый
AGENTS.md и спросит, что подправить.
Создай в корне проекта файл 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 и спроси, что изменить.
📷 Сюда вставить скриншот
Созданный AGENTS.md открытый в VS Code: слева в Explorer видно файл в корне, справа — содержимое
B1.jpg
Раздел Б · Память проекта · Шаг 6 из 11
Создайте wiki/ — базу знаний
Зачем: wiki/ — это память проекта на месяцы. Журнал того, что делали (log.md), важные решения (decisions.md), карта всех файлов (index.md). Через 3 месяца вы и Codex откроете эти файлы и быстро вернётесь в контекст.
Структура папки
my-first-project/
├── AGENTS.md ← уже создали
└── wiki/
├── index.md карта всех файлов памяти
├── log.md короткий журнал что делали
└── decisions.md важные решения с обоснованием Что сделать
- Скопируйте промпт ниже.
- Вставьте в окно Codex.
- Codex создаст папку и три файла, заполнит шаблонами.
Создай в корне проекта папку wiki/ с тремя файлами.
1. wiki/index.md — карта памяти проекта:
- заголовок «Карта памяти проекта»;
- список всех файлов памяти со ссылками и одной строкой описания;
- правило: «перед задачей читай только нужные файлы, не загружай всё сразу».
2. wiki/log.md — журнал:
- заголовок «Журнал проекта»;
- правило: «добавлять новые записи сверху, старую историю не переписывать»;
- первая запись с сегодняшней датой: «Создали структуру памяти: AGENTS.md, wiki/, sessions/».
3. wiki/decisions.md — решения:
- заголовок «Важные решения проекта»;
- формат записи: дата · решение · почему · альтернативы которые отбросили;
- первая запись: «Используем файловую память (AGENTS.md + wiki/ + sessions/) вместо облачной — потому что бесплатно, локально, работает без интернета».
После создания обнови wiki/index.md так, чтобы там был список всех созданных файлов со ссылками.
Покажи мне дерево созданных файлов в конце.
📷 Сюда вставить скриншот
В VS Code слева видно созданную папку wiki/ с тремя файлами: index.md, log.md, decisions.md
B2.jpg
Главное правило wiki/log.md: только дописывать новые записи. Старые не редактировать, не удалять. Это аудит-след вашей работы.
Раздел Б · Память проекта · Шаг 7 из 11
Создайте sessions/ — handoff
Зачем: Каждый раз, когда вы заканчиваете работу за день, Codex создаёт файл sessions/YYYY-MM-DD-handoff.md. В нём — что сделали, где остановились, что дальше. Завтра новая сессия начнётся с чтения этого файла — и вы сразу в контексте.
Структура файла handoff
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 и финальное дерево всего проекта.
📷 Сюда вставить скриншот
В VS Code слева — папка sessions/ с первым файлом handoff. Справа открыто содержимое handoff-файла
B3.jpg
Раздел Б · Память проекта · Шаг 8 из 11
Глобальные правила (опционально)
Зачем: Это правила, которые работают во всех ваших проектах сразу. Например: «я на Windows», «отвечай на русском», «не предлагай хранить пароли в файлах». Codex читает их перед каждым проектом, и не нужно повторять это в каждом AGENTS.md.
Где живёт файл
Файл лежит вне проектов, в системной папке пользователя:
- Windows:
C:\Users\<ВашеИмя>\.codex\AGENTS.md - macOS / Linux:
~/.codex/AGENTS.md
Что сделать
Создай файл ~/.codex/AGENTS.md (на Windows — C:\Users\<имя>\.codex\AGENTS.md).
Это глобальные правила, которые ты будешь применять ко всем моим проектам.
Сначала спроси:
1. Какая у меня операционная система (Windows / macOS / Linux).
2. На каком языке мне удобнее общаться (русский, английский, оба).
3. Где обычно лежат мои проекты (например C:\projects\).
4. Какие три правила я хочу зафиксировать «навсегда» (например: «не предлагай хранить токены в файлах»).
После ответов создай файл по структуре:
# Глобальные правила работы со мной
## Моя среда
- ОС: [ответ]
- Язык общения: [ответ]
- Корневая папка проектов: [ответ]
## Как со мной работать
- Сначала уточняй рискованные решения.
- Объясняй шаги по принципу «куда нажать, что должно появиться, что делать при ошибке».
- После правок давай короткую проверку: что открыть, какой результат увидеть.
## Безопасность
- Никогда не предлагай хранить секреты в AGENTS.md, wiki/ или sessions/.
- Если видишь .env в списке файлов для публикации — остановись и предупреди.
- [мои три правила из ответа]
Файл должен быть не больше 50 строк. Покажи мне его в конце.
📷 Сюда вставить скриншот
Открытый ~/.codex/AGENTS.md в VS Code — глобальные правила с моей средой и тремя личными правилами
B4.jpg
Если пропустите этот шаг — ничего страшного. Можно вернуться позже, когда станет понятно, какие правила нужно зафиксировать «навсегда».
Раздел В · Рабочий ритуал · Шаг 9 из 11
Стартовый промпт новой сессии
Зачем: Когда вы возвращаетесь к проекту через день или неделю, нельзя сразу давать новое задание. Сначала Codex должен восстановить контекст — прочитать AGENTS.md, log.md и последний handoff. Только после этого он будет работать осмысленно.
Что сделать
- Откройте VS Code, откройте папку проекта (File → Open Folder).
- Откройте Codex и создайте новый поток.
- Скопируйте промпт ниже и вставьте первым сообщением.
- Дождитесь резюме от Codex. Только после этого ставьте новую задачу.
Прочитай AGENTS.md, wiki/log.md и последний файл в sessions/.
Кратко восстанови контекст проекта:
- что это за проект;
- где мы остановились в прошлой сессии;
- какие файлы важны прямо сейчас;
- какой следующий шаг я планировал.
Пока ничего не меняй. Сначала дай резюме на 5-7 предложений и предложи план продолжения.
Ответь на русском.
📷 Сюда вставить скриншот
Окно Codex с ответом-резюме после стартового промпта: видно, что Codex прочитал файлы и пересказал контекст
C1.jpg
Используйте этот промпт всегда при возвращении к проекту. Даже если перерыв был полчаса. Так Codex не теряет контекст между потоками.
Раздел В · Рабочий ритуал · Шаг 10 из 11
Главное правило: сначала план
Зачем: Если дать агенту свободу формулировкой «сделай», он переделает половину проекта и сломает рабочее. Поэтому формула: сначала план → ваше подтверждение → действие → проверка.
Плохой запрос
Сделай лендинг.
Codex создаст 20 файлов на своё усмотрение, и вы потом неделю разбираете что куда.
Нормальный запрос
Сначала предложи структуру лендинга на 5 секций: hero, услуги, кейсы, FAQ, CTA. Ничего не создавай. Покажи структуру — я подтверждаю.
Так у вас есть план, который вы согласуете перед действием.
Ещё пара полезных фраз
- «Изучи папку проекта. Ничего не редактируй. Дай список файлов и объясни, что делает каждый» — для возвращения в незнакомый проект.
- «Предложи 3 варианта решения. Пока ничего не меняй» — для важных архитектурных решений.
- «Исправь только X. Остальное не трогай» — для точечных правок.
Если появилась ошибка
У меня появилась ошибка: [вставьте полный текст ошибки или скриншот].
Объясни простыми словами:
1. Что это значит.
2. Почему это могло произойти.
3. Что нужно сделать пошагово.
Ничего не меняй сейчас. Сначала объясни — я подтверждаю.
📷 Сюда вставить скриншот
Пример работы по правилу «сначала план»: запрос → Codex предлагает план → пользователь подтверждает → действие
C2.jpg
Никогда не говорите: «переделай всё», «сделай красиво», «исправь как считаешь нужным». Эти фразы дают Codex слишком много свободы — он сделает не то, что вам нужно.
Раздел В · Рабочий ритуал · Шаг 11 из 11
Закрытие сессии: handoff
Зачем: Прежде чем закрыть VS Code в конце дня, создайте handoff. Это 2-минутный ритуал, который сохранит ваш контекст и позволит завтра начать с того места, где остановились.
Что сделать
- В окне Codex вставьте промпт ниже.
- Codex создаст файл в
sessions/ и допишет запись в wiki/log.md. - Прочитайте handoff — если что-то не так, скажите Codex поправить.
- Закрывайте VS Code спокойно.
Закрываем сессию.
Сделай две вещи:
1. Создай новый файл sessions/YYYY-MM-DD-topic-handoff.md (где topic — короткое описание темы сегодняшней работы).
Структура файла:
# Handoff: [сегодняшняя дата]
## Коротко
[1-3 предложения: что делали и зачем]
## Что изменилось
- [файл/папка]: [что изменили]
- ...
## Что проверено
- [команда / ручная проверка]: [результат]
- [что осталось непроверенным]
## Важные решения
- [решение 1, если было]
## Открытые вопросы
- [что не успели решить]
## Следующий шаг
Начать с: [конкретное действие для следующего запуска Codex].
## Не трогать
- [файлы и решения, которые нельзя менять без отдельного запроса]
2. Допиши одну короткую запись в wiki/log.md под сегодняшней датой: «[1 предложение про результат] · Следующий шаг: [то же что в handoff]».
Покажи мне готовый handoff и обновлённый log.md в конце.
📷 Сюда вставить скриншот
Готовый handoff-файл открыт в VS Code, рядом справа — обновлённый wiki/log.md с новой записью
C3.jpg
Через месяц у вас будет 20-30 handoff-файлов и подробный лог. Это станет историей проекта — вы будете знать, что именно делали и почему.
Вы прошли весь онбординг
Готово 🎉
Теперь у тебя есть рабочий стек: VS Code + Codex + AGENTS.md + wiki/ + sessions/. Codex помнит твой проект между сессиями и работает по твоим правилам.
11 шагов
Без терминала, без Node.js, без сложных настроек. Всё через окно агента — туда, куда вставляются скриншоты, файлы и длинные тексты. Бери и делай.
Светлана Козырина · Козырный маркетинг · козырныймаркетинг.рф
Удваиваем продажи через цифровой маркетинг, воронки и AI