Codex CLI: как начать с нуля пошагово
Представьте: вы сидите за компьютером, открываете терминал, и у вас появляется помощник, который сам разбирается в вашем коде. Codex CLI — это инструмент от OpenAI, который запускается прямо в терминале. Он читает файлы в папке, меняет код по вашим словам и даже запускает его. Если вы новичок в разработке, эта статья поможет разобраться без лишней теории. Мы пройдём всё шаг за шагом.
Что такое Codex CLI?
Codex CLI — это coding agent, то есть агент для работы с кодом. Его создала OpenAI, компания за ChatGPT. В отличие от онлайн-инструментов, этот запускается локально — на вашем компьютере, в терминале. Терминал — это чёрное окошко, где вы пишете команды, как в фильмах про хакеров, только проще.
Агент берёт вашу текущую папку с проектом (директорию), смотрит на код внутри, понимает, что вы хотите изменить, и делает это сам. Потом может запустить изменения. Полезно, если вы пишете скрипты или экспериментируете с кодом, но ещё не профи.
Подробнее о том, что такое OpenAI Codex простыми словами, читайте в нашей другой статье. Там без техно-жаргона.
Подготовка: что нужно на компьютере
Перед установкой проверьте базовые вещи. Codex CLI работает через npm — это менеджер пакетов для JavaScript. Он идёт вместе с Node.js, бесплатной средой для запуска JS-кода.
- Установите Node.js: Зайдите на nodejs.org. Скачайте версию LTS (стабильную) для вашей системы — Windows, Mac или Linux. Установщик сам поставит npm.
- Проверьте установку: Откройте терминал.
- На Windows: нажмите Win + R, введите cmd или powershell.
- На Mac: Spotlight (Cmd + Space), введите Terminal.
- На Linux: Ctrl + Alt + T.
В терминале напишите node -v и Enter. Должна появиться версия, типа v20.x.x. Потом npm -v — тоже версия.
Если команд нет, переустановите Node.js. Теперь вы готовы.
Установка Codex CLI
Установка простая, одной командой. В терминале введите:
Что здесь происходит? - npm i — install, установить пакет. - -g — global, чтобы команда работала из любой папки. - @openai/codex — название пакета от OpenAI.
Процесс займёт минуту-другую, в зависимости от интернета. Если ошибка — проверьте, работает ли npm. После установки введите codex --version, чтобы убедиться.
На Windows иногда нужно запустить терминал от имени администратора. На Mac/Linux — может потребоваться sudo npm i -g @openai/codex.
Первый запуск и авторизация
Переходим к делу. Откройте терминал, введите codex и Enter. Первый раз откроется процесс sign-in — входа в аккаунт.
Варианты: - Через ChatGPT аккаунт: Если у вас есть логин в ChatGPT (chat.openai.com), используйте его. Удобно для новичков. - Через API key: Если предпочитаете ключ от OpenAI. Создайте его в platform.openai.com/api-keys. Введите ключ по инструкции.
После входа Codex CLI готов. Он запомнит авторизацию, пока не выйдете.
С чего начать: первые шаги с проектом
Создайте тестовую папку для практики. В терминале:
mkdir — сделать папку, cd — перейти в неё.
Создайте файл, например hello.js:
(На Windows используйте echo console.log("Hello!"); > hello.js).
Теперь запустите codex. Агент увидит вашу директорию. Напишите ему задачу, типа: "Добавь функцию, которая считает сумму двух чисел". Он прочитает код, изменит файл и предложит запустить.
Codex работает в выбранной папке: читает все файлы, понимает контекст и действует. Экспериментируйте: меняйте код, запускайте. Если что-то сломалось — Ctrl+C для остановки.
Как использовать Codex CLI в реальной работе
Представьте, у вас скрипт для обработки данных. Codex CLI сделает: - Чтение: Просмотрит все файлы в папке. - Изменения: По вашей команде добавит функции, исправит баги. - Запуск: Сам выполнит код и покажет результат.
Пример: в папке с Python-скриптом скажите "Перепиши на JavaScript". Он сделает.
Советы: - Держите папку чистой — только нужные файлы, чтобы агент не путался. - Говорите ясно: "Добавь проверку на ошибку в функцию X". - Для больших проектов — тестируйте по частям.
Это локальный инструмент, так что данные не улетают в облако (кроме авторизации).
Полезные команды и советы для новичков
- codex --help — список опций.
- codex в папке — старт агента.
- Выход: напишите "exit" или Ctrl+C.
Если проблемы: - Ошибка авторизации? Проверьте интернет и аккаунт. - npm не работает? Очистите кэш: npm cache clean --force.
Практикуйтесь на простых задачах. Со временем поймёте, как общаться с агентом.
Заключение
Codex CLI — отличный способ нырнуть в AI для кода без сложностей. Установили, авторизовались, поигрались — и вы уже используете. Если хотите глубже в нейросети, загляните в наши /courses по теме.
Теперь ваша очередь: создайте проект и попробуйте.
Где следить дальше
Быстрые разборы, новые инструменты и свежие наблюдения я публикую в Telegram: t.me/il_chum