Установка и авторизация (Mac / Windows / Linux)

📚 Навигация по серии: Предыдущая статья 02 · Краткий обзор ключевых концепций объяснила ключевые термины Codex (агент, песочница, подтверждение прав, локальный/облачный режимы). В этой статье мы перейдем к установке инструмента на ваш компьютер — мы рассмотрим как настольное приложение, так и CLI, разберем авторизацию, различия между тремя ОС и частые проблемы при установке. В следующей статье 04 · Тарифы и биллинг мы поговорим о финансовой стороне вопроса.

В начале 2026 года OpenAI разделила Codex на четыре интерфейса взаимодействия: веб-версию, настольное приложение, командную строку (CLI) и расширения для IDE. Пройдя путь от консоли до настольного клиента, я пришел к выводу: официальные инструкции по установке часто не совпадают со старыми руководствами из интернета.

Сам по себе процесс установки не представляет сложности. Главная проблема — отсутствие четкого понимания, какой путь является официальным и актуальным, а какой ведет к устаревшим багам. В этой главе мы наметим правильные пути для каждой ОС и типа установки, чтобы вы сэкономили свое время.

После прочтения этой статьи вы получите:

• Пошаговое руководство по установке настольного приложения и CLI на macOS, Windows и Linux с критериями проверки успешности операции
• Сравнение трех способов установки CLI (официальный скрипт, Homebrew, npm) для выбора оптимального пути
• Различия между двумя способами авторизации (аккаунт ChatGPT и API-ключ), а также обход блокировок при удаленной авторизации
• Таблицу типичных ошибок при установке с инструкциями по их устранению

---

01 Три вещи, которые нужно прояснить перед установкой

Не спешите выполнять команды. Многие сталкиваются с проблемами в процессе из-за того, что не проверили базовые системные требования или особенности тарифов. Убедитесь в следующих трех моментах:

1. Выберите подходящий интерфейс

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

• Настольное приложение: удобный графический интерфейс для тех, кто не любит работать в консоли. Доступно только для macOS и Windows (для Linux настольная версия пока отсутствует).
• CLI (командная строка): консольный агент разработки, поддерживающий все три операционные системы и являющийся основным рабочим инструментом.

Рекомендация: разработчикам рекомендуется сразу использовать CLI как наиболее универсальный кроссплатформенный вариант. В этой статье мы сделаем акцент на установку CLI, выделив под настольное приложение отдельный небольшой подраздел. Вы можете использовать оба варианта одновременно — авторизационные токены синхронизируются между CLI и расширениями IDE (настольный клиент авторизуется отдельно, подробнее в Разделе 06).

2. Подготовьте учетную запись

Важный нюанс: доступ к Codex привязан к подписке ChatGPT.

Согласно документации, тарифные планы ChatGPT Plus, Pro, Business, Edu и Enterprise включают лимиты на использование Codex. Также возможна авторизация через OpenAI API-ключ с оплатой по факту использования (pay-as-you-go). Однако в этом случае некоторые облачные функции, завязанные на инфраструктуру ChatGPT, будут недоступны.

Использование API-ключа для локальной работы в CLI допускается: списание средств будет производиться со баланса вашего аккаунта OpenAI по стандартным тарифам API, не затрагивая подписки ChatGPT.

Подробности тарификации описаны в Статье 04. В рамках этой главы мы предполагаем, что вы уже имеете активную подписку ChatGPT или рабочий API-ключ.

3. Настройте сетевое соединение

Codex требует постоянного интернет-соединения с серверами OpenAI. Для доступа к доменам chatgpt.com и platform.openai.com может потребоваться стабильный VPN. Проблемы с сетевым подключением — одна из главных причин зависаний на этапах скачивания пакетов и OAuth-авторизации.

💡 Краткий вывод: Перед началом работы: выберите CLI как основной кроссплатформенный вариант, подготовьте подписку ChatGPT или API-ключ и обеспечьте стабильный доступ к доменам OpenAI через VPN.

