Как поставить Codex в VS Code, Cursor и Windsurf и что он умеет прямо в редакторе

Коротко

Codex — это агент OpenAI, который сам читает проект, пишет и правит код. Кроме терминального CLI у него есть расширение для редактора: оно приносит того же агента прямо в VS Code, Cursor и Windsurf — с боковой панелью, инлайн-правками и делегированием тяжёлых задач в облако.

Что нужно, чтобы начать:

• Редактор — VS Code, VS Code Insiders, Cursor или Windsurf (это форки VS Code, ставится одно и то же расширение).
• Аккаунт — платный план ChatGPT (Plus/Pro/Team/Business/Edu/Enterprise, от $20/мес у Plus на 17 июля 2026) или ключ OpenAI API с кредитами.
• 5 минут на установку и вход.

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

Что такое IDE-расширение Codex и чем оно отличается от CLI

IDE-расширение Codex — это тот же самый агент, но встроенный в редактор кода, а не запущенный в терминале. В маркетплейсе оно называется «Codex – OpenAI’s coding agent», издатель — OpenAI, идентификатор openai.chatgpt.

Разница с терминальным Codex CLI не в «движке» (агент один), а в поверхности управления:

Microsoft вывел свои модели MAI-Image и MAI-Voice в паблик превью — экономия до 89% против OpenAI

Codex откуда угодно: запускаем задачу из ChatGPT и ведём её с телефона

Как Codex Cloud выполняет задачу в облаке и возвращает готовый pull request

Codex CLI: что происходит на экране терминала и как вести агента по циклу

OpenAI подняла план стройки до $750 млрд — и впервые сама строит дата-центр

• CLI живёт в терминале: текстовый интерфейс, полный контроль, удобен для скриптов и автоматизации.
• Расширение живёт в редакторе: боковая панель-чат, которая видит ваши открытые файлы, показывает правки прямо в коде и даёт принять их одним кликом.

Если проводить аналогию, расширение относится к CLI примерно так же, как графический клиент Git к командам git в консоли: под капотом одно и то же, но работать визуально — привычнее большинству. Тем, кто раньше не сталкивался с агентами в редакторе, стоит сначала понять, чем агент в редакторе вообще отличается от обычного чата — это снимает половину вопросов.

Важная деталь про зрелость: расширение официально анонсировано 28 августа 2025 года, а на странице маркетплейса на 17 июля 2026 у него порядка 11,8 млн установок. По данным AMA команды Codex (10 июля 2026), Codex в целом используют более 5 млн человек в неделю — вдвое больше, чем тремя месяцами ранее. Продукт живой и активно развивается, поэтому конкретные версии моделей внутри панели быстро устаревают.

Где ставится расширение: VS Code, Cursor, Windsurf

Одно и то же расширение (openai.chatgpt) ставится в VS Code и во все его форки. Для двух других сред у Codex своя, отдельная интеграция — это важно не перепутать.

Отсюда частая путаница: в Cursor и так есть свой ИИ-агент, поэтому пользователи спрашивают, «а Codex его заменяет?». Нет. Расширение Codex — это надстройка OpenAI поверх чужого редактора, оно добавляет агента OpenAI, но не трогает родные функции самого редактора. Если сравниваете Codex именно с движком Cursor, у нас есть отдельный разбор ИИ-редактора Cursor — там видно, где заканчивается один инструмент и начинается другой.

Установка расширения Codex в VS Code: пошагово

Ниже — установка на примере VS Code; в Cursor и Windsurf шаги те же, только маркетплейс свой.

1. Откройте менеджер расширений. Иконка «Extensions» на боковой панели или Ctrl+Shift+X (на macOS — Cmd+Shift+X).
2. Найдите расширение. В поиске введите OpenAI Codex. Нужен официальный пункт «Codex – OpenAI’s coding agent» издателя OpenAI (проверьте издателя — клонов в маркетплейсе хватает).
3. Нажмите Install. Расширение поставится за несколько секунд.
4. Найдите иконку Codex на боковой панели. Если её нет — откройте палитру команд (Ctrl+Shift+P) и выполните «Codex: Open Codex Sidebar». По умолчанию панель открывается справа.
5. (Опционально) перетащите панель на правую сторону редактора — так получается удобный сплит: код слева, Codex справа.

В Cursor расширение можно поставить и через Quick Open командой cursor:extension/openai.chatgpt.

Как расширение связывается с аккаунтом

После установки панель попросит войти. Здесь два пути:

• Sign in with ChatGPT — самый простой. Нажимаете кнопку, в браузере входите в тот же аккаунт OpenAI, что и для ChatGPT, подтверждаете доступ. Кредиты на использование Codex уже входят в ваш платный план, отдельной подписки на Codex нет.
• Ключ OpenAI API — альтернатива, требует чуть больше настройки; расход идёт по кредитам вашего API-аккаунта.

Ключевой момент, который экономит время: расширение использует ту же авторизацию и тот же конфиг, что и CLI. Настройки лежат в общем файле ~/.codex/config.toml. Вошли один раз в расширении — терминальный codex тоже готов к работе, и наоборот. Логиниться дважды не нужно. Если раньше вы ставили другой терминальный агент — логика знакома: так же устроена установка Claude Code, только команды и файлы конфигурации у него свои.

Что до плана: расширение поставить можно бесплатно, но без активного плана ChatGPT или ключа API с кредитами агент работать не станет — это предусловие, а не разовая оплата. Детальный разбор тарифов и оплаты — тема отдельная, здесь достаточно знать, что Plus (от $20/мес на 17 июля 2026) уже включает Codex.

Что Codex даёт прямо в редакторе

Расширение — это не «ещё один чат сбоку». Оно работает с контекстом вашего кода:

