Codex — не чат-бот, а агент: як формулювати завдання, щоб він робив їх правильно

Коротко (TL;DR)

Codex вміє сам читати файли проєкту, писати код і запускати команди. Тому працювати з ним треба не як із чат-ботом, якому «ставлять запитання», а як з виконавцем, якому дають завдання. Різниця між «агент напартачив» і «агент зробив рівно те, що треба» — це метод, а не везіння. Саме тут спотикаються ще на першому завданні.

Метод зводиться до одного повторюваного циклу: сформулювати завдання за формулою → вирішити, чи потрібне планування → обрати режим доступу → вирішити, де виконувати (локально чи в хмарі) → поправити на льоту → перевірити результат за чітким критерієм. Нижче — кожен крок із точними командами Codex, таблицею «яке завдання куди віддавати» та розбором того, де цей метод ламається на практиці.

Що потрібно, щоб цей гайд був корисним: Codex уже встановлений (CLI, хмара чи розширення для IDE), проєкт лежить у git — це вмикає відкати, — і 10 хвилин, щоб прочитати метод один раз. Усі команди й цифри звірені з офіційною документацією OpenAI на 16 липня 2026; Codex змінюється швидко, тому назви прапорців і моделей варто перевіряти під час читання.

Чому з Codex працюють не як із чат-ботом

Звичайна нейромережа в чаті відповідає текстом — ви читаєте відповідь і самі вирішуєте, що з нею робити. Codex влаштований інакше: це агент із реальним доступом до файлової системи та командного рядка. Він сам відкриває потрібні файли, вносить правки, запускає тести й повторює цикл «зібрати контекст → зробити дію → перевірити результат», доки не вважатиме завдання закритим. Ось як працює агент Codex, коротко.

BINANCE SIMPLE EARNЗмусь крипту працюватиВідсотки на USDT і BTC без блокування — гроші лишаються під рукою.Розмістити

Звідси головний висновок про метод: ваша робота — не написати один ідеальний запит, а дати агентові все, щоб він пройшов цей цикл сам. Достатньо контексту на вході, зрозумілу межу того, що вважається «готово», і спосіб перевірити себе. Якщо ви цього не дали, агент додумає за вас — і часто не так, як ви хотіли.

Codex для не-програміста: як зібрати перший робочий продукт

Один продукт на Codex: як довести ідею до живого URL, не потонувши в коді

AGENTS.md: інструкція, яку агент Codex справді читає перед роботою

AMD Instinct Coder: стійка на вісьмох MI325X обіцяє мінус 70% до ціни токенів

Codex під контролем: як пісочниця і схвалення вирішують, що агенту можна

Тут важливо не плутати два різні «методи». Є універсальний принцип роботи з будь-яким кодинг-агентом — «спершу вивчи і сплануй, потім пиши код»; ми розбирали його докладно в гайді про метод роботи з Claude Code. Ця стаття — про те, як користуватися Codex конкретно: його формулу завдання, його режими доступу, його вибір між локальним запуском і хмарою. Загальна філософія та сама, але важелі в Codex свої, і саме їх ми розберемо.

Формула завдання: Goal, Context, Constraints, Done when

Офіційний гайд OpenAI із найкращих практик пропонує будувати завдання для Codex із чотирьох елементів. Це і є базовий шаблон, до якого варто звикнути — по суті, окремий випадок загальної структури хорошого промпту (її ми розбирали в матеріалі про те, як писати промпти для нейромереж), заточений під агента.

• Goal — що зробити, одним конкретним реченням. Не «покращ авторизацію», а «додай обмеження: не більше 5 спроб входу за хвилину».
• Context — які файли, теки й документи важливі для завдання. Агент знайде і сам, але підказка економить його кроки і ваш ліміт.
• Constraints — стандарти й обмеження: який стиль коду, які бібліотеки не можна тягнути, що чіпати заборонено.
• Done when — за чим зрозуміти, що завдання виконане: тести зелені, поведінка змінилася, баг більше не відтворюється.

Саме останній пункт новачки найчастіше пропускають, а він — найцінніший. Без явного «done when» агент сам вирішує, коли зупинитися, і його уявлення про «готово» може не збігатися з вашим.

Порівняйте два формулювання одного завдання:

Практичне правило від практиків Codex: один конкретний приклад вартий більше за абзац пояснень. Якщо можете показати вхідні й очікувані дані, шматок лога з помилкою чи приклад потрібного формату — вставте його прямо в промпт. Для Codex CLI це працює так само, як для хмари: якість результату визначає якість постановки, а не довжина тексту.

