Повърхности: Приложение за работен плот, Облак, IDE и CLI
На тази страница
Урокът е пренаписан на 3 ноември 2026 г. въз основа на страниците за Codex CLI, Разширение за Codex IDE и Codex Cloud, както и справочника с команди на Codex. Предишната версия инструктираше потребителите да инсталират несъществуващ npm пакет (
@openai/codex-cli) и цитираше флаг--interactive, който не съществува; опциите са проверени спрямо CLI версия 0.166.0. Източници: Codex CLI · Разширение за Codex IDE · Codex Cloud.
Един агент, множество повърхности
Codex не е едно единствено приложение; това е агент, достъпен чрез различни повърхности, всяка от които е адаптирана към конкретен работен контекст. Агентът остава същият; променя се мястото, където работи – Вашата локална машина или облакът, – контекстът, до който има достъп, и начинът, по който проследявате изпълнението. Изборът на правилната повърхност често има по-голямо значение за ежедневния Ви работен процес, отколкото изборът на конкретен модел.
Приложението ChatGPT за работен плот
Приложението ChatGPT за работен плот за macOS, Windows и Linux е най-изчерпателната входна точка. Влезте в системата с Вашия акаунт в ChatGPT, отворете папка или проект, след което изберете Codex от менюто на ChatGPT за разработка на софтуер. След това агентът работи върху файловете в тази папка, използвайки Вашите локални инструменти за разработка. Това е повърхността за продължителни сесии и локални проекти. Тук също така стартирате работа, базирана на облака, точно както можете да направите от уеб интерфейса.
Codex Cloud
За задачи, които трябва да се изпълняват отдалечено, Codex Cloud изпълнява работа в среда, която настройвате веднъж. В уеб браузъра или в приложението за работен плот изберете Работа в › Облак, след това Изберете среда и Създайте среда. Изберете Вашите GitHub хранилища; Codex инспектира проекта, инсталира зависимости и инструменти, тества работния процес и Ви подканва за всички липсващи разрешения за достъп. След като средата бъде публикувана, всяка задача получава свое собствено работно пространство и продължава да се изпълнява, дори когато компютърът Ви заспи. Преглеждате модифицираните файлове и резултатите от тестовете, искате корекции, след което правите commit или отваряте pull request – от уеб, мобилно устройство или приложението за работен плот.
Това е повърхността за дълготрайни задачи, които стартирате преди среща: миграция на框架 (framework), обширно рефакториране или множество паралелни задачи в една и съща среда.
Разширението за IDE
Разширението Codex се инсталира във Visual Studio Code и съвместими редактори като Cursor, Windsurf и VS Code Insiders. Xcode и IDE средите на JetBrains предлагат свои собствени нативни интеграции с Codex. След свързване, отворете Codex чрез неговата икона (или във VS Code и производните му, чрез палетата с команди: Codex: Open Codex Sidebar; в JetBrains, отворете AI Chat и изберете Codex).
Неговото предимство е непосредственият контекст: отворените файлове, текущите селекции и последните разговори се подават директно във Вашата подкана (prompt), а промените се появяват рамо до рамо с Вашия код. Това е повърхността за ежедневни задачи – генериране на тестове за текущата функция, обясняване на наследен блок код или поправяне на грешка, която току-що е показала интегрираната терминална конзола. Когато една задача стане твърде голяма, можете да я делегирате на облака от редактора и да се върнете към резултатите по-късно. Документацията препоръчва създаването на Git контролни точки преди и след задача, за да можете да се върнете назад, ако е необходимо.
CLI (Команден ред)
CLI е насочен към разработчици, които живеят в терминала. Документацията предлага четири метода за инсталиране:
# macOS и Linux: самостоятелен инсталатор
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm
npm install -g @openai/codex
# Homebrew
brew install --cask codex
В Windows стартирайте самостоятелния инсталатор от PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex".
Изпълнението на codex без аргументи в папка с проект отваря интерактивния терминален интерфейс. При първо стартиране ще Ви бъде предложено да влезете с Вашия акаунт в ChatGPT или по друг метод.
# Отваряне на интерактивна сесия
codex
# Отваряне на сесия с начална подкана
codex "Add email validation to the signup form"
# Избор на модел
codex --model gpt-6.1-sol "Refactor the payment module"
Истинската му стойност личи, когато преминете отвъд ръчната употреба. codex exec (псевдоним codex e) изпълнява задача без взаимодействие, което я прави идеална за скриптове и конвейери (pipelines). Когато stdin се пренасочи и също така се предостави подкана, codex exec добавя полученото съдържание към подканата вътре в блок <stdin>. Това Ви позволява да свързвате команди, които произвеждат списъци с файлове.
# Намиране на файлове без тестове и искане от Codex да ги генерира
find src/ -name "*.ts" -not -name "*.test.ts" | codex exec "Generate missing tests for these files"
Коя повърхност да изберете?
| Ситуация | Препоръчителна повърхност | Защо |
|---|---|---|
| Миграция на framework | Codex Cloud | Дълготрайна задача, подготвена среда, паралелна работа |
| Рефакториране на отворен файл | Разширение за IDE | Непосредствен локален контекст, преглед рамо до рамо |
| Локален проект, дълга сесия | Приложение за работен плот | Отворена папка, инструменти за разработка |
| Скрипт за автоматизация | CLI (codex exec) | Интеграция в конвейер |
| Бързо генериране на тестове | Разширение за IDE | Резултатите се появяват в редактора |
На практика повечето разработчици комбинират тези повърхности в рамките на една седмица. Сесиите за вход са споделени: CLI и разширението използват едни и същи кеширани удостоверителни данни. И всички повърхности четат един и същи файл AGENTS.md, файла с инструкции, разгледан в следващия урок.
Ключови изводи
- Codex е достъпен чрез приложението ChatGPT за работен плот, Codex Cloud, разширението за IDE и CLI
- Приложението за работен плот и разширението работят локално; Codex Cloud изпълнява задачи в публикувани среди
- Разширението се инсталира във VS Code и производните му; Xcode и JetBrains имат свои собствени интеграции
- Инсталирайте CLI чрез самостоятелния инсталатор,
npm install -g @openai/codexили Homebrew; използвайтеcodex execза автоматизация - Всички повърхности четат един и същи файл
AGENTS.md