OpenAI Codex CLI — ИИ-ассистент для программирования в командной строке
О проекте
Codex CLI is a coding agent from OpenAI that runs locally on your computer.
Codex CLI — агент для программирования от OpenAI, который работает локально на вашем компьютере.
- Официальная страница: https://chatgpt.com/codex
- Страница проекта: https://github.com/openai/codex
- Установка: см. инструкцию ниже на этой странице
Демонстрация

Возможности
| Категория | Возможности |
|---|---|
| Ассистент в терминале | Codex CLI — интерактивный ассистент для программирования в терминале: редактирует код, создаёт патчи и выполняет команды из командной строки. |
| Архитектура на инструментах | Предоставляет инструменты apply_patch, shell, update_plan, multi_tool_use и другие для контролируемого изменения файлов и операций в репозитории. |
| Атомарные патчи | Через apply_patch атомарно добавляет, обновляет и удаляет файлы в специальном формате патчей, что упрощает аудит и откат. |
| Песочница и подтверждения | Поддерживает политики песочницы (например, workspace-write, read-only) и режимы подтверждения (untrusted, on-request, never) для контроля записи и доступа к сети. |
| Отслеживание плана | update_plan перечисляет шаги и отслеживает их статус; в каждый момент ровно один шаг находится в состоянии in_progress, чтобы прогресс был понятен. |
| Правила общения | Перед важными операциями отправляет короткое пояснение, сохраняет дружелюбный и лаконичный тон и сообщает о ходе работы. |
| Ограничения безопасности | Следует строгим правилам (не меняет посторонние файлы, не добавляет заголовки об авторских правах, не выполняет разрушительные команды) и запрашивает подтверждение пользователя для чувствительных операций. |
| Тесты и форматирование | Рекомендует запускать связанные тесты и форматировщики после изменений, но не исправляет проблемы, не относящиеся к текущей задаче. |
| Вывод и стиль | Итоговый вывод следует правилам отображения CLI (например, заголовки **, обратные кавычки для путей и команд) и сохраняет краткую, удобную для просмотра структуру. |
| Параллельное выполнение | Поддерживает параллельный запуск нескольких инструментов через multi_tool_use.parallel для повышения эффективности. |
Настройка ИИ-модели
Пошаговая инструкция для Windows
1.Откройте терминал

2.Установите WSL
Codex теперь работает в Windows нативно: его можно установить прямо в PowerShell командой powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" (или npm i -g @openai/codex, если Node.js уже установлен), затем настроить PowerShell-версией скрипта из шага 4 и запускать codex прямо в PowerShell. Если вам нужны инструменты Linux, используйте WSL2, как описано ниже (в этом случае и Codex, и скрипт настройки должны запускаться внутри WSL, см. шаг 4).
Установите WSL2 и перезагрузите компьютер с Windows
wsl --install После установки перезагрузите компьютер с Windows
Особенности Windows
- Рекомендуется использовать PowerShell, а не CMD
- При проблемах с правами попробуйте запустить от имени администратора
- Некоторые антивирусы могут давать ложные срабатывания; добавьте программу в белый список

Скачайте Node Version Manager (NVM)
После перезагрузки откройте PowerShell, введите wsl, чтобы войти в Ubuntu, и выполните:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
Установка Node.js 22 через NVM
Откройте новую вкладку PowerShell и запустите WSL wsl
Установите Node.js (npm-пакет Codex требует Node.js 16 или новее, рекомендуется 22 LTS):
nvm install 22
3.Установите Codex CLI
Установка Codex CLI
npm i -g @openai/codex Команда скачает и установит последнюю версию Codex
CLI из официального реестра npm.