Коли дробити завдання: Plan mode і контрольні точки

Велике завдання не можна вивалювати на агента одним шматком — він втрачає фокус і «йде» не туди. У Codex для цього є Plan mode: він вмикається слеш-командою /plan або поєднанням Shift+Tab (на 16 липня 2026). У цьому режимі агент спершу збирає контекст, ставить уточнювальні запитання й пропонує план — і лише після вашого схвалення чіпає код.

BINANCEДосі дивишся збоку?Ринок працює без вихідних. Рахунок на Binance відкривається за 2 хвилини.Почати зараз

Сенс рівно той самий, що й у циклі «вивчи → сплануй → напиши»: дешевше зловити помилку в плані на словах, ніж у трьохстах рядках готового коду. Але планувати все підряд — теж помилка: якщо правка описується одним реченням (одрук, перейменування, додати лог), режим планування лише додасть зайвий крок.

Для довгих завдань допомагає патерн контрольних точок. Розбийте роботу на етапи й після кожного вимагайте перевірюваного стану, перш ніж іти далі:

1. Тести за поточним етапом зелені.
2. Перевірка типів і лінтер чисті.
3. Робоче дерево git в осмисленому стані (можна відкотитися сюди).

Так ви не покладаєтеся на те, що агент утримає в голові все завдання цілком, а збираєте його з перевірених шматків. Це особливо важливо через реальні обмеження контексту, про які — у розділі про ризики.

Контекст без повторів: навіщо потрібен AGENTS.md

Якщо ви щоразу пояснюєте агентові одне й те саме — як влаштований проєкт, чим збирати, що не можна чіпати, — винесіть це в AGENTS.md. Це відкритий формат, свого роду «README для агентів»: markdown-файл, який Codex автоматично підвантажує в контекст перед стартом завдання. Сам стандарт AGENTS.md від початку не прив’язаний до Codex — його зараз курує не лише OpenAI, а й Agentic AI Foundation, тож той самий файл розуміють й інші агенти. Коротко, AGENTS.md — це що: місце для сталого контексту, яке агент читає без нагадувань.

Читається він каскадом, від загального до конкретного:

• ~/.codex/AGENTS.md — ваші особисті дефолти для всіх проєктів;
• AGENTS.md у корені репозиторію — командні стандарти;
• AGENTS.md у підтеці — локальні уточнення для конкретного модуля.

За конфлікту перемагає специфічніший файл — той, що ближче до поточної директорії. Стартовий чернетковий файл можна згенерувати командою /init (вона просканує репозиторій), але офіційна рекомендація — обов’язково донастроїти його під ваш реальний процес, а не лишати як є.

Тут ми розбираємо AGENTS.md лише як важіль методу: що це й навіщо. Повний синтаксис, розділи й тонкощі налаштування — тема окрема, у цій статті їх не розкриваємо. Заразом тримайте на думці: стара функція Custom Prompts (кастомні слеш-команди з ~/.codex/prompts) на 16 липня 2026 позначена як застаріла — її замінили Skills, повторно використовувані інструкції, якими можна ділитися через репозиторій.

Режими схвалення Codex: пісочниця й дозволи

Автономність агента — це не «довіряю все» чи «питаю на кожен чих», а два незалежні налаштування, які комбінуються під завдання. Розуміти їх — половина методу, бо від них залежить, наскільки Codex безпечний і наскільки часто він вас смикає.

Безпека тримається на двох шарах:

• Sandbox mode — що агентові фізично дозволено: лише читати, писати в робочу теку чи повний доступ; чи є мережа.
• Approval policy — коли агент зобов’язаний спитати дозволу перед дією.

За замовчуванням для git-репозиторію Codex пропонує пресет, який у документації названо «Auto» (на 16 липня 2026): --sandbox workspace-write --ask-for-approval on-request. Агент сам читає, править файли й запускає команди в робочій директорії, але питає дозвіл, щоб вийти за її межі або отримати доступ у мережу. Важлива деталь методу: мережу за замовчуванням вимкнено — і локально, і в хмарі на фазі виконання. Це не баг, а захист: увімкнений інтернет відкриває ризик prompt injection, коли агент «прочитає» й виконає шкідливі інструкції, сховані у вмісті вебсторінки.

Ось практична розкладка, який режим схвалення Codex обирати під завдання:

Останній рядок — це прапорець --dangerously-bypass-approvals-and-sandbox (аліас --yolo). Він вимикає і пісочницю, і схвалення; офіційна документація прямо позначає його як Elevated Risk і не рекомендує поза ізольованими контейнерами. Не робіть його дефолтом «щоб не заважав»: агент із повним доступом і без перевірок може виконати деструктивну команду, якої ви не побачите.