---

02 Вариант 1: Настольное приложение (macOS / Windows)

Настольное приложение — наиболее простой путь для пользователей, избегающих работы в терминале.

Аналогия: настольный клиент — это ChatGPT с доступом к вашему проекту. Визуально интерфейс напоминает обычный веб-чат, но приложение поддерживает синхронизацию с выбранным локальным каталогом на вашем компьютере. Оно способно читать файлы, применять правки и выполнять команды, совмещая диалоговое окно, рабочую директорию проекта и механизмы локальной памяти.

Примеры использования:

• Вы работаете менеджером или дизайнером и хотите, чтобы AI внес мелкие правки в интерфейс или проанализировал логику работы модуля в кодовой базе.
• Требуется параллельная работа над несколькими проектами: пока в одном каталоге запускаются тесты, вы продолжаете обсуждать требования во втором.
• Вам необходима визуальная панель сравнения (diff-viewer) для контроля изменений перед их сохранением.

下载与安装

打开 https://chatgpt.com/codex ，下载对应平台的安装包：

Платформа	Рекомендации по выбору
macOS (процессоры Apple M-серии)	Скачивайте стандартный установщик
macOS (процессоры Intel)	Выбирайте сборку Intel build
Windows	Скачивайте инсталлятор для Windows
Linux	Настольная версия отсутствует, используйте CLI

Если вы сомневаетесь в типе процессора на Mac: откройте меню Apple (логотип в левом верхнем углу) → «Об этом Mac». Если в строке «Чип» указано Apple M1/M2/M3, выбирайте версию для Apple Silicon. Если указан Intel, скачивайте Intel build. Несовпадение архитектур приведет к невозможности запуска.

首次登录与选项目

装好打开 App，按三步走：

1. Авторизация: войдите с помощью аккаунта ChatGPT или API-ключа (ограничения при входе по API-ключу описаны ниже).
2. Выбор каталога: укажите рабочую папку проекта. Приложение покажет список недавних директорий, если вы ранее запускали CLI.
3. Первый запрос: выберите рабочий каталог, убедитесь, что в левом нижнем углу активен переключатель Local (это указывает на локальную работу, а не в облаке), и отправьте первую команду в чат.

На старте сосредоточьтесь на базовых элементах: диалоговом окне и привязке к проекту. Общение строится стандартным образом, а изменения будут применяться строго внутри выбранного каталога.

После установки вы можете сменить язык интерфейса в меню «Settings → General → Language». Боковые и нижние панели сворачиваются с помощью иконок в правом верхнем углу. Общий вид интерфейса:

💡 Краткий вывод: Настольный клиент доступен для macOS и Windows. Пользователям Mac важно не перепутать архитектуру процессора (Intel / Apple Silicon). Настройка сводится к авторизации, привязке папки и выбору локального режима (Local).

---

03 Вариант 2: CLI-клиент (для всех ОС)

Рекомендуемый вариант: для всех систем используйте официальный скрипт установки (standalone installer). Он скачивает готовый бинарный файл, не требующий среды Node.js.

Аналогия: официальный скрипт — это автономный установщик. Он скачивает бинарный файл и размещает его в системных путях, не затрагивая остальные компоненты. Установка через npm требует развернутой среды Node.js, добавляя лишний уровень системных зависимостей.

macOS / Linux

打开终端，粘这一行：

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

Настройте VPN-подключение перед запуском команды, чтобы избежать зависаний при скачивании бинарных пакетов.

Для автоматизации установки в среде CI/CD (без интерактивных запросов) используйте флаг среды:

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh

Windows (без использования WSL)

在 PowerShell 里跑（提示符长这样 PS C:\>）：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Версия для автоматической установки:

$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex

