Инструмент командной строки Codex
Codex CLI — официальный инструмент командной строки, написанный на Rust. Он лёгкий и эффективный, подходит для любителей терминала.
Установка CLI
Codex CLI поддерживает macOS, Linux и Windows (экспериментально).
Установка npm
Глобальная установка npm
npm install -g @openai/codex
# Проверка установки
codex --version
Установка Homebrew
Установка Homebrew
brew install codex
Обновление CLI
Обновление версии
npm install -g @openai/codex@latest
# Обновление через Homebrew
brew upgrade codex
Первое использование
При первом запуске Codex он проведёт вас через аутентификацию.
Запуск Codex
codex
# Или укажите начальную задачу
codex "Объясните структуру этого проекта"
Codex откроет браузер для аутентификации.
- Войдите в аккаунт ChatGPT
- Или используйте ключ OpenAI API
- После авторизации вернитесь в терминал, чтобы продолжить.
Интерактивный TUI
По умолчанию CLI переходит в режим Terminal User Interface (TUI), обеспечивая эффект полного погружения.
Области интерфейса TUI
| Область | Функция |
|---|---|
| Область сообщений | Отображает историю диалога, вызовы инструментов и результаты выполнения |
| Область ввода | Нижнее поле ввода, отправьте промпт |
| Строка состояния | Отображает модель, использование контекста и информацию о потоке |
Настройки режима TUI
Конфигурация TUI
[tui]
# Режим альтернативного экрана
alternate_screen = "auto" # auto | always | never
# Сохранять историю прокрутки, когда альтернативный экран отключён
# alternate_screen = "never"
Режим альтернативного экрана заставляет Codex использовать отдельный экран и восстанавливает исходное состояние терминала при выходе.
Режим подтверждения
Режим подтверждения управляет поведением подтверждения перед выполнением действий Codex.
Четыре режима
| Mode | Описание | Поведение |
|---|---|---|
| suggest | Режим Suggest | Codex предоставляет рекомендации, но не выполняет |
| auto-edit | Авторедактирование | Автоматически выполняет правки файлов, команды требуют подтверждения |
| full-auto | Полностью автоматический | Автоматически выполняет все операции (используйте с осторожностью) |
| interactive | Интерактивный режим | Спрашивать перед чувствительными операциями (по умолчанию) |
Установить режим подтверждения
codex --approval-mode full-auto
# Или переключиться в сеансе
/approval full-auto
В режиме full-auto Codex автоматически выполняет все операции, включая удаление файлов. Используйте с осторожностью.
Режим песочницы
Режим песочницы ограничивает область доступа Codex к файлам и командам.
| Mode | Изменение файлов | Выполнение команд | Доступ к сети |
|---|---|---|---|
| read-only | Запрещено | Запрещено | Запрещено |
| workspace-write | Только рабочая область | Разрешено | Запрещено |
| danger-full-access | Разрешено | Разрешено | Разрешено |
Установить режим песочницы
codex --sandbox read-only
# Режим записи рабочей области (рекомендуется)
codex --sandbox workspace-write
# Режим полного доступа (опасно)
codex --sandbox danger-full-access
Слэш-команды
CLI предоставляет богатый набор слэш-команд:
| Команда | Функция |
|---|---|
/model | Переключить модель (например, /model gpt-5.4-mini) |
/fast | Переключить быстрый режим |
/plan | Войти в режим планирования |
/review | Просмотреть изменения кода |
/new | Начать новую сессию |
/resume | Возобновить предыдущий сеанс |
/fork | Клонировать текущий сеанс в новый поток |
/compact | Сжать историю контекста |
/status | Показать статус сеанса |
/clear | Очистить экран |
/quit | Выйти из Codex |
Примеры использования команд
Слэш-команды
/model gpt-5.4-mini
# Режим планирования
/спланируй реализацию системы аутентификации пользователей
# Просмотреть статус
/status
Выполнение команд оболочки
Выполняйте команды оболочки непосредственно в CLI:
Выполнить команду
! ls -la
# Выполнить команду git
! git status
# Просмотреть процессы
! ps aux
Подтверждение команды
Опасные команды требуют подтверждения:
- Удаление файлов (rm)
- Завершение процессов (kill)
- Изменение конфигурации системы
Ввод изображения
CLI поддерживает прикрепление изображений в качестве контекста:
Прикрепить изображение
codex -i screenshot.png
# Прикрепить дизайн-макет
codex --image design.png "Реализуй страницу на основе этого дизайна"
# Несколько изображений
codex -i img1.png -i img2.png
Использование изображений
- Анализировать сообщения об ошибках со скриншотов
- Преобразовывать макеты UI-дизайна в код
- Интерпретировать данные диаграмм
Неинтерактивный режим (exec)
Используйте команду exec для запуска одноразовой задачи; подходит для скриптов и CI/CD:
Команда exec
codex exec "Проверьте код и выведите отчёт"
# Вывод в файл
codex exec "Сгенерировать README" -o README.md
# Использовать конкретную модель
codex exec -m gpt-5.4-mini "Проанализировать структуру проекта"
# Полный автоматический режим
codex exec --full-auto "Запустите тесты и исправьте ошибки"
Общие параметры exec
| Параметр | Описание |
|---|---|
-m | Указать модель |
-o | Вывод в файл |
--full-auto | Полностью автоматическое выполнение |
--ephemeral | Не сохранять файлы сессии |
--json | Формат вывода JSON |
Горячие клавиши
| Горячая клавиша | Функция |
|---|---|
Enter | Отправить сообщение |
Shift+Enter | Новая строка |
Ctrl+C | Прервать операцию |
Ctrl+C (两次) | Выйти из Codex |
Ctrl+D | Выход (когда ввод пуст) |
Ctrl+R | Поиск по истории |
Up/Down | Просмотр истории |
Tab | Автодополнение |
Esc Esc | Редактировать последнее сообщение |
Ctrl+O | Копировать последний ответ |
ЧАВО
Вопрос: Статус поддержки Windows?
Нативная поддержка Windows экспериментальна; для наилучшего опыта рекомендуется WSL2.
Вопрос: Как отключить альтернативный экран?
Используйтеcodex --no-alt-screenили настройтеalternate_screen = "never"。
Вопрос: Команда не найдена?
Убедитесь, что PATH включает глобальный каталог установки npm, или установите с помощью Homebrew.
Вопрос: Как просмотреть подробные логи?
Логи находятся в~/.codex/log/каталог.