Руководство по установке Codex 2026: полный гайд GPT-5.5-Codex

В 2026 OpenAI переопределил Codex: это уже не «историческая модель автодополнения», а полноценная платформа Agent для программирования. Codex CLI работает в локальном терминале, читает репозиторий, меняет файлы и запускает команды; GPT-5.5-Codex — специализированный вариант модели для инженерии ПО. Это опорная страница установки и использования на русском сайте: три способа установки, вход через ChatGPT, config.toml, sandbox одобрений, переключение /model и первая проверяемая задача. Связь с Claude Code и Cursor — в структурированном сравнении ниже.

1. Зачем в 2026 отдельно ставить Codex CLI?

ChatGPT в браузере пишет код, но реальная боль команд в другом: советы в окне чата не превращаются в проверяемый git diff; тестовые циклы не крутятся стабильно; CI остаётся снаружи. Codex CLI решает границу исполнения — помещает серию GPT-5.5 в выбранную директорию и меняет файлы, запускает shell под sandbox и политикой одобрения.

В отличие от «Codex API» автодополнения 2021 года, Codex 2026 — это open-source terminal Agent на Rust (репозиторий openai/codex), связанный с подпиской ChatGPT, с расширениями IDE, desktop-приложением и асинхронными задачами Codex Cloud. Настоящий разлом — не «кто сильнее, OpenAI или Anthropic», а готовы ли вы делегировать задачи terminal Agent.

2. Как классифицировать четыре входа Codex?

Гайд фокусируется на Codex CLI, но платформа имеет четыре грани с общим каталогом ~/.codex/:

Основной путь здесь — сначала CLI: после установки CLI расширения IDE и App обычно используют тот же аккаунт и конфиг.

3. Сравнение: Codex vs Claude Code vs Cursor

О ценах простым языком: у всех троих старт около $20/мес, но покупаете не одно и то же —

• Codex и Claude Code — как мобильный тариф с трафиком: квота обновляется каждые несколько часов; если AI меняет много файлов за раз, лимит уходит быстро.
• Cursor — как абонемент в зал: фиксированные $20/мес, выгодно при ежедневной работе в IDE; счёт проще всего прогнозировать.

Зелёная колонка в таблице ниже отвечает на «как списывают деньги и удивит ли счёт в конце месяца» — часто решающий критерий. Слева — возможности; зелёное — бюджет.

Детальное IDE-сравнение: Claude Code vs Cursor 2026; контекст Anthropic vs OpenAI Agent: эра Claude Code.

4. Выбор по сценарию

5. Рекомендуемые связки (стек 2026)

• Solo-разработчик — Codex CLI (GPT-5.5-Codex) + привычный IDE для мелких правок; крупные задачи по выходным через codex.
• Full-stack + iOS — Codex/Cursor локально; сборка Xcode и подпись на Cloud Mac или узле GitHub Runner.
• Командный CI — codex exec или Codex Cloud даёт patch → Actions собирает и тестирует → человек review PR. Runner с один job — один workspace.
• Knowledge-intensive репо — MCP для issues + опциональный CodeGraph; правила в .codex/config.toml и AGENTS.md.

6. Подготовка к установке

• Аккаунт — ChatGPT Plus / Pro / Business / Edu / Enterprise (Codex включён) или рабочий OpenAI API Key.
• ОС — macOS и Linux в приоритете; Windows через нативный PowerShell или WSL2.
• Git-репозиторий — проверяйте на реальном проекте, не в пустой папке.
• Node.js 18+ — только для npm install -g @openai/codex.

uname -a
git --version
node -v   # если через npm
which codex # должно быть пусто (ещё не установлен)

7. Три способа установки (официальные пути 2026)

# Неинтерактивно (CI-образ): сначала
export CODEX_NON_INTERACTIVE=1

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

npm install -g @openai/codex@latest
codex --version
# EACCES: npm config set prefix ~/.npm-global, добавить ~/.npm-global/bin в PATH

8. Вход и аутентификация

При первом запуске codex интерактивный TUI предлагает:

• Sign in with ChatGPT (рекомендуется) — OAuth в браузере, квота в рамках плана ChatGPT.
• API Key — для автоматизации и оплаты по токенам; не коммитьте ключ в git.

Конфиг и учётные данные в ~/.codex/. На общей машине ограничьте права файлов; в CI внедряйте ключ через secret manager.

9. GPT-5.5-Codex: модель и config.toml

GPT-5.5 — универсальный flagship; GPT-5.5-Codex оптимизирован под код (чтение репо, патчи, рассуждение об инструментах). Для ежедневной инженерии держите Codex; общие вопросы — gpt-5.5.

В сессии: введите /model, выберите gpt-5.5-codex и уровень reasoning.

Постоянный default: отредактируйте ~/.codex/config.toml (или .codex/config.toml на уровне проекта, если доверяете репо):

