Установка Codex CLI на Windows, macOS и Linux: первый запуск

Codex CLI — терминальный coding-агент от OpenAI, написанный на Rust. Он запускается локально, работает с кодом в репозитории и выполняет задачи в изолированной среде. Установить его можно четырьмя способами: через автономный инсталлятор, npm, Homebrew cask или бинарник с GitHub Releases.

После установки выберите один из двух независимых путей: официальный вход OpenAI через ChatGPT или OpenAI API Key либо custom provider со своим API Key. В обоих случаях запускается одна и та же команда codex — отдельную версию клиента устанавливать не нужно.

Что понадобится перед установкой

Базовые системные требования из официальной инструкции по установке:

• macOS: 12 (Monterey) и выше.
• Linux: Ubuntu 20.04+ / Debian 10+.
• Windows: Windows 11 через WSL2; для нативного запуска действует отдельная документация.

Node.js нужен только при установке через npm. Автономный инсталлятор, Homebrew cask и архив из GitHub Releases устанавливают готовый исполняемый файл.

Для официального входа через ChatGPT нужен ChatGPT-аккаунт, а для официального API-доступа — ключ с platform.openai.com. Для custom provider нужны собственный аккаунт провайдера, API Key и актуальный Model ID. Node.js нужен только для npm-установки Codex или автоматического скрипта настройки provider.

Установка Codex CLI

macOS и Linux — автономный инсталлятор

Самый простой способ, Node.js не нужен:

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

После завершения установки проверьте команду:

codex --version

Если видите номер версии — команда доступна.

Codex установлен? Подключите свой API Key по актуальной инструкции. Сначала сверьте текущие поля конфигурации в Docs, затем создайте аккаунт BetterToken, если у вас ещё нет собственного ключа.

macOS — Homebrew cask

brew install --cask codex

npm — macOS, Linux, Windows

Требуется Node.js с работающим npm. Минимальную версию Node.js смотрите в поле engines пакета на npmjs.com/@openai/codex.

npm install -g @openai/codex

Если после установки команда codex не найдена, глобальная npm-директория не в PATH. Найдите нужный путь:

npm config get prefix

Сопоставьте этот каталог с переменной PATH в своей оболочке и перезапустите терминал. Не добавляйте /bin вслепую: структура глобального каталога зависит от ОС и способа установки Node.js.

Linux — бинарник с GitHub Releases

На github.com/openai/codex/releases доступны готовые Linux-архивы:

• codex-x86_64-unknown-linux-musl.tar.gz — для x86_64
• codex-aarch64-unknown-linux-musl.tar.gz — для arm64

Распакуйте архив, переименуйте исполняемый файл в codex и поместите его в доступную вам директорию из PATH.

Windows

Codex CLI на Windows запускается нативно или внутри WSL2. В актуальной документации Windows Windows 11 указан как рекомендуемая база для нативного режима; полностью обновлённая Windows 10 поддерживается в режиме best effort.

Нативный Windows (PowerShell). Официальный инсталлятор:

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

При нативном запуске Codex изолирует выполнение задач через Windows Sandbox. Режим задаётся в ~/.codex/config.toml:

[windows]
sandbox = "elevated"

• "elevated": рекомендуется; используется выделенный пользователь sandbox и правила файрволла.
• "unelevated": применяются ACL-ограничения текущего пользователя без выделенного sandbox.

WSL2. Установите Linux-версию Codex CLI внутри WSL2 по инструкции для Linux. Для Linux-инструментов OpenAI рекомендует хранить проект в файловой системе WSL, а не под /mnt/.

Как подключить тот же Codex CLI к BetterToken API