Між ручним схваленням і --yolo є третій шлях — Auto-review: запити на вихід за межу пісочниці перевіряє не людина, а окремий агент-рецензент. За виміром OpenAI (30 квітня 2026), у цьому режимі сесії зупиняються на підтвердження приблизно у 200 разів рідше, ніж за ручного схвалення, а схвалюється близько 99% таких ескалацій. Цифри — внутрішня телеметрія вендора, але механіка корисна: менше переривань без повної відмови від контролю. Про порівняння рівнів автономності різних агентів у нас є окремий розбір — особистий ІІ-агент OpenClaw.

Codex локально чи в хмарі: куди віддавати завдання

Коротка відповідь: інтерактивне завдання, де треба бачити кроки й чіпати локальні файли, запускайте в CLI; фонове, довге чи паралельне — віддавайте в хмару. Це не два конкурентні продукти, а два місця запуску одного агента під різні типи роботи.

Різниця за механікою принципова. Codex CLI виконується локально, у пісочниці на вашій машині: ви бачите кожен крок, у агента є доступ до ваших файлів і незакомічених змін. Codex Cloud піднімає під кожне завдання ізольований контейнер в інфраструктурі OpenAI, клонує репозиторій із GitHub і за замовчуванням від’єднаний від інтернету на фазі виконання. Ви надсилаєте завдання, ідете займатися іншим і забираєте готовий дифф, коли агент закінчив.

Один нюанс методу, який легко проґавити: на тарифах ChatGPT локальні повідомлення й хмарні завдання ділять спільний п’ятигодинний ліміт (на 16 липня 2026). Запустивши хмарне завдання під час локальної сесії, ви витрачаєте той самий пул. Тому «надішлю-но десяток хмарних завдань заразом» — не завжди безкоштовне рішення.

До речі про тарифи: доступ до Codex іде через плани ChatGPT — Free ($0), Go ($8), Plus ($20), Pro (від $100 на місяць), плюс оплата за токени через API-ключ (на 16 липня 2026; у API немає хмарних фіч на кшталт авто-рев’ю PR). Модельне сімейство на 16 липня 2026 — GPT-5.6 (варіанти Sol/Terra/Luna); їхні відмінності ми тут не дублюємо, є окремий розбір моделей GPT-5.6.

Як поправити агента: steer і черга

Поки Codex працює, ви не зобов’язані мовчати до кінця. У методу є два способи втрутитися, і плутати їх не варто:

• Steer — втрутитися негайно. Codex дає змогу «керувати» активним ходом: перенаправити агента прямо під час роботи, коли він явно пішов не туди й продовжувати немає сенсу.
• Черга — відкласти вказівку. Якщо правка вже придумалася, але скасовувати поточний крок не треба, поставте її наступною: агент дороблятиме почате й візьме вашу репліку потім.

Точні клавіші обох дій Codex CLI показує у своєму меню шорткатів (викликається ?) — від версії до версії вони змінюються, тому звіряйтеся з меню, а не заучуйте. Правило ж незмінне: збивати агента на льоту дорого — він втрачає контекст поточної дії. Якщо те, що ви хочете додати, не скасовує того, що відбувається просто зараз, ставте це в чергу, а не перебивайте.

Перевірка результату: definition of done, а не «на око»

Codex майже завжди повертає щось, що виглядає правдоподібно. Метод вимагає не вірити цьому «на око», а перевіряти за явним чек-листом — тим самим «done when», який ви задали на старті. Зібраний з офіційних критеріїв OpenAI, мінімальний definition of done для агентного завдання виглядає так:

1. Тести, що описують потрібну поведінку, — зелені (а не «код скомпілювався»).
2. Лінтер і перевірка типів чисті.
3. Дифф переглянуто очима: немає зайвих файлів, налагоджувального сміття, випадково закомічених секретів.
4. Поведінка реально змінилася — баг не відтворюється, фіча працює на прикладі.

Для третього пункту в Codex є вбудована команда /review: вона запускає окремого агента-рецензента. Можна порівняти з базовою гілкою (як рев’ю пул-реквесту), перевірити незакомічені зміни, конкретний коміт або задати свої інструкції — на що дивитися. Це дешевий спосіб зловити проблему до того, як ви приймете дифф. Наскільки це вбудовується в процес: у самій OpenAI, за її заявою, Codex рецензує 100% пул-реквестів — цифра з практики вендора, але напрямок показовий.