Параметр -ExecutionPolicy ByPass временно отключает политику безопасности выполнения скриптов для текущего процесса; irm (Invoke-RestMethod) скачивает скрипт, а iex (Invoke-Expression) выполняет его. Ошибка irm is not recognized указывает на то, что команда запущена в устаревшем интерпретаторе CMD — откройте окно PowerShell.

还有别的路：Homebrew / npm

官方脚本之外还有条备选道，列个对比按需挑：

Способ установки	Вызываемая команда	Зависимости	Рекомендация
Официальный скрипт	curl ... | sh (или irm в Windows)	Отсутствуют	Рекомендуется; чистая установка бинарного файла
Homebrew (macOS)	brew install --cask codex	Менеджер Homebrew	Для пользователей, активно использующих brew; обновления могут приходить с небольшой задержкой
npm	npm install -g @openai/codex	Node.js	Для веб-разработчиков, привыкших устанавливать утилиты через npm

Версия в репозитории Homebrew обновляется с задержкой в 1–2 дня из-за процесса модерации, но проходит дополнительное тестирование.

Установка через Homebrew (macOS):

brew install --cask codex

Установка через npm (требуется Node.js):

npm install -g @openai/codex

Типичные проблемы при установке альтернативными методами:

• Использование sudo при установке через npm. Старые инструкции рекомендуют использовать sudo npm install -g. Это может привести к конфликту прав доступа в вашей системе. Используйте менеджеры версий вроде nvm или Volta для установки Node.js в пользовательский каталог без использования root-прав. При ошибках доступа лучше переключиться на официальный скрипт, не требующий npm.
• При установке через Homebrew убедитесь, что указали флаг --cask и точное имя пакета — codex.

💡 Краткий вывод: Для CLI выбирайте официальный скрипт: curl ... | sh для Mac/Linux и irm для Windows. Это избавит от привязки к Node.js. Использование npm допускается в изолированных пользовательских средах без sudo.

Сравнение двух направлений установки:

Схема наглядно представляет оба сценария: левая ветка ведет через загрузку инсталлятора и графический интерфейс, правая — через установку бинарного файла и вызов codex login в терминале. Оба пути завершаются авторизацией через подписку ChatGPT или API-ключ.

---

04 Особенности Windows: Среда выполнения

Инсталляция на Windows имеет свои специфические особенности:

Поддерживаются три сценария запуска:

• Стандартная среда Windows + elevated песочница: Рекомендуется. Использует выделенного пользователя с минимальными правами, изоляцию на уровне файловой системы и правила брандмауэра для защиты системы.
• Стандартная среда Windows + unelevated песочница: Запасной вариант. Используется при ограничениях на применение административных прав (например, на корпоративных ПК). Уровень защиты ниже, но базовый контур сохраняется.
• Среда WSL2 (подсистема Linux в Windows): Работа в окружении Linux с использованием нативных механизмов изоляции. Подходит при необходимости запуска Linux-утилит сборки или расположении репозитория в WSL2.

Сводная таблица выбора окружения в Windows:

Сценарий запуска	Требования	Применение
Нативная среда + elevated	Права администратора для настройки прав песочницы	По умолчанию; максимальная безопасность и скорость работы
Нативная среда + unelevated	Обычные права пользователя	Обход корпоративных ограничений безопасности
Интеграция с WSL2	Наличие развернутой подсистемы WSL2	Использование Linux-библиотек или размещение файлов в WSL2

Системные требования и примечания:

• Версия ОС: Рекомендуется Windows 11. Поддержка Windows 10 ограничена версиями 1809 и выше (из-за необходимости поддержки ConPTY). Установка на устаревшие сборки Win10 не рекомендуется.
• Поддержка winget: убедитесь, что в системе установлен и работает стандартный пакетный менеджер Windows.
• Отказ от поддержки WSL1: начиная с версии Codex 0.115, механизмы изоляции переведены на использование утилиты bubblewrap, что привело к прекращению поддержки устаревшей подсистемы WSL1 (начиная с релиза 0.114). Требуется переход на WSL2.

