Короткий ответ
Codex CLI ставится одной командой — npm install -g @openai/codex — на Windows, macOS и Linux; нужен только Node.js. На Windows он работает прямо в PowerShell, WSL не обязателен. Проверка: codex --version. Чтобы Codex заработал из России, ему нужен доступ к моделям: вход через аккаунт ChatGPT отсюда недоступен, поэтому вместо него подключают API-ключ стороннего шлюза в файле ~/.codex/config.toml. Ниже — установка на каждой системе, типичные ошибки и подключение через TeamoRouter с оплатой в рублях.
Что понадобится
| Что | Требование |
|---|---|
| Node.js | LTS-версия, рекомендуем 22 |
| Windows | Windows 10 версии 1809 или новее, лучше Windows 11 |
| macOS / Linux | Любая актуальная версия, терминал zsh или bash |
| Доступ к моделям | API-ключ TeamoRouter (как получить — ниже) |
Установка на Windows
1. Установите Node.js
Скачайте LTS-версию с nodejs.org и установите с настройками по умолчанию. Или одной командой в PowerShell:
winget install OpenJS.NodeJS.LTS
Закройте и снова откройте PowerShell, затем проверьте:
node --version
npm --version
2. Установите Codex CLI
В PowerShell (запуск от администратора не нужен):
npm install -g @openai/codex
3. Проверьте установку
codex --version
Ответ вида codex-cli 0.158.0 значит, что всё готово.
У OpenAI есть и отдельный установщик для PowerShell, но из России он не работает. Мы проверили 2 октября 2026 года с серверов в Москве и Санкт-Петербурге: chatgpt.com и releases.openai.com, откуда скачивается установщик, отвечают ошибкой 403 (доступ запрещён), а из Германии и Нидерландов открываются. Реестр npm, nodejs.org и GitHub из России доступны — поэтому ставьте через npm.
Песочница Windows
Codex выполняет команды в песочнице — изолированной среде, чтобы агент не мог менять файлы за пределами проекта. На Windows у неё два режима:
- elevated (основной) — создаёт отдельного пользователя с минимальными правами; при первой настройке Windows покажет запрос контроля учётных записей (UAC), его нужно подтвердить;
- unelevated (запасной) — работает от вашего пользователя с урезанными правами; подходит, если первый режим не настраивается, например из-за корпоративных политик.
Если настройка песочницы не проходит, переключите режим в config.toml (как создать этот файл — ниже):
[windows]
sandbox = "unelevated"
Нужен ли WSL?
Нет. Codex работает в PowerShell напрямую. WSL2 имеет смысл, если ваш проект и инструменты и так живут в Linux: тогда установите WSL командой wsl --install, откройте Ubuntu и ставьте Codex по инструкции для Linux ниже.
Установка на macOS
Через Homebrew:
brew install codex
Или через npm (нужен Node.js, например brew install node):
npm install -g @openai/codex
Проверка — codex --version.
Установка на Linux и в WSL
Поставьте Node.js 22 из nodejs.org или через менеджер версий, затем:
npm install -g @openai/codex
codex --version
Если npm отвечает ошибкой прав доступа (EACCES), не используйте sudo — перенесите глобальные пакеты в домашнюю папку:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @openai/codex
Обновление и удаление
Codex обновляется часто, и новые модели работают только в свежих версиях. Обновление:
npm install -g @openai/codex@latest
На macOS с Homebrew — brew upgrade codex. Удаление — npm uninstall -g @openai/codex.
Первый запуск: подключение без аккаунта ChatGPT
Если сразу после установки запустить codex, программа предложит войти через аккаунт ChatGPT. Из России этот путь закрыт: Россия не входит в список поддерживаемых стран OpenAI, и ни регистрация, ни оплата подписки не проходят. Вместо входа Codex можно подключить к моделям через API-шлюз — это штатная возможность программы.
1. Получите ключ
Зарегистрируйтесь на TeamoRouter, пополните баланс и создайте API-ключ в консоли.
2. Создайте config.toml
Windows (PowerShell):
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "teamorouter"
model = "gpt-6-sol"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8
macOS и Linux:
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "teamorouter"
model = "gpt-6-sol"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF
Если вы переключали песочницу Windows, блок [windows] добавьте в конец этого же файла.
3. Задайте ключ
Windows (PowerShell):
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "ваш ключ TeamoRouter", "User")
Закройте окно PowerShell и откройте новое.
macOS:
echo 'export OPENAI_API_KEY="ваш ключ TeamoRouter"' >> ~/.zshrc
source ~/.zshrc
На Linux — то же самое, но в ~/.bashrc.
4. Запустите
Перейдите в папку проекта и выполните codex. Попросите для начала «кратко опиши структуру этого проекта» — если пришёл ответ, подключение работает. Модель по умолчанию — GPT-6 Sol; чем она отличается от Luna и Astra, разобрано в статье про GPT-6 Sol.
Почему из России не работает официальный вход, что делать с лимитами и как разобрать ошибки подключения — в отдельной статье «Codex в России».
Оплата в рублях
Codex по API-ключу оплачивается за токены, без подписки: типичная задача на GPT-6 Sol стоит несколько центов. Баланс пополняется в консоли рублями — через СБП, Т-Банк, карту Visa / Mastercard / Мир, ЮMoney или SberPay (минимум $5) — или в USDT. Подробно о способах оплаты — в статье «Как оплатить Claude из России», актуальные цены — на странице цен.
Частые ошибки при установке
Windows: «Невозможно загрузить файл …\codex.ps1, так как выполнение сценариев отключено в этой системе» (в английской Windows — codex.ps1 cannot be loaded because running scripts is disabled on this system).
PowerShell по умолчанию запрещает запуск скриптов, а npm создаёт для Codex именно скрипт-обёртку. Разрешите запуск для своего пользователя и откройте PowerShell заново:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
Windows: «Имя "codex" не распознано как имя командлета…» (The term 'codex' is not recognized…).
Терминал не видит глобальные пакеты npm. Закройте и откройте PowerShell после установки. Если не помогло — выполните npm config get prefix и убедитесь, что эта папка есть в переменной PATH.
macOS / Linux: EACCES: permission denied.
У npm нет прав на системную папку. Не ставьте через sudo — используйте решение из раздела про Linux выше или установите Node.js через менеджер версий.
Windows: не удаётся настроить песочницу.
Обычно это отклонённый запрос UAC или ограничения политики компьютера. Подтвердите запрос при следующем запуске или переключитесь на sandbox = "unelevated", как описано выше.
Error loading config.toml: wire_api = "chat" is no longer supported.
Конфигурация из старой инструкции. Замените в ней wire_api = "chat" на wire_api = "responses". Это сообщение мы воспроизвели сами на Codex CLI 0.158.0.
Ошибки уже после установки — неверный ключ, адрес без /v1, запросы, уходящие напрямую в OpenAI, — с точным текстом сообщений разобраны в статье «Codex в России».
Частые вопросы
Чем Codex CLI отличается от приложения Codex? CLI работает в терминале, приложение — в окне с интерфейсом; ключ и config.toml у них общие. Сравнение — в статье «Codex CLI или приложение», установка приложения — в отдельной инструкции.
Работает ли Codex CLI на Windows 10? Да, начиная с версии 1809. Рекомендуется Windows 11.
Как узнать версию Codex? codex --version.
Можно ли поставить Codex без npm? На macOS — через Homebrew (brew install codex). Официальный установщик для PowerShell из России не работает: его серверы отвечают ошибкой 403 (см. раздел про Windows).
Нужен ли VPN? Нет. Мы проверили с серверов в Москве и Санкт-Петербурге: реестр npm и nodejs.org открываются, api.teamorouter.com доступен. А вот серверы OpenAI (api.openai.com) отвечают из России ошибкой 403 — поэтому Codex и подключают через шлюз.
Что дальше
- Codex в России — подключение, лимиты и ошибки подключения.
- Руководство по Codex CLI — краткая инструкция и Fast Mode.
- GPT-6 Sol через API — какую модель выбрать.
- Создать API-ключ.