Как установить Codex на компьютер: Windows, macOS и первый запуск

Codex CLI работает в терминале: читает файлы проекта, предлагает изменения и запускает локальные команды с учетом выбранных разрешений. Для первого знакомства не нужен большой репозиторий. Нужны корректная установка, отдельная учебная папка и понятная точка возврата в Git.

Ниже приведен маршрут по официальной документации, актуальной на 18 августа 2026 года. Команды установки могут меняться, поэтому перед копированием сверяйте их с текущей страницей Codex CLI.

Проверьте четыре вещи:

· у вас есть доступ к терминалу;

· в системе установлен Git;

· вы можете войти в ChatGPT или использовать другой доступный способ авторизации;

· для эксперимента создана отдельная папка, а не домашний каталог.

Codex получает доступ к текущей рабочей директории. Если запустить его из папки пользователя, область обзора окажется слишком широкой. Для первой задачи создайте, например, каталог codex-first-project и открывайте терминал именно в нем.

Основной официальный способ для macOS и Linux - отдельный установщик:

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

Если вы уже пользуетесь Homebrew, доступен и такой вариант:

Для обновления через Homebrew используется:

Не смешивайте несколько способов без причины. Если установить Codex и отдельным скриптом, и через npm, терминал может запускать не ту копию, которую вы обновили.

В текущей официальной документации есть самостоятельный установщик для Windows. Откройте PowerShell и выполните:

Затем закройте PowerShell, откройте его заново и проверьте:

Codex также работает в приложении ChatGPT для Windows, а для терминального сценария можно использовать нативную PowerShell-среду или WSL. Не переходите в WSL автоматически. Он полезен, если сам проект и его инструменты уже живут в Linux-среде. Если файлы и команды проекта рассчитаны на Windows, нативный запуск проще.

Главное правило: не смешивать пути Windows и WSL в одной первой задаче. Решите, где находится репозиторий и где установлены его зависимости, затем запускайте Codex в той же среде.

Если Node.js и npm уже используются в работе, официальный пакет можно поставить глобально:

Обновление выполняется той же командой. Этот путь не нужен только ради Codex: отдельный установщик избавляет новичка от установки Node.js и диагностики глобальных npm-пакетов.

Ошибка codex: command not found или сообщение PowerShell о неизвестной команде обычно означает, что исполняемый файл не установлен либо его папка не попала в PATH.

Проверьте последовательно:

1. завершился ли установщик без ошибки;

2. открыли ли вы новое окно терминала;

3. не установлена ли в системе другая копия;

4. какой файл запускается командой which codex на macOS/Linux или Get-Command codex в PowerShell;

5. доступна ли команда после перезапуска терминала.

Не запускайте диагностику внутри Codex, если оболочка вообще не видит codex. Сначала нужно восстановить команду на уровне системы.

Создайте отдельную папку и минимальный файл:

Создайте README.md с одной строкой о проекте, затем выполните:

Если Git просит настроить user.name и user.email, выполните предложенные им команды со своими данными, затем повторите коммит. Перед git add убедитесь, что в папке нет .env, ключей, выгрузок и чужих файлов. Для первой тренировки лучше новая пустая папка, чем копия рабочего проекта.

Контрольный коммит нужен не для формальности. После эксперимента вы сможете точно увидеть изменения и вернуться к исходной версии.

Находясь в папке проекта, запустите:

При первом запуске выберите Sign in with ChatGPT или другой предложенный способ. После входа не начинайте с просьбы «сделай сайт». Сначала дайте задачу только на чтение:

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

Так вы одновременно проверите доступ, рабочую директорию и понимание ограничения.

В Codex можно посмотреть и изменить режим разрешений через /permissions. Для первой задачи оставьте подтверждения действий, которые меняют файлы или запускают рискованные команды.

Разделяйте действия по последствиям:

· чтение файлов и поиск обычно безопаснее;

· изменение одного указанного файла требует проверки diff;

· установка зависимостей меняет окружение и может выполнять сторонние скрипты;

· сетевые запросы передают данные наружу;

· удаление, перезапись и команды с широкими путями требуют отдельного внимания.

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

Попросите добавить в README.md раздел «Как запустить проект». Укажите точную границу:

Сначала покажи план и остановись. После моего подтверждения измени только README.md. Не устанавливай зависимости и не обращайся к сети. Затем покажи diff и предложи ручную проверку.

После плана явно разрешите правку. Когда Codex закончит, не ограничивайтесь его пересказом. В отдельном окне терминала выполните:

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

Остановите сессию и проверьте текущую папку командой pwd на macOS/Linux или Get-Location в PowerShell. Перейдите в корень нужного проекта и запустите codex заново.

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

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

Уточните, для чего он нужен и какие данные будут отправлены. Для чтения локального README.md сеть не требуется. Для загрузки зависимости или документации запрос может быть обоснован, но его нужно отделить от самой правки.

После обновления снова выполните codex --version и найдите исполняемый файл через which codex или Get-Command codex. Если версия не изменилась, в PATH может находиться старая npm-копия раньше standalone-установки.

Не удаляйте случайные папки из PATH. Сначала запишите все найденные пути, определите способ установки каждой копии и удалите ненужную штатной командой ее менеджера. Затем откройте новый терминал и повторите проверку.

В командной среде зафиксируйте один рекомендуемый способ установки. Иначе коллеги будут получать разные ошибки и функции при одинаковой инструкции.

После первого успешного изменения можно попросить Codex подготовить AGENTS.md или обновить существующий. В нем полезны только факты, которые помогают безопасно работать:

· назначение проекта;

· команды установки, запуска, тестов и форматирования;

· структура важных папок;

· запретные файлы и generated artifacts;

· правила работы с секретами;

· критерии готовности изменения.

Проверьте каждую команду самостоятельно. Не сохраняйте личные абсолютные пути, токены и временные обходы. Если инструкция конфликтует с README или CI, исправьте источник правды, а не добавляйте еще одно противоречие.

Если после правки тест не запускается, прочитайте тип сбоя. command not found указывает на отсутствующий инструмент. Ошибка соединения с тестовой базой относится к окружению. Падающий assertion означает, что тест выполнился и увидел неверное поведение.

Передавайте Codex точный вывод и просите сначала классифицировать проблему без изменений. Не разрешайте ему удалять тест, менять ожидаемый результат или добавлять заглушку только ради зеленого статуса.

Сравните с baseline, который запускали до задачи. Если та же ошибка уже была, новая правка не обязана ее исправлять, если это не входило в scope. Запишите известное ограничение отдельно.

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

Не переходите сразу к «перепиши архитектуру». Два-три небольших цикла покажут, понимает ли агент соглашения проекта, а вы научитесь замечать лишний scope. Скорость большого изменения без навыка review дает большой объем непроверенного кода.

Попросите коллегу открыть репозиторий по README и выполнить тот же read-only запрос. Если ему нужны ваши личные настройки, история чата или сохраненная сессия, процесс еще не воспроизводим. Исправьте инструкцию и зависимости проекта, а не передавайте пароль от своей среды.

Освоить такой цикл на небольших проектах можно на курсе «Вайб-кодинг: быстрый старт»: понять проект, ограничить задачу, проверить diff и только затем сохранить результат.

Установка Codex заканчивается не появлением команды в терминале, а первым контролируемым циклом. Если вы знаете текущую папку, имеете Git-точку возврата и независимо проверяете изменения, агент становится рабочим инструментом, а не источником случайных правок.