डेवलपर गाइड: Установка Codex CLI на Windows, macOS и Linux: первый запуск: Architecture, Configuration, and Integration Guide

Установка 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 — отдельную версию клиента устанавливать не нужно.

Если ваш сценарий требует максимальной скорости, выберите прямое подключение через единый API шлюз BetterToken.

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

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

• 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.

Если вы ещё выбираете не только 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" | bash

Windows PowerShell:

iwr "https://www.bettertoken.ai/install-codex-provider.ps1" -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, 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.

Оплата и пополнение баланса

Пополнение баланса и оплата API осуществляются в личном кабинете BetterToken. Платформа поддерживает удобные способы оплаты, мгновенное зачисление средств и единый баланс для всех доступных моделей.

Пример числового расчёта и тарифы

По состоянию на 15 августа 2026 года в каталоге цен BetterToken базовые ставки составляют:

• Вход: $3.00 за 1M токенов;
• Выход: $15.00 за 1M токенов;
• Чтение из кэша (cache read): $0.30 за 1M токенов.

Для типового запроса на 100 000 входных и 10 000 выходных токенов без кэша итоговая стоимость составит: 0.1 × $3.00 + 0.01 × $15.00 = $0.45.