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 -g @openai/codex

Что здесь происходит? - 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 my-test-project
cd my-test-project

mkdir — сделать папку, cd — перейти в неё.

Создайте файл, например hello.js:

echo 'console.log("Привет, мир!");' > 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