Премини към основното съдържание
Български— Изберете език
Меню

Вашата първа задача в Codex

Урок 4 от 20 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Стартиране на първата Ви задача
  2. От Codex Cloud
  3. От IDE
  4. От CLI
  5. Анатомия на резултата от Codex
  6. Писане на добри инструкции
  7. Ключови изводи

Обновено на 3 ноември 2026 г. въз основа на справочника за команди на Codex (CLI 0.166.0): опциите --show-diff и --apply не съществуват. Локално Codex модифицира файловете директно в своята пясъчница; преглеждайте промените чрез /diff или git diff. Командата на разширението “Codex: New Task” е заменена от Codex: Open Codex Sidebar. Източници: Developer commands · Codex IDE extension.

Стартиране на първата Ви задача

Акаунтът Ви е настроен, GitHub е свързан, а AGENTS.md е налице: време е да видите агента в действие. Ето едно правило за всички нива на умения – започнете със задача, за която вече знаете правилния отговор. Няма да научите много, наблюдавайки как Codex решава проблем, който не можете да оцените, но ще научите огромно количество, гледайки как работи върху позната територия.

От Codex Cloud

В уеб интерфейса или в десктоп приложението изберете Work in › Cloud, селектирайте публикуваната среда за Вашия репозитори (Урок 2) и въведете задачата си в полето за въвеждане. Нещо умишлено скромно работи перфектно.

Task: "Add a .gitignore file suitable for a Node.js/TypeScript 
       project if one doesn't already exist."

Тази формулировка включва условие – „ако все още не съществува“ – което точно я прави интересна за наблюдение. В Codex Cloud задачата се изпълнява в средата, която сте публикували за този репозитори: Codex проверява дали .gitignore съществува, уверява се, че покрива Node.js и TypeScript, ако такъв има, създава или актуализира файла според нуждите и след това Ви показва резултата като diff. Дневникът на изпълнението се предава в реално време: тук ще видите дали агентът е спазил условието или е презаписал съществуващия Ви файл.

От IDE

Отворете проекта си във VS Code (или Cursor, Windsurf) и стартирайте Codex чрез неговата икона или палетата с команди:

Ctrl+Shift+P → "Codex: Open Codex Sidebar"

След това формулирайте заявка, която използва локалния контекст, като назовете конкретния файл:

"Add email validation to the contact form 
 in src/components/ContactForm.tsx"

Разширението показва обобщение и модифицираните редове до кода; Вие запазвате промените, които искате, и искате последващи действия в рамките на същия разговор. Документацията препоръчва създаването на Git контролна точка преди и след задачата, за да можете да се върнете назад, ако е необходимо.

От CLI

# Navigate to the project directory
cd my-project

# Start a session with an initial instruction
codex "Add a README.md with the project description, installation instructions, and available commands"

Локално Codex модифицира файловете директно във Вашата работна директория, в границите на пясъчницата и политиката за одобрение: той иска разрешение, преди да предприеме действия, които го изискват. За да прегледате какво се е променило преди commit, въведете /diff в сесията: командата показва Git diff, включително неотследваните файлове. /review кара Codex да прегледа самата Ви работна дървовидна структура. За скриптова употреба codex exec изпълнява същата задача без взаимодействие (Урок 14) – в този случай зависи от Git и Вашия pipeline да решат какво се запазва.

Анатомия на резултата от Codex

Независимо от точката на вход, завършената задача винаги връща едни и същи четири елемента. Прегледайте ги в този ред: diff казва какво се е променило, дневникът казва защо, тестовете казват дали е безопасно, а действията връщат контрола във Ваши ръце.

Доставен елементКакво съдържа
Change diffВсеки добавен, модифициран или изтрит ред, файл по файл
Execution logВсички стъпки: прочетени файлове, изпълнени команди, разсъждения на агента
Test resultsАко съществуват тестове, Codex ги изпълнява, за да провери дали нищо не е счупено
Available actionsОдобряване, модифициране, създаване на PR или повторно изпълнение с различни инструкции

Начинаещите често пренебрегват дневника на изпълнението, въпреки че той е елементът, който Ви учи как да формулирате задачите си. Като виждате кои файлове Codex е отворил, преди да вземе решение, откривате какво е търсил, но не е могъл да намери – често това е конвенция, която е трябвало да бъде в AGENTS.md.

Писане на добри инструкции

Качеството на резултата зависи пряко от качеството на инструкциите, а разликата между двете формулировки по-долу е много по-голяма от разликата между два модела.

"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling 
with the jose library. Keep the same public interface 
(signToken, verifyToken). Update the corresponding tests."

Втората версия работи, защото отговаря на четири въпроса, които агентът си задава така или иначе. Тя especificира замесените файлове, спестявайки му проучването и насочването към грешното място. Тя дефинира очаквания резултат – поведение, интерфейс, формат – така че да знае кога да спре. Тя задава ограничения, тук запазвайки публичния интерфейс, което му пречи да „подобрява“ нещата, чупейки callers; на друго място това може да бъде „не чупете тестовете“. И когато залогът го оправдава, тя добавя бизнес контекст: уточняването „това е форма за плащане, сигурността е критична“ наистина променя неговите компромиси.

За да направите това свое собствено, вземете съществуващ проект и верижно свържете три задачи от различно естество: анализ без модификация, „Избройте всички TypeScript файлове, които нямат свързани тестове“; целево генериране, „Генерирайте unit тест за този файл“; поправка с ограничен обхват, „Поправете предупрежденията на ESLint в src/utils/“. За всяка отбележете какво е трябвало да уточните от самото начало: този списък със съжаления е Вашият първи чернова на AGENTS.md.

Ключови изводи

  • Стартирайте първите си задачи с прости, целеви заявки
  • Codex предоставя пълен дневник на изпълнението за всяка задача
  • Качеството на резултата зависи от прецизността на Вашите инструкции
  • Вие винаги запазвате контрол: одобрявате, модифицирате или отхвърляте
  • Започнете със задачи с нисък риск, преди да преминете към критични промени