Для настройки WSL2 запустите PowerShell с правами администратора, установите подсистему и перейдите в терминал Linux:

wsl --install
wsl

Внутри терминала WSL выполните стандартную установку для Linux:

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

Совет по оптимизации производительности в WSL: избегайте размещения проектов на смонтированных дисках Windows (пути вроде /mnt/c/...). Это замедляет файловые операции ввода-вывода и вызывает ошибки с символическими ссылками. Размещайте репозитории в домашнем каталоге Linux (например, ~/code/my-app). Доступ к файлам из проводника Windows можно получить по адресу \\wsl$.

Алгоритм выбора окружения в Windows:

Схема показывает: приоритетным является нативный запуск с правами elevated; при корпоративных ограничениях переключайтесь на unelevated; при необходимости работы с окружением Linux используйте WSL2.

💡 Краткий вывод: На Windows отдавайте предпочтение нативной установке с elevated песочницей (запасной путь при ограничениях — unelevated). При необходимости Linux-окружения используйте WSL2 (поддержка WSL1 прекращена). Наиболее стабильная работа обеспечивается на Windows 11.

---

05 Проверка корректности установки

После установки CLI откройте новое окно терминала и выполните команду:

codex --version

Ожидаемый вывод (номер версии может отличаться):

codex-cli 0.139.0

Вывод версии подтверждает успешность установки. Ошибка command not found: codex (или 'codex' is not recognized на Windows) указывает на проблемы с добавлением пути в переменную среды PATH. Способ решения описан в Разделе 08.

Актуальные параметры обновления и справочные команды всегда проверяйте через codex --help, так как интерфейс CLI находится в постоянной доработке.

Версию настольного приложения можно посмотреть в основном меню программы. Различия в версиях приложения и CLI могут приводить к расхождениям в поведении агента.

💡 Краткий вывод: Базовый тест — успешный вызов codex --version. Все команды обновления и справки сверяйте непосредственно в codex --help, избегая использования устаревших сторонних инструкций.

---

06 Авторизация учетной записи

Без привязки учетной записи агент не сможет выполнять задачи. Перейдите в рабочий каталог вашего проекта и введите команду:

codex

При отсутствии активного токена авторизации запустится мастер входа через аккаунт ChatGPT, который откроет браузер для подтверждения прав. После прохождения OAuth-авторизации веб-страница передаст access token обратно в консоль.

Выбор метода авторизации

Метод входа	Процесс	Целевая аудитория	Примечание
Учетная запись ChatGPT (рекомендуется)	Выбор пункта Sign in with ChatGPT, OAuth-авторизация в браузере	Большинство пользователей, работа с облаком	Использование лимитов вашей подписки ChatGPT
API-ключ (OpenAI API key)	Ввод ключа, сгенерированного в панели управления OpenAI	Автоматизация в CI/CD, серверные скрипты	Оплата по факту использования; облачные функции работы с ChatGPT будут недоступны

Для повседневной работы предпочтителен вход через аккаунт ChatGPT — лимитов подписки хватает для разработки, и сохраняется доступ к облачным агентам. API-ключ используется для автоматизации процессов в CI/CD, так как исключает необходимость интерактивного подтверждения в браузере. Храните ваши API-ключи в безопасности.

Хранение токенов авторизации

Успешно полученный токен кэшируется в системе для повторного использования. Учитывайте два аспекта:

• CLI и плагины IDE используют общий кэш авторизации — выход из учетной записи на одном уровне сбросит сессию на другом.
• Токен сохраняется в локальном файле ~/.codex/auth.json или в системном хранилище паролей (Keychain на macOS). Способ хранения задается параметром cli_auth_credentials_store (file, keyring или auto, подробнее в Статье 18).

⚠️ Важно: файл ~/.codex/auth.json содержит секретный access token. Относитесь к нему как к паролю: не фиксируйте его в Git, не пересылайте в чатах и логах поддержки.