BetterToken не заменяет Codex CLI другим приложением. Установленный официальный codex продолжает работать как обычно, а в ~/.codex/config.toml выбирается custom provider. Запросы Codex идут по OpenAI Responses через Base URL `https://www.bettertoken.ai/v1%60.?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk

Если вы ещё выбираете не только Codex, а общий способ подключать API для нейросетей к рабочим инструментам, сначала сравните доступные сценарии на основной русской странице. Для Codex используйте отдельные шаги ниже: его custom provider работает через Responses API.

Подключение состоит из трёх действий:

1. Создайте аккаунт BetterToken и собственный API Key.
2. Откройте актуальную инструкцию BetterToken для Codex, скопируйте текущий Model ID и поля custom provider, затем полностью остановите Codex.
3. Уберите конфликтующие переменные OpenAI, примените конфигурацию из Docs, перезапустите Codex и выполните маленькую read-only задачу. Успешный ответ и запись расхода в BetterToken Dashboard подтверждают подключение.

Перед настройкой удалите из текущей среды старые переменные OpenAI, которые могут переопределить config.toml.

macOS и Linux:

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Windows PowerShell:

Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", $null, "User")

Автоматическая настройка provider BetterToken

Скрипт настраивает только BetterToken provider и не устанавливает сам Codex CLI. Для него нужен Node.js. Если API Key или Model ID не переданы параметрами, скрипт запросит их интерактивно — не добавляйте секрет в командную строку.

macOS и Linux:

curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk" | bash

Windows PowerShell:

iwr "https://www.bettertoken.ai/install-codex-provider.ps1?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk" -OutFile "$env:TEMP\install-codex-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1"

Точная схема авторизации зависит от поверхности Codex и версии клиента: CLI, приложение и расширение могут хранить состояние входа и читать конфигурацию по-разному. Поэтому Blog не фиксирует значения auth-полей и не смешивает официальный вход с custom provider в одной инструкции.

Выберите нужную поверхность в документации BetterToken для Codex, скопируйте актуальный Model ID из model plaza и после изменения полностью перезапустите Codex. Секрет передавайте только способом, указанным в текущей документации, а не через текст статьи или командную строку.

Официальная авторизация OpenAI

Следующие команды относятся к официальному подключению OpenAI. При использовании custom provider BetterToken команда codex login status не является проверкой BetterToken API: для этого нужно запустить тестовую задачу и проверить ответ.

Вход через ChatGPT

Выполните команду:

codex login

Откроется браузер — завершите вход через свой ChatGPT-аккаунт. Codex сохранит сессию локально, при следующих запусках повторный вход не нужен.

Если запустить codex без аргументов до авторизации, интерфейс тоже предложит войти. Основной способ инициировать вход — codex login.

Вход через API Key

Не передавайте ключ как аргумент команды и не выводите его через echo — значение попадёт в историю shell.

Задайте переменную OPENAI_API_KEY в текущей рабочей среде или через менеджер секретов. Не вставляйте значение в текст статьи, команду или вывод. Когда переменная задана, передайте её через stdin pipe:

printenv OPENAI_API_KEY | codex login --with-api-key

Значение ключа не отображается на экране и не попадает в историю команд.

Проверка авторизации

После входа проверьте статус:

codex login status

Команда показывает текущий способ авторизации или сообщает, что вход не выполнен.

Если статус указывает на отсутствие авторизации — повторите вход соответствующим способом.

Для выхода и удаления сохранённых учётных данных:

codex logout

Файл ~/.codex/auth.json содержит токен доступа — обращайтесь с ним как с паролем. Не удаляйте его вручную: для очистки всегда используйте codex logout.

Документация по авторизации: developers.openai.com/codex/auth. Справочник login-подкоманд и флагов: developers.openai.com/codex/cli/reference.

Первая задача в тестовом репозитории

Начинайте в тестовом репозитории, чтобы не затрагивать рабочий код. Клонируйте любой публичный репозиторий, например сам Codex:

git clone https://github.com/openai/codex codex-test
cd codex-test

Запустите только-читаемую задачу:

codex --sandbox read-only "Explain the entry point of this project"

Флаг --sandbox read-only разрешает model-generated командам только чтение. Если Codex вернул осмысленное описание структуры без изменения файлов, первый запуск завершён.

Для продолжения в TUI с тем же ограничением запустите:

codex --sandbox read-only

Введите в интерфейсе: What files are in this project and what does each do?

Если вы используете официальное подключение OpenAI, убедитесь, что авторизация остаётся активной:

codex login status

Если вы используете BetterToken provider, нормальный ответ подтверждает соединение. Дополнительно откройте BetterToken Dashboard и убедитесь, что запрос, модель, статус и расход input/output/cache Token появились в истории использования.

Что делать, если что-то не работает

codex: command not found после npm install

Выполните npm config get prefix, сопоставьте полученный каталог с PATH и перезапустите терминал. Точный исполняемый путь зависит от ОС и способа установки Node.js, поэтому не добавляйте /bin вслепую.

Браузер не открылся при входе через ChatGPT

На удалённом сервере без графического интерфейса сначала попробуйте официальный device-code flow (beta):

codex login --device-auth

Его нужно предварительно разрешить в настройках безопасности ChatGPT или в разрешениях workspace. Если этот вариант недоступен, используйте вход через API Key:

printenv OPENAI_API_KEY | codex login --with-api-key

Подробности о callback, device code и запасных вариантах перечислены в официальной документации авторизации.

Codex не отвечает после подключения BetterToken

Проверьте пять пунктов: base_url равен https://www.bettertoken.ai/v1%60,?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk wire_apiостаётсяresponses, Model ID взят из актуального списка BetterToken, model_providerсовпадает с[model_providers.custom], а старые OPENAI_API_KEYиOPENAI_BASE_URLне переопределяют конфигурацию. После измененияconfig.toml` полностью перезапустите Codex в новом терминале.

codex login status показывает Not logged in

• Вход через ChatGPT: выполните codex login ещё раз и завершите вход в браузере.
• Вход через API Key: убедитесь, что OPENAI_API_KEY задана в рабочей среде, затем повторите printenv OPENAI_API_KEY | codex login --with-api-key.
• Не удаляйте ~/.codex/auth.json вручную — используйте codex logout.

---

Документация Codex CLI: developers.openai.com/codex/cli. Подключение того же Codex CLI к BetterToken API: docs.bettertoken.ai/ai-tools/codex.