4.Измените файл конфигурации (внутри WSL)
Codex установлен в WSL, поэтому и конфигурацию нужно записать в WSL. Откройте PowerShell, введите wsl, чтобы войти в Ubuntu, и выполните:
Изменение конфигурации Codex CLI одной командой (внутри WSL)
bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)
Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.
На запрос API 基础地址 (базовый адрес API) просто нажмите Enter (по умолчанию https://api.88api.ai, скрипт сам дополнит адрес до https://api.88api.ai/v1), затем вставьте свой токен 88API (ввод не отображается). Скрипт записывает ~/.codex/config.toml внутри WSL (а не %USERPROFILE%\.codex в Windows; если задана переменная CODEX_HOME, файл записывается туда) и по умолчанию использует
model_provider = "88api", wire_api = "responses" и собственный
experimental_bearer_token провайдера; в конце выводится API 基础地址: https://api.88api.ai/v1 и 已写入: …/config.toml. Новая версия скрипта больше не записывает ключ 88API в
auth.json.OPENAI_API_KEY, чтобы в новых версиях Codex не возникали ошибки API_KEY_REQUIRED /
401 Unauthorized.
Внимание: скрипт перезаписывает существующий
config.toml, а исходный файл автоматически сохраняется какconfig.toml.bak.<время>(скрипт выводит已备份原配置: …). Если вы настраивали MCP-серверы, доверенные проекты или других провайдеров, перенесите их из резервной копии вручную.
Без WSL (нативный PowerShell в Windows)
PowerShell-версию скрипта используйте, только если Codex установлен и запускается в нативном PowerShell Windows (без WSL); она записывает %USERPROFILE%\.codex\config.toml:
curl.exe --ssl-no-revoke -fsSL https://88api.ai/helper/codex-cli-setup.ps1 -o "$env:TEMP\codex-cli-setup.ps1"
PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\codex-cli-setup.ps1"Запросы и записываемые настройки — те же, что описаны выше; после настройки запускайте codex прямо в PowerShell.
Ручная настройка config.toml (необязательно)
Для ручной настройки запишите в ~/.codex/config.toml (в нативной Windows — %USERPROFILE%\.codex\config.toml):
model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"
[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-ваш-ключ-88api"Внимание: base_url должен заканчиваться на /v1 (Codex только добавляет к нему /responses и не дописывает /v1 сам; без /v1 запрос перенаправляется на официальный сайт и завершается ошибкой); в wire_api допускается только responses (в новых версиях Codex chat удалён).
5.Начните работу с Codex CLI
Теперь можно пользоваться Codex CLI!
Запуск Codex CLI
Сначала введите wsl, чтобы войти в Ubuntu; запуск напрямую: codex; работа в конкретном проекте: cd ~/code/your-project (проекты лучше хранить в Linux-каталоге WSL; путь к папке Windows записывается как cd /mnt/c/Users/<имя_пользователя>/path/to/project), затем выполните codex.


Настройка прав Codex CLI: 1. Разрешить Codex изменять файлы напрямую; 2. Изменение файлов Codex требует ручного подтверждения
Выбор модели
/model
В списке Select Model and Effort выберите модель стрелками (текущая помечена (current)) и нажмите Enter, затем в Select Reasoning Level выберите уровень рассуждений: Enter — сделать его значением по умолчанию, s — использовать только в текущем сеансе. Уровень с пометкой (default) — это значение model_reasoning_effort из файла конфигурации (в конфигурации из этого руководства — high).


Внимание: после настройки все модели в
/modelработают через API 88API и не расходуют квоту официального аккаунта. Модели 88API, которые сейчас можно использовать в Codex: gpt-6.1-sol (по умолчанию в скрипте, рекомендуется), gpt-6-astra (флагман), gpt-6-sol, gpt-5.6-sol (по умолчанию в прежних версиях скрипта), gpt-5.6-terra, gpt-6.1-terra, gpt-5.5 (группа вашего токена должна включать нужную модель; если в вашей группе нет gpt-6.1-sol, используйте gpt-6-astra). Модели gpt-6-luna и gpt-5.6-luna из списка 88API пока не предоставляет — при их выборе появится ошибка «модель не найдена».
Пошаговая инструкция для macOS
1.Установите Homebrew (если уже установлен, пропустите)
Homebrew — менеджер пакетов, которого не хватает в macOS.
Официальный сайт: https://brew.sh

Установка Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"



2.Установите Node.js
Установка Node.js
Обновите Homebrew brew update Установите Node.js brew install node
Особенности macOS
- При проблемах с правами может понадобиться
sudo - При первом запуске может потребоваться разрешение в «Системных настройках»
- Рекомендуется использовать
TerminalилиiTerm2


Проверка установки
После установки откройте терминал и выполните команды:
node --version
npm --versionЕсли отображаются номера версий, установка прошла успешно.
3.Установите Codex CLI
Установка Codex CLI
Откройте терминал и выполните:
npm install -g @openai/codexПри проблемах с правами: sudo npm install -g @openai/codex. Также можно установить через Homebrew: brew install --cask codex.

Проверка установки Codex CLI
После установки выполните команду, чтобы проверить результат: codex --version
Если отображается номер версии — поздравляем, Codex CLI установлен.
4.Измените файл конфигурации
Изменение конфигурации Codex CLI одной командой
bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)
Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.
На запрос API 基础地址 (базовый адрес API) просто нажмите Enter (по умолчанию https://api.88api.ai, скрипт сам дополнит адрес до https://api.88api.ai/v1), затем вставьте свой токен 88API (ввод не отображается). Скрипт записывает ~/.codex/config.toml (если задана переменная CODEX_HOME, файл записывается туда) и по умолчанию использует
model_provider = "88api", wire_api = "responses" и собственный
experimental_bearer_token провайдера; в конце выводится API 基础地址: https://api.88api.ai/v1 и 已写入: …/config.toml. Новая версия скрипта больше не записывает ключ 88API в
auth.json.OPENAI_API_KEY.
Внимание: скрипт перезаписывает существующий
config.toml, а исходный файл автоматически сохраняется какconfig.toml.bak.<время>(скрипт выводит已备份原配置: …). Если вы настраивали MCP-серверы, доверенные проекты или других провайдеров, перенесите их из резервной копии вручную.
Ручная настройка config.toml (необязательно)
Для ручной настройки запишите в ~/.codex/config.toml:
model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"
[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-ваш-ключ-88api"Внимание: base_url должен заканчиваться на /v1 (Codex только добавляет к нему /responses и не дописывает /v1 сам; без /v1 запрос перенаправляется на официальный сайт и завершается ошибкой); в wire_api допускается только responses (в новых версиях Codex chat удалён).
5.Начните работу с Codex CLI
Теперь можно пользоваться Codex CLI!
Запуск Codex CLI
Запустите Codex CLI напрямую: codex; работа в конкретном проекте: сначала cd ~/path/to/your/project, затем codex.


Настройка прав Codex CLI: 1. Разрешить Codex изменять файлы напрямую; 2. Изменение файлов Codex требует ручного подтверждения
В списке Select Model and Effort выберите модель стрелками (текущая помечена (current)) и нажмите Enter, затем в Select Reasoning Level выберите уровень рассуждений: Enter — сделать его значением по умолчанию, s — использовать только в текущем сеансе. Уровень с пометкой (default) — это значение model_reasoning_effort из файла конфигурации (в конфигурации из этого руководства — high).


Внимание: после настройки все модели в
/modelработают через API 88API и не расходуют квоту официального аккаунта. Модели 88API, которые сейчас можно использовать в Codex: gpt-6.1-sol (по умолчанию в скрипте, рекомендуется), gpt-6-astra (флагман), gpt-6-sol, gpt-5.6-sol (по умолчанию в прежних версиях скрипта), gpt-5.6-terra, gpt-6.1-terra, gpt-5.5 (группа вашего токена должна включать нужную модель; если в вашей группе нет gpt-6.1-sol, используйте gpt-6-astra). Модели gpt-6-luna и gpt-5.6-luna из списка 88API пока не предоставляет — при их выборе появится ошибка «модель не найдена».
6.Решение частых проблем в macOS
Ошибка прав при установке
Попробуйте следующие решения:
- Установите через
sudo:sudo npm install -g @openai/codex - Или настройте
npmна использование каталога пользователя:npm config set prefix ~/.npm-global
Настройки безопасности macOS блокируют запуск
Если система блокирует запуск Codex CLI:
- Откройте «Системные настройки → Конфиденциальность и безопасность», в разделе «Безопасность» найдите заблокированный codex и нажмите «Всё равно открыть»
- Не рекомендуется глобально отключать Gatekeeper командой
sudo spctl --master-disable(Codex, установленный через npm, обычно не блокируется, а новые версии macOS уже не позволяют отключить Gatekeeper этой командой напрямую)
Пошаговая инструкция для Linux
1.Установите Node.js
Для работы Codex CLI нужна среда Node.js.
Установка Node.js
Добавьте репозиторий NodeSource sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - Установите Node.js sudo apt-get install -y nodejs
Особенности Linux
- В некоторых дистрибутивах нужны дополнительные зависимости
- При проблемах с правами используйте sudo
- Убедитесь, что у вашего пользователя есть права на запись в глобальный каталог npm


Проверка установки
После установки откройте терминал и выполните команды:
node --version
npm --versionЕсли отображаются номера версий, установка прошла успешно.
2.Установите Codex CLI
Установка Codex CLI
Откройте терминал и выполните:
npm install -g @openai/codexПри проблемах с правами: sudo npm install -g @openai/codex

Проверка установки Codex CLI
После установки выполните команду, чтобы проверить результат: codex --version
Если отображается номер версии — поздравляем, Codex CLI установлен.
3.Измените файл конфигурации
Изменение конфигурации Codex CLI одной командой
bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)
Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.
На запрос API 基础地址 (базовый адрес API) просто нажмите Enter (по умолчанию https://api.88api.ai, скрипт сам дополнит адрес до https://api.88api.ai/v1), затем вставьте свой токен 88API (ввод не отображается). Скрипт записывает ~/.codex/config.toml (если задана переменная CODEX_HOME, файл записывается туда) и по умолчанию использует
model_provider = "88api", wire_api = "responses" и собственный
experimental_bearer_token провайдера; в конце выводится API 基础地址: https://api.88api.ai/v1 и 已写入: …/config.toml. Новая версия скрипта больше не записывает ключ 88API в
auth.json.OPENAI_API_KEY.
Внимание: скрипт перезаписывает существующий
config.toml, а исходный файл автоматически сохраняется какconfig.toml.bak.<время>(скрипт выводит已备份原配置: …). Если вы настраивали MCP-серверы, доверенные проекты или других провайдеров, перенесите их из резервной копии вручную.
Ручная настройка config.toml (необязательно)
Для ручной настройки запишите в ~/.codex/config.toml:
model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"
[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-ваш-ключ-88api"Внимание: base_url должен заканчиваться на /v1 (Codex только добавляет к нему /responses и не дописывает /v1 сам; без /v1 запрос перенаправляется на официальный сайт и завершается ошибкой); в wire_api допускается только responses (в новых версиях Codex chat удалён).
4.Начните работу с Codex CLI
Теперь можно пользоваться Codex CLI!
Запуск Codex CLI
# Перейдите в каталог проекта
cd /path/to/your/project
# Запуск Codex CLI
codex

Настройка прав Codex CLI: 1. Разрешить Codex изменять файлы напрямую; 2. Изменение файлов Codex требует ручного подтверждения
В списке Select Model and Effort выберите модель стрелками (текущая помечена (current)) и нажмите Enter, затем в Select Reasoning Level выберите уровень рассуждений: Enter — сделать его значением по умолчанию, s — использовать только в текущем сеансе. Уровень с пометкой (default) — это значение model_reasoning_effort из файла конфигурации (в конфигурации из этого руководства — high).


Внимание: после настройки все модели в
/modelработают через API 88API и не расходуют квоту официального аккаунта. Модели 88API, которые сейчас можно использовать в Codex: gpt-6.1-sol (по умолчанию в скрипте, рекомендуется), gpt-6-astra (флагман), gpt-6-sol, gpt-5.6-sol (по умолчанию в прежних версиях скрипта), gpt-5.6-terra, gpt-6.1-terra, gpt-5.5 (группа вашего токена должна включать нужную модель; если в вашей группе нет gpt-6.1-sol, используйте gpt-6-astra). Модели gpt-6-luna и gpt-5.6-luna из списка 88API пока не предоставляет — при их выборе появится ошибка «модель не найдена».
5.Решение частых проблем в Linux
Ошибка прав при установке
Попробуйте следующие решения:
-
Установите через
sudo:sudo npm install -g @openai/codex -
Или настройте
npmна использование каталога пользователя:npm config set prefix ~/.npm-global -
Затем добавьте его в
PATH:export PATH=~/.npm-global/bin:$PATH
Не хватает библиотек
В некоторых дистрибутивах Linux нужно установить дополнительные зависимости:
# Ubuntu/Debian
sudo apt install build-essential
# CentOS/RHEL
sudo dnf groupinstall "Development Tools"Клиент Codex — ассистент для программирования OpenAI для ПК и IDE
Предыдущая страница
CC Switch — единый менеджер AI CLI
Руководство по CC Switch — кроссплатформенному инструменту для единого управления конфигурациями провайдеров, MCP-серверами и системными промптами Claude Code, Codex, Gemini CLI, OpenCode и других ИИ-инструментов для программирования. Подключение 88API в одно нажатие.