При авторизации через ChatGPT токен обновляется автоматически в фоновом режиме, поэтому повторный вход требуется редко.

Авторизация на удаленных серверах и headless-окружении

В headless-окружении (серверы без графической оболочки, удаленные контейнеры или заблокированные сетевые порты localhost) подтверждение в браузере не сработает. В таких случаях используйте авторизацию по коду устройства (Device Code Login).

Запустите команду в консоли для авторизации по коду устройства:

codex login --device-auth

Утилита выведет ссылку и одноразовый буквенно-цифровой код. Откройте ссылку на любом устройстве с браузером (например, на смартфоне или основном ПК) и введите код для завершения входа на сервере.

Этот метод входа должен быть предварительно разрешен в настройках безопасности вашей учетной записи. При его недоступности используйте один из двух обходных путей:

1. Перенос файла авторизации: выполните вход на локальном ПК с браузером, найдите сгенерированный файл ~/.codex/auth.json и перенесите его на сервер по SSH:

ssh user@remote 'mkdir -p ~/.codex'
scp ~/.codex/auth.json user@remote:~/.codex/auth.json

2. Перенаправление портов по SSH: пробросьте порт авторизации (по умолчанию 1455) с удаленного сервера на локальный ПК:

ssh -L 1455:localhost:1455 user@remote

Запустите команду codex login в текущей сессии SSH — процесс перенаправит веб-запрос на ваш локальный браузер.

💡 Краткий вывод: Основной метод входа — через аккаунт ChatGPT с локальным кэшированием в файл auth.json. Для удаленной работы используйте команду codex login --device-auth, перенос конфигурационных файлов или туннелирование порта 1455 по SSH.

---

07 Практика: Проверка первого запуска

Проверим работоспособность агента на чистом каталоге.

Шаг 1: Создайте папку и инициализируйте сессию:

mkdir codex-test && cd codex-test
codex

При первом запуске пройдите авторизацию. Вы увидите приветственное меню CLI.

Шаг 2: Отправьте простой текстовый запрос:

在 test.py 里写一个打印 hello world 的函数

Ожидаемое поведение: Агент спланирует задачу и приостановит работу для подтверждения прав на запись. Выберите вариант Yes в появившемся меню, чтобы подтвердить сохранение изменений. Codex не меняет файлы вашей системы скрытно.

После подтверждения в папке появится файл test.py. Для выхода нажмите Ctrl + C или введите /exit.

Шаг 3: Используйте коммиты Git для фиксации изменений (рекомендуемая практика). Создавайте коммиты перед запуском сложных автоматических правок, чтобы иметь точку отката:

git init
git add -A && git commit -m "codex 动手前的检查点"

Вы настроили и проверили полную цепочку работы с агентом. Механизм обязательного подтверждения изменений гарантирует предсказуемость поведения Codex и сохранность данных проекта.

Схема выполнения первого тестового цикла:

Ключевым этапом схемы является развилка подтверждения (Approval): запись изменений происходит только после вашего согласия. При отклонении предложения агент вернется к планированию.

💡 Краткий вывод: Для теста: запустите codex в пустом каталоге, авторизуйтесь, отправьте текстовый запрос и подтвердите изменения (Yes). Рекомендуется использовать Git для фиксации состояния проекта перед запуском сложных автоматических правок.

---

08 Решение типичных проблем при установке

При возникновении ошибок сверяйтесь со следующей таблицей:

