88API88API
Руководство пользователяAI-приложенияAPIПомощь и поддержка

OpenAI Codex CLI — ИИ-ассистент для программирования в командной строке


WindowsmacOSLinux

О проекте

Codex CLI is a coding agent from OpenAI that runs locally on your computer.

Codex CLI — агент для программирования от OpenAI, который работает локально на вашем компьютере.

  1. Официальная страница: https://chatgpt.com/codex
  2. Страница проекта: https://github.com/openai/codex
  3. Установка: см. инструкцию ниже на этой странице

Демонстрация


introduce-01.webp

Возможности

КатегорияВозможности
Ассистент в терминале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.Откройте терминал

windows_open_terminal

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
  • При проблемах с правами попробуйте запустить от имени администратора
  • Некоторые антивирусы могут давать ложные срабатывания; добавьте программу в белый список

windows-img-03.webp

Скачайте Node Version Manager (NVM)

После перезагрузки откройте PowerShell, введите wsl, чтобы войти в Ubuntu, и выполните:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

windows-img-04.webp

Установка Node.js 22 через NVM

Откройте новую вкладку PowerShell и запустите WSL wsl

Установите Node.js (npm-пакет Codex требует Node.js 16 или новее, рекомендуется 22 LTS):

nvm install 22

windows-img-05.webp

3.Установите Codex CLI

Установка Codex CLI

npm i -g @openai/codex Команда скачает и установит последнюю версию Codex CLI из официального реестра npm.

windows-img-06.webp

4.Измените файл конфигурации (внутри WSL)

Codex установлен в WSL, поэтому и конфигурацию нужно записать в WSL. Откройте PowerShell, введите wsl, чтобы войти в Ubuntu, и выполните:

Изменение конфигурации Codex CLI одной командой (внутри WSL)

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

windows-configure

Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.

На запрос 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.

windows-img-09.webp

windows-img-10.webp

Настройка прав Codex CLI: 1. Разрешить Codex изменять файлы напрямую; 2. Изменение файлов Codex требует ручного подтверждения

Выбор модели

/model

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

Выбор модели командой /model в Codex CLI

Выбор уровня рассуждений в Codex CLI

Внимание: после настройки все модели в /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

macos-img-01.webp

Установка Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

macos-img-02.webp

macos-img-03.webp

macos-img-04.webp

2.Установите Node.js

Установка Node.js

Обновите Homebrew brew update Установите Node.js brew install node

Особенности macOS

  • При проблемах с правами может понадобиться sudo
  • При первом запуске может потребоваться разрешение в «Системных настройках»
  • Рекомендуется использовать Terminal или iTerm2

macos-img-05.webp

macos-img-06.webp

Проверка установки

После установки откройте терминал и выполните команды:

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.

macos-img-07.webp

Проверка установки Codex CLI

После установки выполните команду, чтобы проверить результат: codex --version Если отображается номер версии — поздравляем, Codex CLI установлен.

4.Измените файл конфигурации

Изменение конфигурации Codex CLI одной командой

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

macos-configure

Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.

На запрос 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.

macos-img-09.webp

macos-img-10.webp

Настройка прав Codex CLI: 1. Разрешить Codex изменять файлы напрямую; 2. Изменение файлов Codex требует ручного подтверждения

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

Выбор модели командой /model в Codex CLI

Выбор уровня рассуждений в Codex CLI

Внимание: после настройки все модели в /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

linux-img-01.webp

linux-img-02.webp

Проверка установки

После установки откройте терминал и выполните команды:

node --version
npm --version

Если отображаются номера версий, установка прошла успешно.

2.Установите Codex CLI

Установка Codex CLI

Откройте терминал и выполните:

npm install -g @openai/codex

При проблемах с правами: sudo npm install -g @openai/codex

linux-img-03.webp

Проверка установки Codex CLI

После установки выполните команду, чтобы проверить результат: codex --version Если отображается номер версии — поздравляем, Codex CLI установлен.

3.Измените файл конфигурации

Изменение конфигурации Codex CLI одной командой

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

macos-configure

Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.

На запрос 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

linux-img-05.webp

linux-img-06.webp

Настройка прав Codex CLI: 1. Разрешить Codex изменять файлы напрямую; 2. Изменение файлов Codex требует ручного подтверждения

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

Выбор модели командой /model в Codex CLI

Выбор уровня рассуждений в Codex CLI

Внимание: после настройки все модели в /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"