Як поставити 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; усередині панелі актуальну модель показує перемикач моделі.