OpenAI Codex CLI

Руководство по установке OpenAI Codex CLI — установка терминального AI-помощника по программированию в Windows, macOS, Linux с интеграцией с New API. Поддержка песочницы и атомарного патч-редактирования.

Описание проекта

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`) и режимы утверждения (`on-request`, `on-failure`, `never`) для контроля записи и доступа к сети.
Отслеживание плана	`update_plan` используется для отображения шагов и отслеживания состояния, требует, чтобы всегда был один шаг `in_progress` для ясного прогресса.
Нормы взаимодействия	Перед важными операциями отправляет краткое введение, сохраняет дружелюбный, лаконичный тон и предоставляет обновления прогресса.
Ограничения безопасности	Следует строгим правилам (не изменять не связанные файлы, не добавлять заголовки авторских прав, не выполнять деструктивные команды), требует одобрения пользователя для чувствительных операций.
Тестирование и форматирование	Рекомендуется запускать соответствующие тесты и инструменты форматирования после изменений, но не отвечает за исправление проблем, не связанных с текущей задачей.
Вывод и стиль	Конечный вывод соответствует спецификациям CLI (например, заголовки `**`, обратные кавычки для путей/команд), сохраняет сканируемую лаконичную структуру.
Параллельное выполнение	Поддерживает параллельное выполнение нескольких инструментов через `multi_tool_use.parallel` для повышения эффективности.

Метод настройки AI-моделей

Инструкция для Windows с иллюстрациями

1. Откройте терминал

windows_open_terminal

2. Установка WSL

Для достижения наилучшей производительности в Windows установите и используйте Windows Subsystem for Linux (WSL2).

Установка WSL2, перезагрузка компьютера Windows

wsl --install

После установки перезагрузите компьютер Windows.

Примечания для Windows

Рекомендуется использовать PowerShell вместо CMD
При возникновении проблем с правами попробуйте запустить от имени администратора
Некоторые антивирусные программы могут ошибочно блокировать, необходимо добавить в белый список

Скачать Node Version Manager (NVM)

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

NVM установка Node.js 22

Откройте новое окно PowerShell, запустите WSL:

wsl

Установка Node.js (версия может быть устаревшей, установите соответствующую версию согласно требованиям официального сайта OpenAI):

nvm install 22

3. Установка Codex CLI

Установка Codex CLI

npm i -g @openai/codex

Эта команда загружает и устанавливает последнюю версию Codex CLI из официального репозитория npm.

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

Однокнопочное изменение конфигурации Codex CLI

iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.ps1')

windows-configure

5. Начало работы с Codex CLI

Теперь вы можете начать использовать Codex CLI!

Запуск Codex CLI

Запустите WSL2:

wsl

Запустите Codex CLI напрямую:

codex

Использование в конкретном проекте:

cd mnt/c/path/to/your/project
codex

Нажмите Enter для запуска Codex CLI.

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

Выбор модели

/model

Примечание: после изменения адреса интерфейса все модели (включая официальные предустановленные) будут вызывать настроенные вами, законно авторизованные собственные или организационные точки доступа. Используйте собственный развернутый New API или убедитесь, что поставщик услуг имеет законное вышестоящее разрешение и обязательства по соблюдению требований. Не подключайте к производственной среде API-адреса или ключи из неизвестных источников.

Инструкция для 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

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

# Глобальная установка Codex CLI
npm install -g @openai/codex

При возникновении проблем с правами используйте sudo:

sudo npm install -g @openai/codex

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

После установки введите следующую команду, чтобы проверить успешность установки:

codex --version

Если отображается номер версии, поздравляем! Codex CLI успешно установлен.

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

Однокнопочное изменение конфигурации Codex CLI

curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.sh | bash

macos-configure

5. Начало работы с Codex CLI

Теперь вы можете начать использовать Codex CLI!

Запуск Codex CLI

Запустите Codex CLI напрямую:

codex

Использование в конкретном проекте:

cd /path/to/your/project
codex

Нажмите Enter для запуска Codex CLI.

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

Примечание: после изменения адреса интерфейса все модели (включая официальные предустановленные) будут вызывать настроенные вами, законно авторизованные собственные или организационные точки доступа.

6. Решение распространенных проблем в macOS

Ошибка прав при установке

Попробуйте следующие решения:

Используйте sudo для установки: sudo npm install -g @openai/codex
Или настройте npm на использование домашнего каталога: npm config set prefix ~/.npm-global

Настройки безопасности macOS блокируют запуск

Если система блокирует запуск Codex CLI:

Откройте "Системные настройки" → "Безопасность и конфиденциальность"
Нажмите "Всё равно открыть" или "Разрешить"
Или в Terminal выполните: sudo spctl --master-disable

Инструкция для 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

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

# Глобальная установка Codex CLI
npm install -g @openai/codex

При возникновении проблем с правами используйте sudo:

sudo npm install -g @openai/codex

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

После установки введите следующую команду, чтобы проверить успешность установки:

codex --version

Если отображается номер версии, поздравляем! Codex CLI успешно установлен.

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

Однокнопочное изменение конфигурации Codex CLI

curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.sh | bash

macos-configure

4. Начало работы с Codex CLI

Теперь вы можете начать использовать Codex CLI!

Запуск Codex CLI

Запустите Codex CLI напрямую:

codex

Использование в конкретном проекте:

# Перейдите в каталог вашего проекта
cd /path/to/your/project

# Запустите Codex CLI
codex

Нажмите Enter для запуска Codex CLI.

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

Примечание: после изменения адреса интерфейса все модели (включая официальные предустановленные) будут вызывать настроенные вами, законно авторизованные собственные или организационные точки доступа.

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"

OpenAI Codex CLI

Содержание