Руководство Codex

Тема

Установка Codex CLI ​

Зачем это изучать

Вы сможете самостоятельно установить и обновить Codex, проверить, что он работает, и выбрать правильную среду в Windows без путаницы с файлами.

Codex CLI — вариант Codex, которым управляют текстовыми командами в терминале. Терминал уже есть в macOS, Linux и Windows.

Впервые устанавливаете Codex?

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

Linux и macOS ​

Откройте терминал и выполните официальный установщик:

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows ​

Откройте PowerShell и выполните официальный установщик:

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

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

bash
codex --version
codex --help

Первая команда показывает версию, вторая — встроенную справку именно вашей версии.

Быстрая победа

Если обе команды напечатали версию и справку без сообщения об ошибке, установка готова. Не нужно изучать все флаги сейчас — переходите к входу.

Альтернативная установка через npm ​

Если на компьютере уже работают node --version и npm --version, Codex можно установить через npm:

bash
npm install --global @openai/codex

Слово global означает, что команда codex станет доступна из любой папки текущего пользователя. Специально устанавливать Node.js ради этого способа не нужно: начинающему проще использовать основной установщик выше.

Обновление ​

Сначала попробуйте встроенное обновление:

bash
codex update

Если Codex установлен через npm, повторите npm-команду установки. Для официального автономного установщика повторите команду своей операционной системы из начала страницы.

Как запустить Codex ​

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

bash
cd /path/to/project
ls
codex

cd означает «перейти в папку». Вместо /path/to/project укажите настоящий путь, например ~/Documents/my-project. Команда ls должна показать файлы проекта. После запуска убедитесь, что строка directory в рамке Codex указывает на эту папку. При первом запуске выберите Sign in with ChatGPT.

Windows: PowerShell или WSL2 ​

В Windows есть два распространённых варианта:

  1. PowerShell — встроенный терминал Windows. Вы устанавливаете Codex и инструменты проекта как обычные программы Windows.
  2. WSL2 — отдельная Linux-среда внутри Windows. Она нужна, если проект рассчитан на Linux-команды или его файлы и зависимости уже находятся внутри WSL2.

Нативный запуск означает «непосредственно в Windows». Не смешивайте среды без необходимости: если проект находится внутри WSL2, откройте терминал WSL2, установите Node.js и Codex там и запускайте команды там же. Тогда пути к файлам и установленные программы будут понятны друг другу.

Если проект — обычная папка Windows и его инструкции рассчитаны на Windows, начните с PowerShell.

Автоматическое дополнение команд ​

Codex умеет подсказывать продолжение команды после нажатия Tab. Эта возможность называется автодополнением. Пример для командной оболочки Zsh:

bash
codex completion zsh
eval "$(codex completion zsh)"

Командная оболочка — программа внутри терминала, которая разбирает команды; Bash, Zsh и PowerShell — разные оболочки. Не добавляйте вторую строку в постоянные настройки оболочки вслепую: сначала выполните её один раз и проверьте результат.

Если команда codex не найдена ​

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

bash
command -v codex
codex doctor

Первая команда ищет установленную программу, вторая собирает диагностический отчёт Codex. Не используйте sudo только ради исправления прав: это может создать личные настройки от имени системного администратора.

Куда дальше ​

Теперь войдите в аккаунт. Если установка не прошла, откройте диагностику.

Внешние источники ↗ ​