Перейти до вмісту
AIupick

Посібник: розробники · завдань: 18

ШІ для розробників: агенти для програмування, витрати й безпечна передача завдань

Якщо ви вже користуєтеся автодоповненням і чатом, наступний крок — агенти, які читають репозиторій, запускають команди й відкривають pull request. Чи заощадить це час, залежить не стільки від моделі, скільки від налаштування. Перша частина підходить для будь-якого агента для програмування; частини про Claude Code і Codex розбирають команди, файли й налаштування кожного з них за офіційною документацією.

  1. Будь-який агент для програмування

    01

    Дайте агентові завдання, виконання якого він може довести

    Агенти провалюються на «покращ це» і справляються із завданнями, що закінчуються перевіркою: тест, що падає і має пройти, команда, вивід якої має змінитися. Впишіть доказ у завдання, і агент працюватиме, доки не закінчить, а не зупиниться, щойно все виглядатиме готовим.

    Приклад

    «Виправ парсер дат для тижневих дат ISO. Готово — це коли npm test -- dates проходить, зокрема новий тест для 2026-W01. Не змінюй тести.» Агент запускає тест, доки той не пройде, і вставляє вивід; ви переглядаєте diff на 30 рядків, а не здогадку.

    Як це зробити

    1. 1Перш ніж передати завдання, напишіть перевірку або вкажіть на неї: тест, що падає, або команду та її очікуваний вивід.
    2. 2Дайте агентові завдання за допомогою промпту з цієї сторінки, зазначивши файли, які він може змінювати, і ті, які не може.
    3. 3Нехай він сам запустить перевірку й вставить остаточний вивід.
    4. 4Переглядайте diff як pull request колеги: успішна перевірка починає рев'ю, а не завершує його.

    Вбудовано

    Промпт для копіювання

    Завдання: [зміна].
    Готово — це коли [тест або команда] проходить і виводить [очікуваний вивід]. Запусти це, перш ніж завершити, і встав результат.
    Ти можеш змінювати: [шляхи]. Не змінюй: [шляхи], залежності й тести.
    Якщо не вдається домогтися, щоб перевірка проходила, зупинись і поясни чому, а не обходь перевірку.

    Де все йде не так

    • Агенти іноді домагаються проходження тесту, послаблюючи його. Забороніть змінювати тести й шукайте таке в diff.
    • Завдання, завелике для однієї перевірки, завелике й для однієї передачі. Розділіть його.
  2. 02

    Запускайте завдання в хмарі, поки займаєтеся іншим

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

    Приклад

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

    Як це зробити

    1. 1Виберіть той, що поруч із вашим кодом: Codex Cloud, хмарний агент Copilot на GitHub або Claude Code on the web.
    2. 2Переконайтеся, що в його середовищі можна встановити ваші залежності й запустити тести: без них агент лише вгадує.
    3. 3Надсилайте невеликі незалежні завдання, кожне з власною перевіркою, як у завданні вище.
    4. 4Нехай кожен pull request спершу прочитає автоматичний рецензент, а потім перегляньте його самі.

    Вбудовано

    Промпт для копіювання

    У цьому репозиторії: [завдання].
    Контекст: [де в коді, пов'язаний issue].
    Готово, коли: [тест або команда] проходить у твоєму середовищі; додай її вивід в опис pull request.
    Pull request має містити менше ніж [кількість] змінених рядків. Якщо потрібно більше, зупинись і запропонуй, як його розділити.

    Де все йде не так

    • Тести, яким потрібні секрети чи сервіси, що ви не налаштували, пропускаються або падають. Зелений запуск без них мало що доводить.
    • Кілька агентів, що працюють над пов'язаним кодом, створюють pull request, які конфліктують. Тримайте паралельні завдання в різних частинах коду.
  3. 03

    Нехай перевірки працюють без вас

    Не витрачайте час рев'ю на те, що може перевірити машина. Хуки запускають ваш форматер, лінтер і тести після кожної зміни агента, а бот-рецензент читає кожен pull request раніше за вас. Тоді ваше рев'ю — про архітектуру, а не про одруківки.

    Приклад

    Хук запускає форматер і модульні тести після кожного редагування. Зміна агента ламає два тести; агент бачить збій у виводі хука й виправляє його ще до того, як ви подивитеся. Потім бот-рецензент позначає один необроблений випадок помилки, і щодо нього вирішуєте ви.

    Як це зробити

    1. 1Запишіть команди збирання, тестування й лінтингу у файл інструкцій, який агент читає на початку кожного сеансу; назву файлу вказано в документації кожного агента.
    2. 2У Claude Code додайте хуки, які запускають форматер і тести після кожного редагування, щоб агент бачив збої й виправляв їх.
    3. 3Нехай бот переглядає кожен pull request: увімкніть «Automatic review» у Codex або призначте Copilot рецензентом.
    4. 4Коли агент двічі робить ту саму помилку, перетворіть її на тест або правило у файлі інструкцій.

    Вбудовано

    Промпт для копіювання

    Прочитай цей репозиторій і напиши файл інструкцій для агентів для програмування:
    1. Точні команди для встановлення, збирання, тестування, лінтингу й форматування.
    2. Структуру проєкту не більше ніж у 10 рядках.
    3. Домовленості, які новачки тут порушують, з одним прикладом для кожної.
    4. Чого агент ніколи не має тут робити, наприклад змінювати міграції чи редагувати згенеровані файли.
    Наводь лише команди, які ти успішно запустив; решту познач як «не перевірено».

    Де все йде не так

    • Файл інструкцій із командами, які вже не працюють, привчає агента його ігнорувати. Запускайте їх знову, коли змінюється налаштування.
    • Боти-рецензенти теж упевнено помиляються. Сприймайте їхні коментарі як пропозиції.
  4. 04

    Підключайте агента до своїх інструментів із мінімальним доступом

    Агент хороший рівно настільки, наскільки хороше те, що він бачить: issues, документація, логи, схема бази даних. MCP підключає все це, але кожне підключення — це доступ, а текст ззовні, який агент читає, може містити інструкції. Починайте з доступу лише для читання й розширюйте його тільки тоді, коли цього потребує завдання.

    Приклад

    Агент читає issue 482 у трекері, знаходить стек викликів у логах і перевіряє документацію бібліотеки, потім називає файл, у якому помилка, — усе через токени лише для читання. Виправлення він пише у вашому репозиторії, де ви переглядаєте його як зазвичай.

    Як це зробити

    1. 1Запишіть, що ви найчастіше вставляєте в чати, як-от issues, логи помилок, документацію чи схему. Підключіть це насамперед.
    2. 2Додайте для кожного з них офіційний сервер MCP із токеном, який може лише читати. У Gemini CLI розширення може містити сервер MCP разом із його налаштуванням.
    3. 3Дайте агентові завдання, для якого вони потрібні, і перевірте, що він звернувся до правильного.
    4. 4Раз на кілька тижнів видаляйте сервери, якими більше не користуєтеся.

    Вбудовано

    Промпт для копіювання

    Перш ніж щось змінювати: прочитай issue [номер] у трекері, знайди помилку в логах і перевір документацію для [бібліотека].
    Скажи, що тобі дало кожне джерело і в якому файлі, на твою думку, помилка.
    Нічого не записуй у жоден підключений інструмент.

    Де все йде не так

    • Вебсторінка, issue чи документ можуть містити текст, написаний для того, щоб керувати агентом. Не давайте доступу на запис інструментам, які читають вміст ззовні.
    • Токени в конфігураційних файлах витікають. Використовуйте сховище секретів клієнта або змінні середовища, але ніколи не репозиторій.
  5. 05

    Підписка чи оплата за токени: що вибрати

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

    Приклад

    Тиждень щоденної роботи з агентом — це приблизно 40 мільйонів вхідних і 3 мільйони вихідних токенів. Порахуйте вартість за сторінкою цін API для моделі, якою користуєтеся, і порівняйте з місяцем підписки. Якщо підписка дешевша і її ліміти вміщують ваш тиждень, беріть її, а для CI тримайте ключ API з лімітом.

    Як це зробити

    1. 1Перевірте, за що ви вже платите: плани ChatGPT включають Codex, а платні плани Claude — Claude Code.
    2. 2Запишіть використання токенів у кількох типових сеансах там, де агент його показує.
    3. 3Оцініть вартість цього використання на нашій сторінці цін API й порівняйте з підпискою.
    4. 4Для автоматизації та CI використовуйте ключі API з лімітом витрат, щоб цикл не набрав великий рахунок.

    Вбудовано

    Промпт для копіювання

    Ось моє використання за [кількість] типових сеансів: [вхідні й вихідні токени]. Я працюю приблизно [кількість днів] днів на тиждень.
    Оціни мою місячну вартість за токени за цими цінами: [вставте зі сторінки цін API].
    Порівняй її з підпискою за [ціна] на місяць. Покажи обчислення, щоб їх можна було перевірити.

    Де все йде не так

    • Підписки теж мають ліміти використання. Якщо досягти ліміту посеред завдання, втрачається час; перевіряйте ліміт, а не лише ціну.
    • Модель впливає на рахунок більше, ніж будь-що інше. Порівнюйте за тією моделлю, якою справді користуєтеся.
  6. Claude Code

    06

    Хай кожен сеанс починається однаково завдяки CLAUDE.md

    Якщо ви пояснюєте команди збирання й домовленості на початку кожного сеансу, ви робите те, для чого існує CLAUDE.md. Claude читає його на початку кожного сеансу; тримайте його коротким і правдивим, і ті самі помилки перестануть повторюватися.

    Приклад

    Репозиторій, де Claude постійно запускав npm test замість проєктного pnpm test:unit і постійно редагував згенеровані файли. Два рядки в CLAUDE.md — правильна команда й «ніколи не редагуй src/gen/» — і обидві помилки зникають.

    Як це зробити

    1. 1Запустіть /init у репозиторії: команда аналізує кодову базу й пише початковий CLAUDE.md або пропонує покращення до наявного.
    2. 2Спільні правила, як-от команди збирання й тестування та стандарти коду, тримайте в ./CLAUDE.md і зафіксуйте його в репозиторії. Власні вподобання пишіть у ~/.claude/CLAUDE.md для всіх проєктів або в CLAUDE.local.md для цього.
    3. 3Посилайтеся на довші документи, а не вставляйте їх: @path/to/file імпортує інший файл під час запуску.
    4. 4Щоразу, коли Claude двічі помиляється в тому самому, додайте один рядок, який би цьому запобіг.

    Промпт для копіювання

    Прочитай цей репозиторій і покращ CLAUDE.md. Обсяг — до 60 рядків:
    1. Точні команди для збирання, тестування й лінтингу.
    2. Структура в кількох рядках.
    3. Домовленості, які новачок тут порушує.
    4. Файли й папки, які ніколи не можна редагувати.
    Видали все, що вже неправда. Команди, які ти не запускав, познач як «не перевірено».

    Де все йде не так

    • Усе в CLAUDE.md завантажується в кожному сеансі й займає контекст. Переносьте подробиці у файли, які він імпортує.
    • Інструкції, що вже не відповідають дійсності, гірші, ніж жодних. Перевіряйте команди знову, коли змінюється налаштування.

    З офіційної документації: Claude Code docs: How Claude remembers your project

  7. 07

    Спершу план, потім редагування

    Коли зміна зачіпає багато файлів, дорога помилка — хибний підхід, а не хибний рядок. У режимі планування Claude досліджує код і пише план, не редагуючи ваших вихідних файлів; ви виправляєте план, а потім схвалюєте його.

    Приклад

    Перенесення автентифікації з cookies на токени в 14 файлах. Перший план забуває про мобільний клієнт; ви вказуєте на це, у плані з'являється ще один крок, і лише тоді Claude щось редагує.

    Як це зробити

    1. 1Натискайте Shift+Tab, доки в рядку стану не з'явиться «plan mode on», або почніть промпт із /plan.
    2. 2Опишіть зміну й те, що не має змінитися. Claude все одно може запускати команди, щоб дослідити код, але під час планування не редагує файлів.
    3. 3Читайте план як проєктну нотатку: неправильний файл, пропущений випадок, завелика зміна. Просіть виправлень, доки план не стане правильним, а потім схваліть його.
    4. 4Перед наступним, не пов'язаним завданням почніть заново з /clear.

    Промпт для копіювання

    /plan Зміни [що] так, щоб [мета]. Обмеження: [що не має змінитися].
    Перелічи файли, які ти зачепиш, порядок змін, тест, що доводить кожен крок, і все, у чому ти не впевнений. Нічого не редагуй, доки я не схвалю.

    Де все йде не так

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

    З офіційної документації: Claude Code docs: Choose a permission mode · Claude Code docs: Commands · Claude Code docs: Best practices

  8. 08

    Перестаньте схвалювати ту саму команду п'ятдесят разів

    Коли ви вручну схвалюєте кожен запуск тестів, ви звикаєте тиснути «так», не читаючи. Один раз дозвольте безпечні повторювані команди в налаштуваннях проєкту, забороніть небезпечні, а запити залиште для всього іншого.

    Приклад

    Команда розробників у спільних налаштуваннях проєкту дозволяє запуск тестів і лінтингу та забороняє читати файли .env. Запитів лишається небагато — лише для команд, які варто прочитати, і ні в чиєму сеансі не можна відкрити ключі.

    Як це зробити

    1. 1Відкрийте /permissions, щоб побачити всі правила й файл налаштувань, з якого походить кожне.
    2. 2Спільні правила команди розробників запишіть у .claude/settings.json і зафіксуйте в репозиторії. Особисті правила — у ~/.claude/settings.json або .claude/settings.local.json.
    3. 3Правила перевіряються в такому порядку: спершу deny, потім ask, потім allow, тож одне правило deny переважує будь-яке allow.
    4. 4Перемикайте режими за допомогою Shift+Tab: acceptEdits схвалює редагування файлів у робочому каталозі. bypassPermissions вимикає запити й перевірки безпеки; документація радить використовувати його лише в ізольованих контейнерах або віртуальних машинах без доступу до інтернету.

    Промпт для копіювання

    Переглянь команди, які ти запускав у цьому сеансі. Запропонуй правила дозволів для .claude/settings.json: дозволь команди лише для читання й тестові команди, якими ми користуємося щодня, заборони все, що читає секрети або видаляє щось поза проєктом, а для всього іншого залиш запит. Поясни кожне правило одним рядком.

    Де все йде не так

    • Правило allow, що збігається з будь-якою командою, — те саме, що повна відсутність запитів. Дозволяйте точні команди.
    • Правила в .claude/settings.json після фіксації в репозиторії діють для всієї команди. Переглядайте їх як код.

    З офіційної документації: Claude Code docs: Configure permissions · Claude Code docs: Settings files and precedence · Claude Code docs: Choose a permission mode

  9. 09

    Тримайте кожен сеанс зосередженим

    Сеанс, у якому було три не пов'язані завдання, досі тримає всі три в контексті, і це помітно. Очищайте контекст між завданнями, стискайте довгі із зазначенням фокусу, а широкі пошуки доручайте субагентам, які працюють у власному контексті.

    Приклад

    Після виправлення бага ви просите рефакторинг у тому самому сеансі, і Claude далі тримається старого обхідного рішення для цього бага. /clear і одне речення контексту — і цього вже немає.

    Як це зробити

    1. 1Між не пов'язаними завданнями /clear починає нову розмову з порожнім контекстом.
    2. 2У довгому завданні /compact із фокусом, наприклад «/compact збережи план і тест, що падає», підсумовує все попереднє.
    3. 3Широкі пошуки передавайте субагентові: кожен працює у власному контекстному вікні, тож до вашого сеансу повертається лише його відповідь.
    4. 4Claude Code також сам стискає контекст, коли наближається до ліміту; якщо стиснути його самостійно у слушний момент, збережеться те, що вибрали ви.

    Вбудовано

    Промпт для копіювання

    /compact Збережи: мету, план, змінені досі файли й тест, який досі падає. Відкинь дослідження.

    Де все йде не так

    • /clear забуває розмову. Усе, що знадобиться знову, спершу запишіть у CLAUDE.md.
    • Відповідь субагента — це все, що ви отримуєте. Просіть у нього шляхи до файлів і номери рядків, а не лише висновки.

    З офіційної документації: Claude Code docs: Commands · Claude Code docs: Best practices · Claude Code docs: Create custom subagents

  10. 10

    Запускайте два завдання одночасно без зіткнень

    Два сеанси в одній робочій копії редагують ті самі файли, заважаючи один одному. claude --worktree дає кожному сеансу власну копію у власній гілці, тож рефакторинг і виправлення бага можуть іти паралельно.

    Приклад

    Оновлення залежності в одному worktree і виправлення інтерфейсу в іншому, обидва працюють, поки ви переглядаєте третій pull request. Жоден сеанс не бачить незавершених файлів іншого.

    Як це зробити

    1. 1Запускайте кожен сеанс командою claude --worktree <name> (або -w). Вона створює git worktree у .claude/worktrees/<name>/ у гілці worktree-<name>.
    2. 2Додайте .claude/worktrees/ до .gitignore, як радить документація.
    3. 3Дайте кожному сеансу одне завдання з власною перевіркою, щоб переглядати їх по одному.
    4. 4Переглядайте й зливайте кожну гілку як будь-який інший pull request.

    Промпт для копіювання

    Ти працюєш у worktree в гілці worktree-[назва]. Завдання: [одна зміна]. Готово, коли: [тест або команда] проходить. Роби коміти лише в цій гілці; не виконуй merge чи rebase інших гілок.

    Де все йде не так

    • Кожен worktree — окрема папка, тож залежності й результати збирання не спільні. Встановлюйте їх у кожному.
    • Два завдання, що зачіпають ті самі файли, однаково конфліктуватимуть під час злиття, з worktree чи без.

    З офіційної документації: Claude Code docs: Run parallel sessions with worktrees

  11. 11

    Скасовуйте хибний крок за допомогою rewind

    Коли сеанс іде не туди, прохання до Claude скасувати власні зміни часто додає другий безлад. Rewind відновлює розмову, код або і те, і те до моменту перед помилкою. Він не може скасувати те, що зробили shell-команди, тож перед ризикованими кроками робіть коміт.

    Приклад

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

    Як це зробити

    1. 1Двічі натисніть Esc на порожньому рядку введення або введіть /rewind (/checkpoint і /undo теж працюють).
    2. 2Виберіть момент перед тим, як усе пішло не так, і відновіть розмову, код або і те, і те.
    3. 3Знайте обмеження: файли, змінені shell-командами, як-от rm, mv чи cp, не відновлюються, як і редагування, зроблені поза Claude Code або в іншому сеансі.
    4. 4Робіть коміт перед ризикованими кроками. Контрольні точки призначені для швидкого відновлення в межах сеансу, а не для заміни git.

    Промпт для копіювання

    Перш ніж почати, зроби коміт поточного стану з повідомленням «контрольна точка перед [завдання]». Потім [завдання]. Питай мене перед будь-якою командою, що видаляє або переміщує файли.

    Де все йде не так

    • Rewind не поверне файл, який видалила команда. Це може лише git.
    • Зміни, які ви тим часом внесли вручну, теж не зберігаються. Зафіксуйте їх комітом, перш ніж робити rewind.

    З офіційної документації: Claude Code docs: Checkpointing · Claude Code docs: Commands

  12. 12

    Запускайте зі скриптів і CI

    Той самий агент працює без чату: claude -p приймає промпт, виконує роботу й завершується зі статусом, який може перевірити ваш скрипт. У CI --bare пропускає ваші локальні хуки, skills, сервери MCP і CLAUDE.md, тож запуск поводиться однаково всюди.

    Приклад

    Нічне завдання запускає claude -p із промптом «онови changelog за сьогоднішніми злитими pull request» і --output-format json та позначає збирання як невдале, коли код завершення не 0, тож про збій дізнаються наступного ранку.

    Як це зробити

    1. 1claude -p "..." працює в неінтерактивному режимі. --output-format json або stream-json дає вивід, який може розібрати скрипт.
    2. 2У разі успіху він завершується з кодом 0, у разі збою — з ненульовим, тож CI може діяти залежно від результату.
    3. 3Додавайте --bare у CI для запусків, які не мають залежати від локального налаштування.
    4. 4Для pull request команда /install-github-app налаштовує Claude Code GitHub Actions (лише для репозиторіїв на github.com); після цього згадайте @claude у коментарі до pull request або issue.

    Промпт для копіювання

    claude -p "Прочитай diff відносно main. Перелічи кожну зміну, яка додає залежність, зачіпає автентифікацію або змінює міграцію бази даних, у форматі JSON: {\"files\": [], \"reason\": \"\"}. Якщо таких немає, поверни порожній список." --output-format json

    Де все йде не так

    • Скрипт працює з тими дозволами, які ви йому даєте. Давайте CI лише необхідний мінімум.
    • /install-github-app працює лише з репозиторіями на github.com.

    З офіційної документації: Claude Code docs: Run Claude Code programmatically · Claude Code docs: GitHub Actions

  13. Codex

    13

    AGENTS.md: інструкції, з яких починається кожне завдання Codex

    Codex читає AGENTS.md перед будь-якою роботою: від вашого глобального файлу до папки, у якій працює. Запишіть команди й правила один раз, поруч із кодом, якого вони стосуються, і пріоритет матиме найближчий файл.

    Приклад

    Репозиторій із вебзастосунком і платіжним сервісом. Кореневий AGENTS.md містить спільні команди; payments/AGENTS.md додає «ніколи не змінюй округлення валют без тесту». Робота в payments/ дотримується обох, а там, де вони розходяться, пріоритет має ближчий файл.

    Як це зробити

    1. 1Запустіть /init у CLI, щоб створити початковий AGENTS.md у поточній папці.
    2. 2Особисті вказівки запишіть у ~/.codex/AGENTS.md, а правила проєкту — у репозиторій. Підпапка може мати власний файл; пріоритет мають файли, ближчі до місця, де працює Codex.
    3. 3Тримайте файли короткими: їхній сумарний розмір обмежено, за замовчуванням — 32 KiB.
    4. 4Додайте розділ «## Code Review Rules»: рев'ю Codex на GitHub дотримуються його.

    Промпт для копіювання

    Прочитай цей репозиторій і напиши AGENTS.md:
    1. Точні команди для встановлення, збирання, тестування й лінтингу.
    2. Структуру в кількох рядках.
    3. Домовленості, які новачок тут порушує.
    4. Розділ «## Code Review Rules» з тим, що рецензент завжди має позначати.
    Наводь лише команди, які ти успішно запустив; решту познач як «не перевірено».

    Де все йде не так

    • Довгі файли працюють проти вас: сумарний розмір за замовчуванням обмежено 32 KiB.
    • Файл у підпапці, який мовчки суперечить кореневому, збиває з пантелику людей так само, як Codex. Зазначайте, що саме він перевизначає.

    З офіційної документації: Codex docs: AGENTS.md · Codex docs: CLI commands · Codex docs: GitHub integration

  14. 14

    Вирішіть, скільки Codex може робити самостійно

    Режим дозволів визначає, що Codex робить, не питаючи. «Ask for approval» працює в межах робочого простору й зупиняється, перш ніж вийти за них; «Full access» прибирає пісочницю й запитання. Вибирайте для кожного завдання окремо, а не раз і назавжди.

    Приклад

    Ви читаєте незнайомий репозиторій у режимі «read-only», потім перемикаєтеся на «Ask for approval», щоб виправити один баг. Codex редагує в межах репозиторію, але зупиняється й питає, перш ніж вийти за них.

    Як це зробити

    1. 1У CLI /permissions перемикає режим, а /status показує чинну політику схвалення й папки, доступні для запису.
    2. 2«Ask for approval», рекомендований режим за замовчуванням, редагує й запускає команди в межах робочого простору та зупиняється, перш ніж вийти за них.
    3. 3«Approve for me» зберігає ту саму пісочницю, але надсилає запити на схвалення на автоматичну перевірку, а не вам.
    4. 4«Full access» знімає обмеження файлової системи й мережі. Документація додає застереження; залиште цей режим для середовищ, які не шкода викинути.

    Промпт для копіювання

    Перш ніж почати, запусти /status і скажи мені політику схвалення та папки, доступні для запису. Потім [завдання]. Питай перед будь-якою командою, якій потрібна мережа або яка записує поза цим репозиторієм.

    Де все йде не так

    • З «Approve for me» жодна людина не читає кожен запит. Використовуйте цей режим там, де хибну дію легко скасувати.
    • «Full access» діє на всю машину, а не лише на репозиторій.

    З офіційної документації: Codex docs: Permission modes · Codex docs: Sandboxing · Codex docs: Approvals and security · Codex docs: CLI commands

  15. 15

    Запускайте Codex зі скриптів і CI

    codex exec виконує завдання без чату: перебіг роботи йде в stderr, а в stdout — лише остаточне повідомлення, тож скрипт може використати відповідь. Він запускається в режимі лише для читання; давайте доступ на запис, тільки коли цього потребує завдання.

    Приклад

    Скрипт випуску запускає codex exec із промптом «напиши примітки до випуску за комітами з останнього тегу» і зберігає stdout у RELEASE.md. Режиму лише для читання досить, бо файл записує сам скрипт.

    Як це зробити

    1. 1codex exec "..." працює в неінтерактивному режимі й за замовчуванням використовує пісочницю лише для читання.
    2. 2Додайте --sandbox workspace-write, коли він має редагувати файли; --full-auto застарів.
    3. 3--json виводить потік подій у форматі JSON Lines для скриптів, яким потрібен кожен крок.
    4. 4У GitHub Actions openai/codex-action@v1 запускає codex exec за вас.

    Промпт для копіювання

    codex exec "Прочитай зміни з тегу [v1.2.0]. Напиши примітки до випуску, згруповані як «Додано», «Змінено» і «Виправлено»: один рядок на зміну, словами, зрозумілими користувачеві, без хешів комітів."

    Де все йде не так

    • Старіші посібники досі використовують --full-auto. Цей прапорець застарів; використовуйте --sandbox workspace-write.
    • Завдання, яке лише читає, має залишатися в режимі лише для читання, і в CI теж.

    З офіційної документації: Codex docs: Non-interactive mode · Codex docs: GitHub Action

  16. 16

    Отримайте рев'ю, перш ніж робити push

    Codex переглядає вашу робочу копію, гілку або pull request. На GitHub він позначає лише найсерйозніші проблеми, P0 і P1, тож його коментарі варто читати. Запускайте його перед push і дайте йому переглядати кожен pull request.

    Приклад

    Перед push міграції /review помічає, що нова колонка не має значення за замовчуванням, тож для наявних рядків виникне помилка. Хвилина перед push замість невдалого розгортання.

    Як це зробити

    1. 1/review у CLI переглядає вашу робочу копію. codex review робить те саме без чату — відносно базової гілки, коміту або незафіксованих змін.
    2. 2На GitHub залиште в pull request коментар @codex review.
    3. 3Увімкніть автоматичні рев'ю в розділі «Personal preferences» налаштувань Codex; тоді коментар не потрібен.
    4. 4Запишіть правила своєї команди в розділі «## Code Review Rules» файлу AGENTS.md.

    Вбудовано

    Промпт для копіювання

    ## Code Review Rules
    - Позначай будь-яку зміну автентифікації чи дозволів.
    - Позначай міграції бази даних без способу відкату.
    - Позначай нові залежності й кажи, чи вони потрібні.
    - Ігноруй форматування: ним займається лінтер.

    Де все йде не так

    • Рев'ю на GitHub позначають лише проблеми P0 і P1. Відсутність коментарів не означає, що архітектура правильна.
    • Рев'ю — це друга думка, а не запуск тестів. Тести залишайте.

    З офіційної документації: Codex docs: CLI commands · Codex docs: GitHub integration

  17. 17

    Передавайте завдання в Codex Cloud

    Codex Cloud працює далі, поки ваш комп'ютер спить, і кожне завдання виконує в окремому робочому просторі, створеному із середовища, яке ви налаштовуєте один раз. З належним середовищем він може встановлювати, збирати й тестувати; без нього — вгадує.

    Приклад

    Чотири невеликі рефакторинги, надіслані через codex cloud exec перед нарадою, кожен в окремому робочому просторі з того самого середовища. Для найскладнішого ви попросили три спроби й залишаєте найкращу; потім переглядаєте чотири diff.

    Як це зробити

    1. 1Створіть середовище з репозиторіями, залежностями, інструментами й налаштуваннями доступу, потрібними завданням. Нові середовища записують скрипт встановлення та навичку запуску (start skill).
    2. 2Налаштуйте доступ до інтернету для кожного середовища: лише менеджери пакетів, вибрані домени або все.
    3. 3Запускайте завдання з ChatGPT, з розширення для IDE для довших робіт або з термінала командою codex cloud exec; --attempts 1-4 просить кілька спроб для порівняння.
    4. 4Code Review та інтеграції з GitHub і Linear досі працюють на старішому Codex Cloud (Legacy), який OpenAI планує вивести з ужитку.

    Вбудовано

    Промпт для копіювання

    codex cloud exec --attempts 3 "Завдання: [зміна]. Контекст: [файли]. Готово, коли [тест] проходить у цьому середовищі. Diff має бути меншим за [кількість] рядків."

    Де все йде не так

    • Необмежений інтернет дає завданню змогу звертатися до будь-якого сайту, зокрема до сторінок, написаних для того, щоб ним керувати. Дозволяйте лише те, що потрібно для роботи.
    • Якщо скрипта встановлення немає, тести могли не запуститися. Перевірте, що завдання справді їх запустило.

    З офіційної документації: Codex docs: Cloud environments · Codex docs: CLI commands · Codex docs: IDE extension

  18. 18

    Налаштуйте Codex один раз: конфігурація, профілі й MCP

    Якщо ви щосеансу змінюєте модель і налаштування вручну, запишіть їх у config.toml. Codex щоразу читає ~/.codex/config.toml, а в довірених проєктах — і налаштування проєкту; профіль перемикає цілий набір одразу.

    Приклад

    Профіль «deep» з високим рівнем міркувань для питань архітектури і стандартний — для швидких виправлень. codex --profile deep перед питанням про архітектуру; просто codex для всього іншого.

    Як це зробити

    1. 1Задайте модель і рівень міркувань за замовчуванням у ~/.codex/config.toml (model і model_reasoning_effort). CLI і розширення для IDE користуються ним спільно.
    2. 2Створіть профіль як окремий файл, ~/.codex/<name>.config.toml, і запускайте з --profile <name>.
    3. 3Додавайте сервери MCP командою codex mcp add <name> -- <command>; кожен стає таблицею [mcp_servers.<name>], а /mcp показує активні.
    4. 4/status показує, що діє зараз, а codex resume --last відновлює останній сеанс у цій папці.

    Промпт для копіювання

    Прочитай ~/.codex/config.toml і .codex/config.toml цього проєкту. Скажи мені чинні модель, рівень міркувань, пісочницю й сервери MCP, з якого файлу походить кожне з них і що конфліктує.

    Де все йде не так

    • Налаштування проєкту завантажуються лише для довірених проєктів. Якщо якесь здається проігнорованим, спершу перевірте це.
    • Профілі тепер — окремі файли. Посібники, які розміщують [profiles.name] у config.toml, застаріли.

    З офіційної документації: Codex docs: MCP · Codex docs: Config basics · Codex docs: Advanced config · Codex docs: CLI commands

Правила: розробники

  • Ніколи не вставляйте в промпт секрети, ключі чи дані клієнтів; тримайте їх поза індексованими папками.
  • Запускайте агентів в окремій гілці з дозволами, за яких вони питають перед виконанням команд; переглядайте кожен diff.
  • Перш ніж зливати код, який написав агент, самі запустіть тести.
  • Установіть ліміт витрат для кожного ключа API, яким користується агент.

Заглибитися

Esc
↑ ↓ — переміщенняEnter — відкрити