Часті помилки новачків

Більшість провалів методу — не про «дурну модель», а про пропущений крок:

• Немає «done when». Завдання без критерію готовності — це запрошення агентові зупинитися там, де йому зручно.
• Надто велике завдання одним шматком. Без Plan mode і контрольних точок агент втрачає фокус посередині.
• --yolo як режим за замовчуванням. Зручно рівно до першої деструктивної команди, якої ви не побачили.
• Дифф не читають. Прийняли «виглядає ок» — отримали зайві файли чи тихо зламаний тест.
• Розрахунок на заявлений максимум контексту. Реальне вікно буває помітно меншим за рекламне (див. ризики) — компактні завдання надійніші.
• Завдання чат-ботом, а не агентом. «Як мені зробити X?» замість «Зроби X, ось контекст і критерій» — ви втрачаєте весь сенс агента.

Ризики методу: де Codex ламається

Чесний метод враховує не лише те, як треба, а й те, що реально йде не так. Усі пункти нижче датовані й прив’язані до першоджерел; частина — повідомлення спільноти, а не підтверджені вендором факти.

• Стрибок витрати ліміту. 18 червня 2026 користувачі (зокрема на Pro-тарифі) масово зафіксували в issue-трекері зростання витрати п’ятигодинного ліміту в 10–20 разів — квота вичерпувалася за 2–3 промпти. Висновок для методу: агресивна автономність може несподівано дорого коштувати.
• Просідання контексту. 13 липня 2026 у трекері з’явилася скарга: заявлене вікно GPT-5.6 Sol у 1,05 млн токенів на практиці урізалося до 258 тис. Не покладайтеся на рекламний максимум — резервуйте запас, дробіть завдання.
• Аномальний запис на диск. Наприкінці червня 2026 спільнота (Reddit — 642 голоси, Hacker News, видання The Register) повідомила про баг Codex із частими записами на диск, які потенційно скорочують ресурс SSD. Офіційного визнання й фіксу на дату звірки не знайдено — тримайте на думці під час довгих локальних прогонів.
• Субагенти успадковують важку модель. У відкритому багу (issue від 9 липня 2026, відтворений різними користувачами) субагенти, породжені з потужної моделі, примусово лишаються на ній — не можна віддати просте паралельне підзавдання легшій моделі.
• Prompt injection і --yolo. Увімкнена мережа й знята пісочниця — це не лише зручність, а й відчинені двері для шкідливих інструкцій із зовнішнього вмісту.

Баланс: у Codex вистачає й задоволених користувачів — практики повідомляють про перехід з інших агентів і про те, що «80%+ завдань розв’язуються з одного заходу», а сторонній бенчмарк на 70 реальних enterprise-завданнях відзначив у Codex CLI найчистіший результат серед порівнюваних агентів (хай і не найшвидший). Ризики вище — не вирок інструменту, а місця, де метод має бути акуратнішим.

FAQ

Наскільки докладно писати завдання для Codex? Рівно настільки, щоб закрити чотири елементи: ціль одним реченням, потрібний контекст (файли/документи), обмеження й критерій готовності. Довжина сама собою не допомагає — один конкретний приклад корисніший за абзац загальних слів.

Чи обов’язково вмикати Plan mode щоразу? Ні. Для завдання в одне речення (одрук, перейменування, лог) планування лише додає крок. Plan mode окупається на середніх і великих завданнях, де важливо узгодити підхід до правки коду.

Чим режими схвалення Codex відрізняються від --yolo? Звичайні режими — це комбінація пісочниці (що фізично можна) і політики схвалень (коли питати). --yolo вимикає обидва шари одразу; документація позначає його як Elevated Risk і радить лише всередині ізольованого контейнера.

Codex локально чи в хмарі — що обрати новачку? Почніть із CLI: видно кожен крок, легко втрутитися й перевірити. Хмару беріть, коли завдання можна віддати у фон, запустити паралельно чи прогнати над GitHub-репо без локального встановлення. Пам’ятайте про спільний п’ятигодинний ліміт.

Чи потрібен AGENTS.md, якщо я лише починаю? Не обов’язково з першого дня, але корисно: щойно ви ловите себе на повторних поясненнях (чим збирати, що не чіпати), заведіть файл через /init і донастройте. Codex підхопить його автоматично.

Як переконатися, що агент зробив правильно? Перевіряйте за «done when»: зелені тести потрібної поведінки, чисті лінтер і типи, переглянутий очима дифф і реально змінена поведінка. Команда /review допомагає зловити проблеми до прийняття правок.