Шпаргалка по Codex
В этом приложении содержатся шпаргалка по командам, часто задаваемые вопросы и сведения об обновлении версий.
Шпаргалка по командам
Основные команды CLI
| Команда | Описание |
|---|---|
codex | Запустить интерактивный TUI |
codex "任务" | Запустить и выполнить указанную задачу |
codex exec "任务" | Выполнить задачу в неинтерактивном режиме |
codex --version | Показать информацию о версии |
codex --help | Показать справочную информацию |
Слэш-команды
| Команда | Описание |
|---|---|
/model <name> | Переключить модель |
/fast | Переключить быстрый режим |
/plan | Войти в режим планирования |
/review | Просмотреть изменения кода |
/new | Начать новый сеанс |
/resume | Возобновить сеанс из истории |
/fork | Клонировать текущий сеанс |
/compact | Сжать контекст |
/status | Показать статус сеанса |
/clear | Очистить экран |
/quit | Выйти из Codex |
/approval <mode> | Переключить режим подтверждения |
Аргументы CLI
| Аргумент | Описание |
|---|---|
-m <model> | Указать модель |
--sandbox <mode> | Установите режим песочницы |
--approval-mode <mode> | Установить режим подтверждения |
-i <file> | Прикрепить изображение |
-o <file> | Вывод в файл (exec) |
--full-auto | Полностью автоматическое выполнение |
--ephemeral | Не сохранять файлы сессии |
--reasoning-effort <level> | Усилие рассуждения |
Выполнение команд оболочки
| Формат | Описание |
|---|---|
! <command> | Выполнить команду Shell в Codex |
! git status | Просмотр состояния Git |
! npm test | Запустить тесты |
Пути к файлам конфигурации
Расположения файлов конфигурации
| Файл | Путь | Назначение |
|---|---|---|
| Пользовательская конфигурация | ~/.codex/config.toml | Глобальная конфигурация по умолчанию |
| Конфигурация проекта | .codex/config.toml | Конфигурация для конкретного проекта |
| Инструкции проекта | AGENTS.md | Рекомендации по поведению проекта |
| Каталог журналов | ~/.codex/log/ | Журналы запусков |
| Каталог сессий | ~/.codex/sessions/ | Записи сессий |
Каталог навыков
| Расположение | Путь |
|---|---|
| Уровень проекта | .agents/skills/ |
| Пользовательский уровень | ~/.agents/skills/ |
| Системный уровень | /etc/codex/skills/ |
Горячие клавиши
Сочетания клавиш CLI
| Горячая клавиша | Функция |
|---|---|
Enter | Отправить сообщение |
Shift+Enter | Новая строка |
Ctrl+C | Прервать операцию |
Ctrl+C (两次) | Выйти из Codex |
Ctrl+D | Выход (когда ввод пуст) |
Ctrl+R | Поиск по истории |
Up/Down | Просмотр истории |
Tab | Автодополнение |
Esc Esc | Редактировать предыдущее сообщение |
Ctrl+O | Копировать последний ответ |
Сочетания клавиш приложения
| Горячая клавиша | Функция |
|---|---|
Cmd/Ctrl+N | Новая сессия |
Cmd/Ctrl+Shift+N | Новое окно |
Cmd/Ctrl+W | Закрыть окно/вкладку |
Cmd/Ctrl+[ | Предыдущая вкладка |
Cmd/Ctrl+] | Следующая вкладка |
Часто задаваемые вопросы
Установка и аутентификация
В: Как установить Codex CLI?
Используйте npm или Homebrew:
npm install -g @openai/codex # или brew install codex
В: Как пройти аутентификацию при первом использовании?
Запуск команды codex автоматически открывает браузер для аутентификации. Войдите с помощью аккаунта ChatGPT или API-ключа.
В: Поддержка Windows?
Нативная поддержка Windows экспериментальна; для лучшего опыта рекомендуется WSL2.
Проблемы с использованием
В: Как посмотреть текущую конфигурацию?
Используйте/statusкоманда для просмотра конфигурации и статуса текущего сеанса.
В: Как отключить альтернативный экран?
Используйтеcodex --no-alt-screenили настройтеalternate_screen = "never"。
В: Что делать, если команда не найдена?
Убедитесь, что PATH включает глобальный каталог установки npm, или используйте Homebrew для установки.
Вопрос: Как просмотреть логи?
Логи находятся в~/.codex/log/каталог.
Проблемы с функциями
Вопрос: В чём разница между exec и интерактивным режимом?
exec завершается после однократного выполнения, что подходит для скриптов автоматизации; интерактивный режим поддерживает непрерывный диалог, что подходит для повседневной разработки.
Вопрос: Как возобновить сеанс из истории?
Используйте/resumeкоманда илиcodex resume --last。
Вопрос: Может ли GitHub Actions изменять файлы?
Да, установите sandbox: workspace-write.
Вопрос: Как аутентифицироваться в CI/CD?
Используйте переменную среды CODEX_API_KEY, хранящуюся в Secrets.
Проблемы безопасности
Вопрос: Как запретить Codex удалять важные файлы?
Используйте режим песочницы read-only или workspace-write и настройте Rules, чтобы запретить опасные команды.
Вопрос: Безопасен ли режим full-auto?
full-auto автоматически выполняет все операции, включая удаление файлов; используйте с осторожностью.
Вопрос: Как обрабатывать конфиденциальные данные?
Используйте хранилище Secrets, доступное только в setup-скриптах.
Обновления версий
Последние обновления
| Version | Date | Содержание обновления |
|---|---|---|
| v1.5.0 | 2026-04 | Добавлена поддержка моделей серии GPT-5.4 |
| v1.4.0 | 2026-03 | Улучшена функциональность Worktree |
| v1.3.0 | 2026-02 | Добавлен режим Review |
| v1.2.0 | 2026-01 | Оптимизирована поддержка MCP Server |
| v1.1.0 | 2025-12 | Добавлена интеграция с GitHub |
| v1.0.0 | 2025-11 | Codex официально выпущен |
Обновление CLI
Команды обновления
npm install -g @openai/codex@latest
# Обновление Homebrew
brew upgrade codex
# Просмотр текущей версии
codex --version
Связанные ресурсы
Официальные ресурсы
| Ресурс | Адрес |
|---|---|
| Официальная документация | https://developers.openai.com/codex |
| GitHub | https://github.com/openai/codex |
| Codex Web | https://chatgpt.com/codex |
| Discord | https://discord.gg/openai |
Серия руководств
| Глава | Title | Содержание |
|---|---|---|
| 01 | Начало работы с Codex | Основные возможности, сравнение планов |
| 02 | Основные концепции | Промпт、Поток、Контекст、Песочница |
| 03 | Настольное приложение | Функции приложения, режим проверки |
| 04 | Расширение для IDE | VS Code、Cursor、Windsurf |
| 05 | Инструмент командной строки | Установка CLI, TUI, подтверждение |
| 06 | Облачная версия | Веб-интерфейс, окружения |
| 07 | Интеграция и подключение | GitHub, Slack, Linear, MCP |
| 08 | Конфигурация и кастомизация | Конфигурация, правила, навыки |
| 09 | Автоматизация и CI/CD | exec, SDK, GitHub Action |
| 10 | Режимы рабочего процесса | Рабочий процесс разработки, рефакторинг, исправление ошибок |
| 11 | Лучшие практики промптов | Структура промпта, декомпозиция задач |
| 12 | Безопасность и корпоративное управление | Песочница, разрешения, журналы аудита |
| 13 | Выбор модели | Серия GPT-5.4, сила рассуждений |
| 14 | Приложение | Краткий справочник команд, FAQ |
Глоссарий
| Термин | Описание |
|---|---|
| Агент | Основная исполнительная единица Codex, способная понимать задачи и выполнять операции |
| Промпт | Инструкции по задаче, отправленные пользователем в Codex |
| Поток | Последовательность сеанса, содержащая полную историю диалога |
| Контекст | Область информации, доступной Codex, включая файлы, беседы и конфигурацию |
| Песочница | Изолированная среда выполнения, ограничивающая область операций Codex |
| Подтверждение | Политики подтверждения, управляющие поведением подтверждения перед выполнением операций |
| AGENTS.md | Файлы инструкций проекта, определяющие рекомендации по поведению Codex |
| Навык | Переиспользуемые модули пользовательских возможностей |
| Субагент | Субагенты, используемые для параллельной обработки сложных задач |
| Правила | Механизм правил, определяющий разрешения на выполнение команд |
| MCP | Model Context Protocol, протокол для подключения внешних инструментов |
| Worktree | Git worktree, используемый для изоляции рабочих каталогов для разных задач |
Обратная связь и поддержка
Получение справки
- Использование
/helpИспользуйте команды для просмотра встроенной справки - Посетите официальную документацию для подробных инструкций
- Присоединяйтесь к сообществу Discord для общения и обсуждений
Сообщение о проблемах
- GitHub Issues:Сообщайте об ошибках или отправляйте запросы на новые функции
- Отправляйте предложения через функцию обратной связи Codex
Другие расширенияCodex постоянно обновляется и развивается; следите за официальными каналами, чтобы получать последнюю информацию.