Установка и вход

В этом уроке вы установите Codex CLI, войдёте в аккаунт и убедитесь, что всё работает. Это займёт минут десять. Заодно разберёмся, чем вход через ChatGPT отличается от входа по API-ключу и где Codex хранит ваши учётные данные.

Что понадобится

• Терминал: Terminal или iTerm на macOS, любой эмулятор на Linux, PowerShell на Windows.
• Git и репозиторий, в котором можно экспериментировать.
• Аккаунт ChatGPT с доступом к Codex или API-ключ OpenAI. Какие тарифы что дают — на странице Pricing документации; там же видно, что доступно на бесплатном плане.

Установка

Основной способ — официальный установщик. Им же Codex потом обновляется.

# macOS и Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Для Windows — в новом окне PowerShell:

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

Есть и альтернативы — через npm или Homebrew (в Homebrew Codex теперь ставится как cask):

npm install -g @openai/codex
# или
brew install --cask codex

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

Особенности Linux и Windows

Linux. Песочница Codex на Linux построена на bubblewrap. Поставьте пакет заранее: без него Codex переключится на встроенный помощник, которому нужны непривилегированные user namespaces, и при запуске покажет предупреждение. С пакетом из дистрибутива песочница работает надёжнее:

sudo apt install bubblewrap   # Debian, Ubuntu
sudo dnf install bubblewrap   # Fedora

На Ubuntu 24.04 бывают ошибки запуска песочницы из-за настроек AppArmor — решение описано в документации по песочнице.

Windows. CLI работает нативно в PowerShell со своей Windows-песочницей или внутри WSL2. WSL1 не поддерживается начиная с версии 0.115. Если ваш проект живёт в WSL2, ставьте и запускайте Codex там же — по инструкции для WSL.

Первый запуск и вход

Перейдите в каталог проекта и запустите Codex:

cd ~/projects/site
codex

При первом запуске Codex предложит войти. Есть два способа.

Sign in with ChatGPT. Доступ по вашей подписке ChatGPT. Откроется браузер, вы подтверждаете вход — и всё. Только этот способ даёт доступ к облачным задачам и интеграциям (ревью в GitHub, Slack).

API key. Оплата по тарифам API OpenAI, набор моделей определяется ключом. Подходит для CI и случаев, когда компания работает через API. Облачных функций с ключом нет.

Войти можно и отдельной командой, не запуская сессию:

codex login                     # вход через браузер
codex login --device-auth       # по коду устройства (beta)
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status              # какой способ входа активен
codex logout

Вход по коду устройства нужен для машин без браузера — например, удалённого сервера по SSH. Его сначала надо включить в настройках безопасности ChatGPT (для рабочего пространства — это делает администратор).

Обратите внимание на третью строку: ключ передаётся через stdin, а не аргументом командной строки. Так он не попадёт в историю оболочки.

Где хранятся учётные данные

Codex кэширует данные входа либо в файле ~/.codex/auth.json (в открытом виде), либо в системном хранилище ключей. CLI и расширение для IDE используют общий кэш: войдя в одном месте, вы вошли и в другом.

Относитесь к auth.json как к паролю: не копируйте его в репозиторий, не прикладывайте к задачам и не отправляйте коллегам. Каталог ~/.codex вообще стоит считать личным — там же лежат ваши настройки и история.

Проверка установки

codex --version
codex login status
codex doctor

codex doctor собирает диагностический отчёт: установка, конфигурация, вход. Если что-то не работает, начните с него.

Внутри сессии команда /status показывает текущую модель, режим прав, доступные для записи каталоги и расход токенов. Команда /usage — использование лимитов аккаунта. Те же лимиты видны на странице настроек Codex.

Обновление

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

# повторный запуск установщика (macOS, Linux)
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# или, если сборка поддерживает самообновление
codex update

# Homebrew
brew upgrade --cask codex

# npm
npm install -g @openai/codex

Если команда из урока или статьи не сработала, первым делом проверьте версию и обновитесь. Вторым — загляните в codex --help и документацию CLI.

Если вы работаете в компании

В корпоративных рабочих пространствах ChatGPT администратор может ограничить способ входа (только ChatGPT или только API-ключ), привязать вход к конкретному рабочему пространству и включать модели. Если у вас не появляется нужная модель или функция, причина может быть в политике рабочего пространства, а не в установке. Эти настройки разбираются в курсе «Codex для техдиров».