Codex CLI
Терминальный Agent от OpenAI

Четыре способа установки (официальная документация на 2026-10-20)

По состоянию на 2026-10-20 официальная документация OpenAI по Codex CLI называет четыре способа установки: автономный установщик для macOS и Linux, автономный установщик для Windows, который запускают в новом окне PowerShell, а также npm или Homebrew. Для обновления достаточно снова выполнить ту же команду установки, в Homebrew — brew upgrade --cask codex.

После установки откройте каталог проекта и запустите codex. При первом запуске выберите Sign in with ChatGPT или другой способ входа, затем опишите задачу одной фразой. OpenAI советует создавать контрольные точки Git до и после задачи, чтобы можно было откатить изменения.

• macOS / Linux: curl -fsSL https://chatgpt.com/codex/install.sh | sh
• Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
• npm: npm install -g @openai/codex
• Homebrew: brew install --cask codex
• WSL: по официальной документации WSL1 поддерживался до Codex 0.114; начиная с 0.115 песочница Linux перешла на bubblewrap, поэтому нужен WSL2.

Два способа входа и официальные лимиты

Официальная документация по аутентификации описывает два способа входа в Codex CLI: через ChatGPT — по подписке, или по ключу API — с оплатой по факту использования. Ключ можно передать через конвейер в codex login --with-api-key, а codex login status показывает текущий способ входа. Данные входа кешируются в ~/.codex/auth.json или в хранилище учётных данных ОС, и CLI с расширением для IDE используют общий кеш входа.

При входе через ChatGPT действуют лимиты тарифа: на странице цен OpenAI (по состоянию на 2026-10-20) число локальных сообщений для Plus и Standard Business приводится как оценка на пятичасовой период, у тарифов Pro пятичасового лимита сейчас нет, а также могут действовать недельные лимиты; остаток можно посмотреть командой /status в сессии. При входе по ключу API OpenAI Codex тарифицируется по официальной цене OpenAI (стандартные цены API), а не из включённых в план ChatGPT кредитов.

Подключение Codex CLI с ключом API QCode

Инструкция QCode для Codex использует протокол OpenAI Responses: в пользовательском файле ~/.codex/config.toml добавьте собственный model provider (имя любое), укажите его в model_provider и заполните поля ниже. После регистрации в QCode создайте в панели управления ключ API, начинающийся с cr_, — и можно начинать.

Это подключение работает только с моделями GPT: в обзоре документации QCode указано, что эндпоинт Responses, который использует Codex, не обслуживает модели Claude и китайские модели. Для моделей Claude, например claude-sonnet-5-5 или claude-opus-5-5, настройте Claude Code с тем же ключом. Оплата идёт за токены, цены по моделям — на /models.

• base_url: https://api.qcode.cc/openai (по документации QCode адрес должен быть именно таким); резервный азиатский адрес — https://asia.qcode.cc/openai.
• wire_api: responses, requires_openai_auth: true. Документация OpenAI указывает, что текущие версии Codex не поддерживают ни wire_api = chat, ни эндпоинты только с Chat Completions.
• Выберите один способ: для переменной окружения уберите requires_openai_auth и укажите env_key = "QCODE_API_KEY" (имя на ваш выбор), затем сделайте export этой переменной; для файла оставьте requires_openai_auth = true и запишите ключ в ~/.codex/auth.json с правами 600. По документации, при requires_openai_auth = true Codex игнорирует env_key.
• model: модель GPT из документации QCode, например gpt-6-sol, gpt-6.1-sol, gpt-6-astra, gpt-5.6-terra или gpt-5.6-sol; model_reasoning_effort — low, medium или high.
• Не хотите править файлы вручную — в документации QCode есть скрипт настройки одной командой: curl -fsSL https://qcode.cc/install/codex.sh | bash (в Windows — irm https://qcode.cc/install/codex.ps1 | iex). Он устанавливает CLI, записывает конфигурацию в ~/.codex и проверяет соединение.

Частые ошибки и их решение

Начните с codex doctor: по официальной документации команда формирует локальный диагностический отчёт о состоянии установки, конфигурации, аутентификации, среды выполнения, Git и терминала. Внутри сессии /status показывает текущую модель, политику подтверждений и оставшийся контекст, а /debug-config — как применяется каждый слой конфигурации.

• 401 или неверный ключ API: проверьте, что ключ начинается с cr_ и не содержит лишних пробелов или переносов строк; если используется переменная окружения, её имя должно точно совпадать с env_key в config.toml; затем проверьте статус ключа в панели QCode.
• Тайм-ауты соединения или сетевые ошибки: убедитесь, что base_url — https://api.qcode.cc/openai, проверьте связь командой curl -I https://api.qcode.cc и, если основной адрес не отвечает, попробуйте https://asia.qcode.cc/openai.
• Изменения конфигурации не действуют: по документации OpenAI файлы .codex/config.toml на уровне проекта игнорируют ключи вроде model_provider и model_providers, поэтому provider нужно задавать в пользовательском ~/.codex/config.toml.
• Ошибки profile: начиная с Codex 0.134.0 --profile больше не читает таблицы [profiles.имя] из config.toml, а селектор profile верхнего уровня не поддерживается; перенесите настройки в отдельный файл ~/.codex/имя.config.toml.
• Модель не находится: по документации OpenAI GPT-5.3-Codex-Spark выведена из эксплуатации 2026-09-14, а gpt-5.4 убрана из Codex при входе через ChatGPT 2026-08-31 (о выводе GPT-5.5 — в карточках моделей выше); замените старые названия моделей в скриптах и конфигурации.
• EACCES при глобальной установке через npm: документация QCode советует перенести глобальный каталог npm в домашний каталог пользователя; другой вариант — официальный автономный установщик, описанный выше.