Оффлайн-гайд по установке Codex CLI

Оффлайн-руководство по установке Codex CLI на Windows и macOS: структура пакета, setup-скрипты, частые проблемы и подготовка более дешёвого и стабильного API key.

Оффлайн-гайд по установке Codex CLI

Этот гайд предназначен для новых пользователей, которые хотят установить Codex CLI без зависимости от стабильной внешней сети и сразу начать использовать его после настройки.

Для кого этот гайд

Для тех, кто хочет попробовать Vibe Coding без сильной зависимости от интернета

Для новых пользователей Codex CLI, которым нужен аккуратный путь установки

Для команд, которым нужен переносимый offline-пакет для коллег или друзей

Что подготовить перед установкой

На целевом компьютере должны быть Node.js и npm. Сначала проверьте это в терминале.

node -v
npm -v

Структура пакета

Оффлайн-набор разделён по платформам: windows-x64, macos-arm64 и macos-x64. Внутри каждого каталога есть основной пакет, платформенный runtime, установочные и setup-скрипты.

Сначала определите платформу

Windows

Большинство обычных Windows-машин используют windows-x64.

macOS

Для Apple Silicon используйте macos-arm64, для Intel Mac — macos-x64. На macOS это легко проверить через uname -m.

uname -m

Шаги установки Windows x64

Шаг 1: перейти в offline-каталог установки

cd "your-path\codex-npm-offline\windows-x64\npm-offline"

Шаг 2: запустить установочный скрипт

.\install-codex-windows-x64.cmd

Шаг 3: при необходимости установить вручную

npm install -g .\codex-npm-0.121.0-alpha.6.tgz @openai/codex-win32-x64@file:.\codex-npm-win32-x64-0.121.0-alpha.6.tgz

Шаг 4: проверить, что установка прошла успешно

codex --version

Запустить setup-скрипт

.\run-codex-setup.cmd

После установки setup-скрипт попросит Base URL и API key.

Он записывает конфигурацию в основные файлы Codex и обычно делает резервную копию перед перезаписью.

~/.codex/config.toml
~/.codex/auth.json

Установка macOS Apple Silicon

cd "/your-path/codex-npm-offline/macos-arm64/npm-offline"
bash ./install-codex-macos-arm64.sh

Если удобнее ставить вручную, используйте npm для основного пакета и платформенного пакета.

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-arm64@file:./codex-npm-darwin-arm64-0.121.0-alpha.6.tgz

Установка macOS Intel

cd "/your-path/codex-npm-offline/macos-x64/npm-offline"
bash ./install-codex-macos-x64.sh

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-x64@file:./codex-npm-darwin-x64-0.121.0-alpha.6.tgz

Частые проблемы

После установки не находится команда codex

Закройте текущий терминал, откройте новый и снова выполните codex --version.

Windows блокирует скрипт

Используйте вход через setup-скрипт, потому что он вызывает PowerShell с ExecutionPolicy Bypass.

macOS сообщает, что скрипт не исполняемый

Запускайте shell-скрипты напрямую через bash, а не двойным щелчком.

Как получить стабильный и более дешёвый API key

Если вам всё ещё нужен ключ провайдера, зарегистрируйтесь, сравните группы и цены, создайте API token, затем вставьте Base URL и API key в setup-поток.

Самый короткий путь к использованию

Установить правильный пакет под платформу

Запустить setup и ввести Base URL и API key

Стартовать Codex через codex или использовать codex --yolo для более прямого режима

codex
codex --yolo