Codex на macOS: установка, доступ к проекту и первая проверенная правка
Codex CLI запускается из терминала, читает файлы текущей папки и предлагает изменения с учетом выбранных разрешений. На macOS первая безопасная сессия начинается не с большого проекта, а с проверки установки, отдельной директории и чистого состояния Git.
Установите Codex одним способом
Откройте актуальную страницу Codex CLI и выберите официальный установщик, Homebrew или npm. Не смешивайте способы. Если поставить несколько копий, команда в терминале может запускать не ту версию, которую вы обновили.
После установки откройте новое окно Terminal и выполните codex --version. Если команда не найдена, сначала разберитесь с PATH. Запускать диагностику внутри агента пока бессмысленно: оболочка еще не видит программу.
Войдите в учетную запись
Запустите codex и выберите доступный способ авторизации. Условия доступа зависят от текущей учетной записи и продукта. Не используйте чужой API-ключ и не сохраняйте токен в файле учебного проекта.
После входа закройте сессию. Сначала подготовим папку, к которой агент действительно должен получить доступ.
Создайте отдельный проект
Сделайте каталог codex-mac-first-task, добавьте простой index.html и инициализируйте Git. В файле оставьте заголовок и кнопку без счетчика. Запустите страницу локально и создайте исходный коммит.
Не запускайте Codex из домашней папки. Рабочая директория определяет контекст и границу чтения. Для первого опыта ей должен быть конкретный учебный каталог.
Проверьте разрешения и контекст
Откройте терминал в проекте и запустите codex. Посмотрите текущий режим через /permissions. На первой задаче оставьте подтверждения действий, которые меняют файлы или выполняют рискованные команды.
Начните с анализа:
Назови текущую рабочую папку и файлы проекта. Ничего не меняй и не запускай. Объясни, что делает кнопка в index.html.
Если Codex видит лишние каталоги или описывает другой проект, остановитесь и перезапустите его из правильной папки.
Поручите одну правку
Дайте проверяемое требование:
Добавь счетчик нажатий рядом с кнопкой. Начальное значение 0, каждое нажатие увеличивает его на один. Не меняй текст заголовка и стили. Сначала покажи план и назови файл, который собираешься изменить.
После плана разрешите правку. Для такой задачи не нужны пакеты, сетевой доступ и новые файлы.
Проверьте результат вне Codex
Откройте git diff в другом окне терминала. Убедитесь, что изменен только index.html. Затем обновите страницу и нажмите кнопку несколько раз. Проверьте ноль до первого клика и последовательный рост числа.
Если агент сообщил, что все работает, но вы не запускали страницу, приемка не завершена. Отчет модели не заменяет наблюдаемое поведение.
После проверки создайте коммит. Если появились лишние изменения, верните их до сохранения версии. Команда /review может помочь найти проблемы, но ее вывод также нужно оценивать самостоятельно.
Что стоит настроить позже
После первой успешной задачи можно добавить AGENTS.md с реальными командами проекта и правилами работы. Не храните там секреты и общие пожелания вроде «пиши хороший код». Полезны конкретные факты: команда тестов, каталог исходников, запрет менять миграции без согласования.
Этот короткий цикл является началом более длинной работы. В ИИ-лаборатории Глеба Кудрявцева в проектах Codex используется вместе с VS Code, Git, базой данных, деплоем и безопасностью. То есть установка не отделена от создания собственного проекта.
Codex на macOS готов к работе, когда терминал запускает одну понятную версию, агент открыт в нужной папке, разрешения контролируются, а первая правка подтверждена diff и ручным сценарием.