Codex в VS Code: установка, первый запрос и проверка

Codex в VS Code работает через официальное расширение: оно получает контекст открытых файлов и выделения, предлагает изменения рядом с кодом и сохраняет диалог. Проверенный результат первого запуска: панель открыта, нужная папка выбрана, маленькая правка видна в diff, а тест или ручная проверка проходит.

Карта результата перед установкой

• Исходные условия: актуальный VS Code, проект в отдельной папке и собственная учётная запись.
• Ожидаемый результат: Codex объясняет выбранный файл и делает одну обратимую правку.
• Обязательные шаги: официальная установка, вход, выбор контекста, просмотр изменений, проверка.
• Способ проверки: diff содержит только ожидаемые строки, проект запускается или тест проходит.
• Не подходит: секретный проект без разрешения организации или задача без точки возврата.

Правило первой задачи: один файл, одно наблюдаемое изменение и один способ проверки. Так проще заметить побочный эффект.

Установите официальное расширение

OpenAI Docs указывает, что VS Code и совместимые редакторы используют Codex IDE extension. На странице есть ссылка на магазин и команда открытия панели: Codex IDE extension.

1. Откройте документацию OpenAI вручную.
2. Перейдите по ссылке установки в магазин VS Code.
3. Проверьте название и издателя, не ставьте одноимённую рекламную копию.
4. Установите и включите расширение.
5. Откройте значок Codex; если его нет, выполните Codex: Open Codex Sidebar.

Не вставляйте токен в случайное поле и не передавайте код подтверждения. Используйте штатный экран входа. На рабочем компьютере сначала проверьте политику расширений и передачи исходного кода.

Подготовьте проект и возврат

Откройте корневую папку проекта, а не весь диск. Сохраните незакоммиченные изменения или сделайте копию учебного файла. Не добавляйте в запрос .env, ключи, пароли, пользовательские данные и приватные журналы.

• Посмотрите список изменённых файлов до старта.
• Выберите тестовый файл без секретов.
• Запишите ожидаемый итог одной фразой.
• Определите команду теста или ручной сценарий.
• Убедитесь, что умеете отменить предложенный diff.

По теме: Вайбкодинг игр: как собрать первую браузерную игру

Передайте ровно нужный контекст

Официальная страница описывает открытые файлы, выделенный код и недавний диалог как источники контекста. Начните с выделения функции и коротких ограничений. Сначала можно попросить объяснение, затем план, и только потом узкую правку.

Проверь выделенную функцию в parser.ts.
Исправь только обработку пустой строки.
Не меняй публичный интерфейс.
Запусти существующий тест parser.test.ts и покажи итог.

Проверьте изменения рядом с кодом

OpenAI Docs подчёркивает просмотр сфокусированного diff и сохранение только нужных изменений. Прочитайте каждую строку. Если затронуты неожиданные файлы, отмените предложение и сузьте границу.

1. Сравните изменённые файлы со списком до задачи.
2. Проверьте, что не появились секреты и временные файлы.
3. Прочитайте условия ошибок и граничные случаи.
4. Запустите указанный тест или линтер.
5. Повторите нормальный и пустой ввод вручную.
6. Сохраните правку только после проверки.

Безопасный учебный сценарий

Возьмите небольшую функцию форматирования даты и два теста: корректная дата и неверная строка. Попросите сначала объяснить поведение, затем добавить обработку ошибки без смены интерфейса. Приёмка: зелёные тесты, понятная ошибка и отсутствие изменений вне двух файлов.

По теме: Настройка Codex в 2026: приложение, config.toml, CLI и IDE

Диагностика расширения

Панель не видна: откройте палитру команд и перезагрузите окно VS Code. Codex не видит файл: убедитесь, что открыта папка проекта и файл сохранён. Вход повторяется: завершите старые вкладки авторизации и используйте один штатный сеанс.

Изменяется слишком много файлов: отмените diff и укажите точный путь. Тест не запускается: сначала выполните команду самостоятельно в терминале проекта и исправьте окружение отдельно от задачи Codex.

Когда выбрать другую поверхность

Расширение удобно для правок рядом с кодом. Для автоматизации подходит Codex CLI, а общий выбор приложения, CLI и IDE есть в инструкции по установке. Возможности продукта сверяйте с обзором Codex.

Частые вопросы

Нужно ли давать доступ ко всему проекту?

Нет. Для первой задачи достаточно одной папки, открытого файла или выделения. Секреты не добавляйте.

Как понять, что задача закончена?

Заранее задайте наблюдаемый результат: ожидаемый diff, тест или ручной сценарий. Ответ агента без проверки не является приёмкой.