Codex в VS Code · бери и делай / Козырный маркетинг
0 / 11
Раздел А · Запуск · Шаг 1 из 11

Установите VS Code

Зачем: VS Code — это редактор, в котором живёт Codex. Сам редактор не нужно учить — мы будем работать через окно агента справа. Редактор нам нужен только как «оболочка».

Что сделать

  1. Откройте сайт code.visualstudio.com.
  2. Нажмите большую синюю кнопку Download.
  3. Выберите версию для своей системы — Windows или Mac.
  4. Установите как обычное приложение (везде нажимайте «Далее»).
  5. Запустите VS Code — должно открыться рабочее окно.
📷 Сюда вставить скриншот Главная страница code.visualstudio.com с кнопкой Download для вашей системы A1.jpg
На Mac: после скачивания перетащите иконку VS Code в папку «Программы» и запустите оттуда, а не из «Загрузок».
Раздел А · Запуск · Шаг 2 из 11

Подключите Codex

Зачем: Codex — это AI-помощник от OpenAI. Он живёт прямо внутри VS Code и работает через чат-окно справа. Вы будете писать туда задачи как обычные сообщения, прикладывать скриншоты, файлы, ссылки.

Что сделать

  1. В VS Code слева нажмите иконку Extensions — она выглядит как набор кубиков.
  2. В поле поиска сверху напишите: Codex
  3. В списке найдите расширение Codex от OpenAI (с галочкой проверенного автора).
  4. Нажмите синюю кнопку Install.
  5. Если попросит войти в аккаунт — войдите в свой ChatGPT-аккаунт.
📷 Сюда вставить скриншот Панель Extensions в VS Code: в поиске «Codex», первый результат — расширение от OpenAI с кнопкой Install A2.jpg
Важно: Codex входит в платный план ChatGPT (Plus, Pro, Business). Без подписки расширение установится, но при первом запросе попросит подписку.
Раздел А · Запуск · Шаг 3 из 11

Откройте папку проекта

Зачем: Codex всегда работает внутри одной папки — это «корень» вашего проекта. Все правила, файлы памяти, ваши документы будут жить там. Один проект = одна папка.

Что сделать

  1. Создайте на компьютере пустую папку — например на диске C: создайте C:\projects\my-first-project (или в любом удобном месте).
  2. В VS Code сверху нажмите File → Open Folder (или Ctrl+K Ctrl+O).
  3. Выберите вашу созданную папку → Select Folder.
  4. VS Code попросит подтвердить, что вы доверяете содержимому — нажмите Yes, I trust the authors.
📷 Сюда вставить скриншот VS Code с открытой пустой папкой проекта — слева в Explorer видно имя папки и пусто внутри A3.jpg
Совет по имени папки: без пробелов и кириллицы. Хорошо: my-landing, client-arka. Плохо: Мой проект, Тестовая папка.
Раздел А · Запуск · Шаг 4 из 11

Откройте окно Codex

Зачем: Это главное окно вашей работы. Сюда вы пишете задачи, вставляете скриншоты и файлы, читаете ответы агента. Терминал нам не понадобится — всё через это окно.

Что сделать

  1. В VS Code справа найдите иконку Codex (логотип OpenAI) — нажмите её, и откроется панель чата.
  2. Если её нет — нажмите Ctrl+Shift+P, введите Codex и выберите Codex: Open Codex Sidebar.
  3. Создайте новый поток: значок «карандашик» сверху панели или команда 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 читает его перед каждой работой и понимает: что это за проект, какие правила, чего нельзя. Без него агент работает «вслепую» и каждый раз начинает с нуля.

Что сделать

  1. В окне Codex вставьте промпт ниже.
  2. На вопросы Codex отвечайте по очереди — он сам соберёт ваш файл.
  3. В конце Codex покажет вам готовый AGENTS.md и спросит, что подправить.
Промпт «Создай 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     важные решения с обоснованием

Что сделать

  1. Скопируйте промпт ниже.
  2. Вставьте в окно Codex.
  3. Codex создаст папку и три файла, заполнит шаблонами.
Промпт «Создай wiki/»
Создай в корне проекта папку 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 без явного запроса

Что сделать

Промпт «Создай первый handoff»
Создай в корне проекта папку 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

Что сделать

Промпт «Создай глобальный 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. Только после этого он будет работать осмысленно.

Что сделать

  1. Откройте VS Code, откройте папку проекта (File → Open Folder).
  2. Откройте Codex и создайте новый поток.
  3. Скопируйте промпт ниже и вставьте первым сообщением.
  4. Дождитесь резюме от 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-минутный ритуал, который сохранит ваш контекст и позволит завтра начать с того места, где остановились.

Что сделать

  1. В окне Codex вставьте промпт ниже.
  2. Codex создаст файл в sessions/ и допишет запись в wiki/log.md.
  3. Прочитайте handoff — если что-то не так, скажите Codex поправить.
  4. Закрывайте 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

Made on
Tilda