Ошибка / Симптом	Возможная причина	Способ решения
command not found: codex	Путь установки не добавлен в переменную PATH	Добавьте каталог установки в PATH (см. ниже)
'codex' is not recognized (Windows)	Проблема с путями PATH или терминал не перезапущен	Проверьте PATH и перезапустите консоль
irm is not recognized	Запуск команды PowerShell в интерпретаторе CMD	Перейдите в окно PowerShell и повторите ввод
Зависание браузера на этапе OAuth-авторизации	Сбои сетевого подключения или headless-окружение	Используйте команду codex login --device-auth
Зависание скрипта скачивания установщика	Блокировка серверов OpenAI со стороны провайдера	Настройте VPN-подключение или используйте Homebrew
Недоступность облачных функций при авторизации по API-ключу	Ограничения со стороны API для облачных агентов	Используйте вход через аккаунт ChatGPT
Ошибка Windows 1385 при работе песочницы	Локальные политики безопасности запрещают вход Sandbox-пользователям	Обратитесь к системному администратору или используйте unelevated песочницу
Codex вызывается даже после удаления	Конфликт нескольких установленных версий в системе	Найдите лишние файлы с помощью which -a codex и удалите их

Разберем подробнее два наиболее частых случая.

1. Ошибка command not found: codex

Если при вызове codex консоль сообщает, что команда не найдена, это означает, что бинарный файл успешно скачан, но путь к его каталогу не прописан в переменной окружения PATH.

Аналогия: переменная PATH — это реестр почтовых адресов системы. Программа может быть установлена на диск, но если ее адрес отсутствует в системном реестре, консоль не сможет выполнить вызов.

Решение для macOS (интерпретатор Zsh) — добавление каталога ~/.local/bin в профиль конфигурации:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

По умолчанию установщик размещает бинарный файл в каталоге ~/.local/bin (сверяйте с логами установки). В Linux (интерпретатор Bash) пропишите пути в файле ~/.bashrc. В Windows добавьте путь в свойствах переменных среды пользователя и перезапустите консоль.

Тест проверки путей:

codex --version

Успешный вывод версии подтверждает решение проблемы.

2. Конфликт нескольких установленных версий

При одновременной установке через npm и официальный скрипт в системе могут присутствовать несколько исполняемых файлов Codex, что приводит к непредсказуемому поведению. Проверьте все зарегистрированные пути:

which -a codex

Если вывод содержит несколько строк, удалите устаревшие копии. Например, очистите глобальные пакеты npm:

npm uninstall -g @openai/codex

Конфликт версий часто возникает из-за приоритета путей в PATH. Проверка через which -a codex позволяет локализовать расположение конфликтующих бинарных файлов для их ручной очистки.

💡 Краткий вывод: При ошибках сверяйтесь с таблицей симптомов. Ошибка поиска команды чаще всего связана с переменной PATH, а дублирование и некорректная работа версий устраняются проверкой путей через команду which -a codex.

---

09 Резюме

Итоги главы по установке и авторизации:

• Подготовка: выберите CLI для кроссплатформенности, настройте VPN и подготовьте подписку ChatGPT или API-ключ.
• Способы установки: настольное приложение доступно на macOS и Windows; для CLI используйте официальный скрипт (curl ... | sh или irm).
• Среда Windows: приоритет отдается elevated песочнице; альтернативы — unelevated или контейнер WSL2.
• Авторизация: используйте подписку ChatGPT с кэшированием в auth.json. Для серверов применяйте команду codex login --device-auth.
• Диагностика: проверяйте переменную PATH при ошибках вызова и используйте which -a при конфликтах версий.

Теперь вы готовы развернуть рабочее окружение Codex, выполнить вход и запустить первый тестовый скрипт, а также устранить типичные сбои установки.

В следующей статье 04 · Тарифы и биллинг мы разберем финансовые условия: лимиты в рамках подписок ChatGPT, тарификацию API-ключей и сравнение стоимости использования с Claude Code для планирования вашего бюджета.

Вопрос для размышления: какой метод входа вы выбрали при первой настройке (ChatGPT или API-ключ)? Различия между ними определяют не только лимиты запросов, но и доступность облачных функций.

---

Рекомендуемые материалы

• Правила и триггеры (Rules & Hooks): управление логикой автоматизации
• Особенности разработки на Windows: настройка путей и отладка в WSL
• Пользовательские навыки (Agent Skills): расширение функционала агента