• Контекст открытых файлов. Можно сослаться на открытые файлы, выделенный фрагмент и недавние треды прямо из окна ввода. На конкретный файл — через синтаксис @имя-файла (например, @auth.ts): Codex прочитает файл целиком, не нужно копировать код в чат.
• Инлайн-правки с приёмкой. Когда агент предлагает изменения, рядом с кодом показывается короткая сводка и изменённые строки. Их можно проинспектировать и принять — выборочно. Перед крупной правкой дока советует делать git-чекпоинт, чтобы легко откатиться.
• Запуск команд. В режиме агента Codex может выполнять команды терминала — с вашего подтверждения.

Три режима: Chat, Agent, Agent (Full Access)

В панели есть переключатель режимов — по сути, это лесенка уровня доверия к агенту. Их путают чаще всего, поэтому разведём чётко.

По умолчанию стоит режим Agent, и он спрашивает разрешение на каждую правку и команду. Пока вы сами не переключитесь на Full Access, навредить агенту сложно — это встроенный предохранитель.

Гибридный цикл: начал локально — дослал в облако

Главная фишка расширения — не инлайн-правки сами по себе (они есть у многих), а бесшовный переход между локальной работой и облаком. Именно это конкуренты называют настоящим отличием расширения.

Цикл выглядит так:

1. Начинаете локально. Мелкие интерактивные правки в режиме Agent — быстро, с подтверждениями, видите результат сразу в коде.
2. Упёрлись в долгую задачу? Нажимаете «Run in the cloud» — и та же задача уходит в облако Codex.
3. Облако считает в фоне. Задача выполняется в изолированном контейнере-песочнице. VS Code можно закрыть — работа не прервётся.
4. Возвращаетесь и принимаете diff. Готовые изменения приходят как diff, который можно посмотреть и применить, не выходя из редактора. Тред разговора сохраняется.

То есть расширение — это «пульт» сразу к двум поверхностям: локальному агенту для быстрых итераций и облачному — для тяжёлых фоновых задач. Переключаться между инструментами не нужно.

CLI против IDE-расширения: что где удобнее

Codex в IDE или в CLI — не вопрос «что лучше», а «что под какую задачу». Поверхности дополняют друг друга; вот честное разведение по задачам.

Вывод простой: для повседневной работы в коде удобнее расширение, для автоматизации и тонкой настройки — CLI. А поскольку аккаунт и конфиг общие, держать оба и переключаться по ситуации — нормальная практика.

Типичные грабли, ограничения и риски

Где расширение спотыкается и на что смотреть внимательно:

• Windows — экспериментально (на 17 июля 2026). Штатно расширение работает на macOS и Linux; на Windows поддержка помечена как экспериментальная, OpenAI советует запускать через WSL. Поведение изоляции может отличаться.
• Панели нет после установки. Частая мелочь: иконка Codex не появилась. Решение — палитра команд Ctrl+Shift+P → «Codex: Open Codex Sidebar». Помогает и перезапуск редактора.
• Расширение не заменяет CLI. В IDE-версии нет профилей, движка хуков, перебивания на ходу (Enter/Tab) и неинтерактивного codex exec. Для скриптов и CI всё равно нужен терминал.
• Full Access опасен «на всякий случай». Включённый заранее режим Agent (Full Access) снимает подтверждения и даёт агенту доступ к файлам и сети — можно получить лишние изменения. По умолчанию держите Chat или Agent.
• Нужен платный план или кредиты. Без активного плана ChatGPT либо ключа API с кредитами расширение бесполезно.

Продвинутые приёмы

Три приёма, которые редко описывают, а они экономят время:

1. Сплит «код + Codex». Перетащите панель Codex на правую сторону редактора — получите постоянный сплит: слева код, справа агент. Контекст выделенного фрагмента подхватывается автоматически.
2. @file вместо копипаста. Не вставляйте куски кода в чат — ссылайтесь через @auth.ts, @user.model.ts. Codex читает файлы целиком, и контекст между файлами не рвётся.
3. Локально — облако одним движением. Не переписывайте тяжёлую задачу заново в облачном интерфейсе: начните в расширении и нажмите «Run in the cloud» — тред и контекст переедут сами.

FAQ

Codex как расширение VS Code — это бесплатно? Само расширение ставится бесплатно, но для работы нужен платный план ChatGPT (Plus/Pro/Team/Business/Edu/Enterprise, от $20/мес у Plus на 17 июля 2026) либо ключ OpenAI API с кредитами. Отдельной подписки именно на Codex нет — кредиты входят в план.

Это тот же аккаунт, что и у терминального CLI? Да. Расширение и CLI используют одну авторизацию и общий конфиг ~/.codex/config.toml. Вошли в одном — второе тоже готово к работе.

Чем расширение Codex отличается от родного агента Cursor? Расширение добавляет в Cursor агента OpenAI как надстройку, но не заменяет собственный ИИ редактора. Это два разных инструмента, которые могут сосуществовать в одном окне.

Почему после установки нет иконки Codex? Откройте палитру команд (Ctrl+Shift+P) и выполните «Codex: Open Codex Sidebar». Если не помогло — перезапустите редактор и проверьте, что установлено расширение именно издателя OpenAI.

Работает ли расширение на Windows? Работает, но поддержка Windows на 17 июля 2026 помечена как экспериментальная; OpenAI рекомендует запуск через WSL. На macOS и Linux расширение работает штатно.

Где смотреть актуальный статус и модели? Состав моделей и цифры (установки, версии) меняются быстро. Самое свежее — на странице расширения в Visual Studio Marketplace и в официальной доке OpenAI по Codex; внутри панели актуальную модель показывает переключатель модели.