# Модель программирования по умолчанию
model = "gpt-5.5-codex"

# Одобрение: on-request = спрашивать при выходе из sandbox
approval_policy = "on-request"

# Sandbox: read-only сначала, потом workspace-write
sandbox_mode = "read-only"

# Усилие рассуждения (под задачу)
model_reasoning_effort = "medium"

Приоритет (последний побеждает): встроенные default → ~/.codex/config.toml → проектный .codex/config.toml → профиль (codex --profile ci) → аргументы CLI. См. Config basics.

10. Ежедневное использование: TUI, одобрения, MCP и скрипты

Интерактивный режим

cd your-repo
codex
# или однострочная задача
codex "запусти npm test и исправь падения, не трогай package-lock"

Режимы одобрения (красная линия безопасности)

Для rm, prod-конфига или секретов — одобряйте вручную. Enterprise может запретить never или sandbox danger-full-access через requirements.toml.

Расширение MCP

Codex поддерживает Model Context Protocol: объявите MCP-сервер в config.toml для GitHub, БД и т.д. Та же логика, что у Claude Code MCP — см. наш гайд MCP про PAT с минимальными правами.

Скриптовый exec и Cloud

• codex exec "..." — headless, cron / pre-flight CI.
• Subagents — параллельное дробление крупных задач (в TUI).
• Локальный Code Review — отдельный Agent на diff перед commit.
• Codex Cloud — cloud-задача из терминала, patch забираете локально.

11. Типичные ошибки

1. Codex как ChatGPT в браузере — без CLI и review diff нет инженерного цикла.
2. sandbox_mode = danger-full-access сразу — меньше кликов, необратимые удаления; начинайте с read-only.
3. Запуск codex в подпапке — Agent видит только cwd; в monorepo стартуйте из корня пакета.
4. Игнорировать пути Windows — нативный PowerShell и WSL — разные filesystem; выберите один путь.
5. Сравнивать модели без точки входа — GPT-5.5-Codex силён, но при жизни в Tab-дополнении Cursor + расширение Codex лучше чистого TUI.

12. Чек-лист из 7 шагов

1. Установить CLI — install.sh или npm i -g @openai/codex, проверить codex --version.
2. Войти — OAuth ChatGPT или API Key, убедиться что ~/.codex/ создан.
3. Написать config.toml — model = "gpt-5.5-codex", approval_policy = "on-request", sandbox_mode = "read-only".
4. Выбрать репо — знакомый средний проект, чистый git status или feature-ветка.
5. Smoke-задача — codex "объясни структуру src и нарисуй дерево", проверить чтение файлов.
6. Полный цикл — codex "запусти [ваша test cmd] и исправь падения", убедиться что shell реально выполняется.
7. Подключить командный стек — 24/7 builds на Cloud Mac; граф через MCP при необходимости.

13. FAQ

Codex, Claude Code или Cursor — что дешевле?

Все стартуют примерно с $20/мес, абсолютного «дешевле всех» нет. Уже на ChatGPT → Codex включён; Claude Pro → Claude Code аналогично. Фиксированный бюджет с нуля → Cursor предсказуемее. Интенсив с массовыми правками → tier $100–200 у обоих; см. таблицу.

Codex платится отдельно?

Обычно нет. ChatGPT Plus ($20/мес) включает Codex. Можно API Key по потреблению, но без части member-функций (например cloud review). Подробности: документация OpenAI.

Разница GPT-5.5 и GPT-5.5-Codex?

GPT-5.5 универсален; GPT-5.5-Codex заточен под чтение кода, патчи и tool chain. Для кодинга по умолчанию — Codex.

Codex и Claude Code вместе?

Да. Разные каталоги конфига (~/.codex/ vs ~/.claude.json); один репо — разные сценарии. Согласуйте стиль кода, чтобы два Agent не переписывали форматирование.

command not found после установки?

Перезапустите shell или добавьте бинарник в PATH. Homebrew: /opt/homebrew/bin; npm: ~/.npm-global/bin.

Как обновить Codex?

npm install -g @openai/codex@latest или повторите install-скрипт; Homebrew: brew upgrade codex.

14. Итог

Гайд по установке Codex 2026 — это подключение OpenAI coding Agent к вашей файловой системе и терминалу. Три команды для CLI, вход ChatGPT, gpt-5.5-codex по умолчанию в config.toml, одобрение on-request для безопасности — и у вас воспроизводимый, скриптуемый, Cloud-ready workflow. Codex конкурирует с Claude Code за terminal entry; с Cursor — за «кто ведёт написание». Большинство команд в итоге держат двойной или тройной стек, а не одну ставку.

Для реальных macOS-сборок: Agent ускоряет написание, Xcode и Runner остаются на настоящем Apple Silicon. Cloud Mac сочетает локальный Codex для diff и удалённую компиляцию — разделить «писать» и «проверять» ускоряет путь в прод.