Codex в VS Code: как подключить расширение и войти

Чтобы подключить Codex в VS Code, установите из Extensions расширение Codex от OpenAI (openai.chatgpt), нажмите значок Codex и войдите через Sign in with ChatGPT (нужен Plus или выше) либо Use API Key; в Cursor и Windsurf доступно то же расширение. Из России включите VPN в режиме TUN, чтобы через него шёл трафик всей системы. Признак, что всё работает: панель открыта, папка проекта выбрана, первая небольшая правка видна в diff, а тест или ручная проверка проходит.

Что нужно для первой задачи

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

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

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

Установите Codex от OpenAI: в карточке расширения к названию Codex добавлена подпись OpenAI’s coding agent, издателем указан OpenAI с подтверждённым доменом openai.com, а идентификатором служит openai.chatgpt. Сверьте эти данные перед установкой, чтобы не поставить одноимённую рекламную копию.

В VS Code откройте панель Extensions сочетанием Ctrl+Shift+X на Windows и Linux или Cmd+Shift+X на macOS. Дальше выполните шаги:

1. Найдите Codex в каталоге расширений.
2. Сверьте издателя OpenAI и идентификатор openai.chatgpt.
3. Нажмите Install, установите и включите расширение.
4. Нажмите значок Codex; если его нет, выполните Codex: Open Codex Sidebar в палитре команд.

Расширение можно установить и через официальную страницу установки: откройте документацию OpenAI вручную и перейдите по ссылке в магазин VS Code. VS Code и совместимые редакторы используют Codex IDE extension; расширение открывает панель рядом с кодом, где можно продолжать диалог о файлах и предложенных изменениях.

Отдельно устанавливать Codex CLI через npm для расширения не нужно: оно содержит собственный исполняемый файл Codex. Настройка chatgpt.cliExecutable предназначена для разработчиков CLI и подменяет встроенный файл; ручная подмена может нарушить работу частей расширения.

Войдите через ChatGPT или API-ключ

На экране входа выберите Sign in with ChatGPT либо Use API Key: расширение поддерживает оба способа. В первом случае завершите вход в открывшемся браузере, который вернёт данные авторизации в Codex; во втором вставьте ключ в штатное поле Use API Key и нажмите OK.

При входе через ChatGPT расширение работает на Plus и старших планах, расход идёт из лимитов плана. С API-ключом оплата отдельная, по тарифам API, облачные функции недоступны. Сравнение тарифов и лимитов собрано в статье о подписке Codex.

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

По теме: Codex и GLM: подключение Z.AI и проверка провайдера

Как открыть Codex в Cursor и Windsurf

В Cursor и Windsurf установите Codex из встроенного каталога расширений и нажмите его значок. Если значка нет, откройте палитру команд через Ctrl+Shift+P на Windows и Linux или Cmd+Shift+P на macOS и выполните Codex: Open Codex Sidebar. На странице Codex для IDE есть отдельные ссылки установки для VS Code, Cursor, Windsurf и VS Code Insiders; Xcode и IDE JetBrains используют собственные интеграции.

В Open VSX расширение опубликовано как openai/chatgpt, издатель верифицирован. Версия этого каталога может отставать от Visual Studio Marketplace: на 07.10.2026 в Open VSX была 26.5908.31748 от 11.09.2026, а в Marketplace 26.51002.51308. Если вы сравниваете номера версий в разных редакторах, учитывайте, из какого каталога установлен Codex.

Выберите разрешения, модель и режим работы

Перед первой правкой выберите Ask for approval в переключателе разрешений под полем ввода. В зависимости от конфигурации там также доступны Approve for me и Full access. Выделение кода задаёт контекст запроса, но не ограничивает доступ к файлам: в workspace-write агент читает файлы, правит внутри рабочей области и запускает обычные команды, а в read-only только читает, и правки с командами требуют одобрения.

Модель, усилие рассуждения и режим выполнения меняются командами в поле ввода Codex. Для первой задачи можно выбрать модель, запросить план и следить за остатком лимитов; остальные команды пригодятся, когда вы переходите к проверке изменений или меняете место выполнения:

• /model выбирает модель, /reasoning задаёт усилие рассуждения.
• /plan включает режим плана.
• /review запускает ревью незакоммиченных изменений.
• /cloud переключает на облачное выполнение, /local возвращает выполнение в локальную рабочую область; облако доступно при входе через ChatGPT.
• /ide-context включает или выключает автоматический контекст IDE.
• /status показывает текущие лимиты, использование контекста и идентификатор чата.

Модель, разрешения и MCP расширение читает из общего с CLI файла config.toml. Чтобы открыть его, нажмите шестерёнку в панели Codex, выберите Codex Settings, затем Open config.toml.

Windows и проекты в WSL2

На Windows расширение работает нативно с собственной песочницей Windows. Если проекты и инструменты уже находятся в WSL2, включите в настройках VS Code chatgpt.runCodexInWindowsSubsystemForLinux; после изменения настройки VS Code перезагрузится.

Для этого нужен WSL2: поддержка WSL1 прекращена начиная с Codex 0.115.

По теме: Codex Micro: что это за контроллер и как его настроить

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

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

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

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

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

Чтобы передать контекст вручную, используйте команды палитры: Codex: Add to Codex Thread добавляет выделение, а Codex: Add File to Codex Thread добавляет файл целиком. Для нового чата расширение назначает Ctrl+N на Windows и Linux и Cmd+N на macOS, но сочетание срабатывает не в любом месте окна: если вместо чата открылся пустой файл, выполните в палитре Codex: New Chat in ChatGPT Sidebar.

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

По теме: Codex harness: что это и когда он нужен

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

Просмотрите diff рядом с кодом и сохраните только нужные изменения. Прочитайте каждую строку; если Codex затронул неожиданные файлы, отмените предложение и сузьте задачу, указав, какой файл и какое поведение требуется изменить.

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

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

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

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

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

Если расширение снова просит войти, выберите Sign in with ChatGPT и завершите вход в браузере: браузер вернёт данные авторизации в Codex. В меню профиля расширения виден активный аккаунт или статус API-ключа, там же находится Log out. CLI и расширение используют общий сохранённый вход, поэтому после выхода в одном из них вход потребуется заново в обоих.

Если вход не завершается или панель не получает ответов, а вы в России, включите VPN в режиме TUN: расширение ходит в сеть через VS Code, и VPN только в браузере не помогает. Настройка описана в инструкции о VPN для Codex, а способы оплатить подписку из России собраны в статье «Codex в России: доступ и оплата».

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

Когда выбрать приложение или CLI

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

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

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

Нет. Codex работает в папке, открытой в VS Code, а что ему там можно, задают разрешения Codex: в workspace-write агент читает файлы, правит внутри рабочей области и запускает обычные команды, в read-only только читает, а правки и команды требуют одобрения. Поэтому для первой задачи можно открыть отдельную учебную папку вместо всего проекта. Открытый файл и выделение задают контекст запроса, но доступ не ограничивают. Перед первой правкой выберите Ask for approval в переключателе разрешений под полем ввода. Секреты не добавляйте.

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

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