Для подключения Codex к VS Code установите официальное расширение OpenAI, войдите через ChatGPT либо API-ключ и откройте папку проекта. После этого агент сможет обсуждать код и, в пределах выданных разрешений, менять файлы и выполнять команды.
Codex не заменяет Python, Node.js, компилятор C или зависимости приложения. Если тесты не запускаются вручную, установка AI-расширения сама по себе их не исправит. Сначала подготовьте обычную рабочую среду VS Code, затем добавляйте агента.
Установите именно официальное расширение
Откройте Extensions и найдите расширение с идентификатором openai.chatgpt, издатель OpenAI. Надёжнее перейти к установке из официального руководства Codex IDE extension. Похожее название не подтверждает, что расширение принадлежит OpenAI.
После установки нажмите значок Codex. Если панель не появилась, найдите в палитре Codex: Open Codex Sidebar. При запросе перезагрузки окна сохраните файлы и выполните её.
Расширение для VS Code и отдельное настольное приложение являются разными интерфейсами. Команды и возможности из одного интерфейса не следует автоматически переносить в другой. Здесь рассматривается работа внутри редактора.
Как войти: ChatGPT или API-ключ
При входе через ChatGPT расширение открывает браузер. Авторизуйтесь в нужной учётной записи и вернитесь в редактор. Доступ определяется возможностями аккаунта и настройками рабочей области. Не считайте наличие любого аккаунта гарантией неограниченного доступа ко всем моделям.
Второй вариант, Use API Key, использует ключ OpenAI Platform. Расходы при таком входе учитываются по API, отдельно от включённого использования через ChatGPT. Выберите способ сознательно: подписка ChatGPT не превращает API-запросы в бесплатные. Оба варианта и различия биллинга описаны в документации аутентификации.
Не вставляйте ключ в исходники, .vscode/settings.json, README или запрос агенту. Используйте предусмотренное поле входа. Файл кэшированных учётных данных Codex тоже является секретом, а не диагностическим логом, который можно публиковать.
Откройте правильную папку и подготовьте контрольную точку
Выберите корень конкретного проекта, а не домашнюю папку с документами. До первой правки проверьте:
git status
Если есть незавершённые изменения, разберите их и сохраните нужную контрольную точку. Не просите агента начинать большой рефакторинг поверх неизвестного набора правок. Для первого знакомства удобно использовать отдельный учебный репозиторий без ключей и данных клиентов.
Сначала отправьте диагностическую задачу:
Изучи структуру открытого проекта. Ничего не меняй и не устанавливай.
Назови точку входа, менеджер зависимостей и существующие команды тестов.
Для каждого вывода укажи файл, на который опираешься.
Если команду тестов найти не удалось, так и напиши.
Проверьте названные файлы. Хороший первый ответ должен опираться на ваш репозиторий, а не предлагать типовой npm test для любого проекта. Контекст открытых файлов и выделенного кода описан в руководстве по запросам к Codex.
Ограничьте права агента
Для обзора проекта достаточно режима без изменений. Для реализации небольшой задачи разрешите работу в пределах проекта и внимательно читайте запросы на расширение доступа. Не включайте полный доступ просто ради исчезновения подтверждений.
Здесь действуют два разных механизма. Песочница технически ограничивает действия команд, а политика подтверждений определяет, когда агент спрашивает пользователя. Установка запрета на вопросы сама по себе не создаёт безопасную изоляцию. Сетевые ограничения также зависят от активной конфигурации. Это разграничение объясняет официальное руководство по безопасности.
Если в проекте есть доступ к production, платёжным сервисам или облачным данным, не используйте его для первого эксперимента. Скопируйте необходимый код без секретов в тестовую среду и работайте с тестовыми данными. Текстовое «не трогай production» полезно, но не заменяет отсутствие production-доступа.
Первая задача: одна правка и проверяемый результат
Выберите небольшой участок, поведение которого вы понимаете. Например, функцию расчёта суммы из гайда по Python. Запрос может выглядеть так:
В main.py функция total_price должна отклонять отрицательные price
и quantity с ValueError. Сохрани поведение для нуля и положительных
целых чисел. Добавь тесты в test_main.py.
Не меняй зависимости и остальные файлы.
Запусти тесты выбранным Python из .venv.
В конце покажи список изменённых файлов, команду проверки и её результат.
Если тесты запустить не удалось, не называй их пройденными.
После выполнения откройте diff. Проверьте не только новые строки, но и удалённые. Запустите тесты самостоятельно в терминале. Если агент изменил пять файлов вместо двух, выясните зачем; красивое объяснение не заменяет соответствие задаче.
Что записать в AGENTS.md
В корне репозитория можно хранить короткие инструкции для агента. Пример для проекта из предыдущего раздела:
# Правила проекта
- Основной код находится в main.py, тесты в test_main.py.
- Используй существующее окружение .venv.
- Запускай pytest через Python этого окружения.
- Не добавляй зависимости без отдельного согласования.
- Не изменяй .env и не публикуй учётные данные в ответах.
- После работы перечисли изменённые файлы и фактически выполненные проверки.
Не копируйте эти пути в другой проект без изменения. Инструкции должны отражать существующую структуру. После редактирования файла начните новую сессию, чтобы проверить загрузку актуальных правил.
Codex поддерживает глобальные и вложенные инструкции; более конкретные файлы участвуют в цепочке правил для рабочего каталога. Их порядок описан в документации AGENTS.md. Сам файл не является песочницей и не блокирует действия на уровне ОС.
Нужно ли ставить WSL в Windows
WSL не является безусловным требованием для любого запуска Codex в Windows. В текущей документации предусмотрена нативная Windows-песочница. Linux-среда полезна, когда проект уже рассчитан на WSL или требует Linux-инструментов. Не устанавливайте её только потому, что так написано в старом руководстве. Условия и ограничения изложены в Windows sandbox.
Если работаете через WSL, Git, зависимости и команды должны относиться к Linux-проекту. Открыть bash во встроенном терминале ещё не значит перенести весь extension host в WSL. Проверьте индикатор удалённой среды и расположение проекта.
Если Codex не работает
| Симптом | Что проверить |
|---|---|
| Нет панели | Правильность расширения, его включение, команду Open Codex Sidebar |
| Вход выполнен, доступа нет | Аккаунт, выбранную рабочую область и ограничения администратора |
| Видит не те файлы | Корень открытого проекта и приложенный контекст |
| Не запускаются тесты | Окружение языка, зависимости и рабочий каталог |
| Ошибка доступа к каталогу или сети | Реальные разрешения, а не только текст запроса |
| API перестал отвечать | Статус ключа, API-биллинга и лимитов; не публикуйте ключ в логах |
Не фиксируйте в настройках случайный идентификатор модели из чужого скриншота. Выберите доступную вашему аккаунту модель в интерфейсе и сначала проверьте небольшой запрос. Рабочая настройка Codex проверяется цепочкой: правильный проект, верный контекст, ограниченная правка, просмотр diff и реально выполненные тесты.