Codex CLI — это coding agent от OpenAI, который запускается локально на вашем компьютере. Репозиторий — github.com/openai/codex (Apache-2.0), дока — developers.openai.com/codex. Рядом: Codex в IDE и cloud Codex Web на chatgpt.com/codex. Ниже — как пользоваться CLI новичку.
Соседи: Claude Code, Gemini CLI, Aider, Kilo Code, Augment Code. Pillar — n8n / автоматизация.
Для кого Codex CLI
Берите Codex CLI, если уже есть ChatGPT Plus/Pro (или рабочий Business/Edu/Enterprise) и нужен агент в терминале по репозиторию. Если дом — Google-аккаунт и free tier, смотрите Gemini CLI. Если нужна enterprise Context Engine/Cosmos — Augment.
| Контур | Что ставите | Деньги (мягко)* | Кому |
|---|---|---|---|
| Codex CLI | install.sh / npm @openai/codex / brew cask | через ChatGPT-план или API | Терминал, локальный репо |
| Codex IDE | расширение в VS Code / Cursor / Windsurf | тот же аккаунт OpenAI/ChatGPT | Кто живёт в редакторе |
| Codex App | codex app / лендинг App |
по плану ChatGPT | Десктопный сценарий |
| Codex Web | chatgpt.com/codex | cloud, без локальной машины | Задачи в браузере |
| Auth | Sign in with ChatGPT или API key | Plus/Pro/Business/Edu/Enterprise vs usage API | Выбор биллинга |
*По README openai/codex и developers.openai.com/codex (срез август 2026): рекомендуют Sign in with ChatGPT; состав лимитов — help.openai.com (Codex in ChatGPT). API key — отдельный setup. ₽ не выдумываем.
Как пользоваться: маршрут на 1 вечер
- Установите CLI на Mac/Linux:
curl -fsSL https://chatgpt.com/codex/install.sh | sh. Альтернативы:npm install -g @openai/codexилиbrew install --cask codex. - Запустите
codexи выберите Sign in with ChatGPT (рекомендованный путь в README). - Откройте каталог проекта и дайте одну узкую задачу с критерием готово.
- Проверяйте diff до применения широких правок; не отдавайте секреты в промпт.
- Если нужен редактор — поставьте Codex IDE по developers.openai.com/codex/ide, не путайте с Web.
- API key подключайте только если понимаете отдельный биллинг API.
# После установки
cd ~/src/my-app
codex
# Пример промпта внутри сессии
В tests/auth почини падающий тест refresh-token.
Минимальный патч. Без новых зависимостей.
Критерий готово: npm test -- auth проходит.Сильные стороны по доке OpenAI
- Локальный агент + понятный install (shell / npm / Homebrew / GitHub Releases).
- Единая экосистема: CLI, IDE, App, Codex Web.
- Вход через ChatGPT-план снижает возню с отдельным API key на старте.
- Open source CLI под Apache-2.0.
Типичные ошибки
- Путать Codex CLI с cloud Codex Web — разный runtime.
- Фиксировать «всегда бесплатно» или рублёвую цену без сверки плана ChatGPT/API.
- Ставить только IDE и ждать поведение CLI (или наоборот).
- Кормить агента .env и прод-секретами «для удобства».
- Давать задачу без критерия проверки.
FAQ: Codex CLI
Что такое Codex CLI?
Codex CLI — coding agent от OpenAI, который работает локально на вашем компьютере. Репозиторий github.com/openai/codex (Apache-2.0). Рядом есть Codex в IDE и cloud Codex Web на chatgpt.com/codex.
Сколько стоит Codex CLI?
Рекомендуемый путь: Sign in with ChatGPT в рамках Plus, Pro, Business, Edu или Enterprise (что включено — help.openai.com, статья Codex in ChatGPT). Альтернатива — API key. Рубли и «вечный $X» не фиксируем — сверяйте кабинет OpenAI/ChatGPT.
Как установить Codex CLI?
macOS/Linux: curl -fsSL https://chatgpt.com/codex/install.sh | sh. Windows: install.ps1 из той же линейки. Также npm i -g @openai/codex или brew install —cask codex. Затем команда codex.
Чем Codex CLI отличается от Codex Web?
CLI и локальный агент работают на вашей машине в репозитории. Codex Web — cloud-агент в браузере на chatgpt.com/codex. Для редактора отдельно ставят Codex IDE (VS Code/Cursor/Windsurf).
Нужен ли API key?
Не обязательно: можно войти через ChatGPT. API key — отдельный путь с доп. настройкой auth в developers.openai.com/codex/auth.
Где документация?
developers.openai.com/codex, установка в README openai/codex, help по включению в ChatGPT-план — help.openai.com.
Вывод
Codex CLI — локальный coding agent OpenAI: install.sh или npm → codex → Sign in with ChatGPT → узкая задача и diff. Web и IDE — соседние контуры той же линейки. Рядом: Gemini CLI (Google), Claude Code, Augment/Auggie.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артём Денисов — все форматы на странице обучения. Тех-pillar — n8n для начинающих.