# Как установить Codex CLI и начать работать

> Codex — AI-агент от OpenAI, который работает с файлами на компьютере. Начать проще всего в приложении ChatGPT для компьютера, где Codex встроен. Версию для терминала, Codex CLI, ставят одной командой с официальной страницы и входят через аккаунт ChatGPT.

Автор: Данил Капнин. Опубликовано 2026-10-26. Оригинал: https://kapnin.tech/guides/kak-ustanovit-codex-cli/

## Что такое Codex CLI

Codex умеет то же, что [Claude Code](https://kapnin.tech/guides/kak-ustanovit-claude-code-na-mac/): создаёт файлы, пишет и запускает код, находит ошибки и исправляет их. CLI — это версия для Терминала. Кроме неё есть Codex в приложении ChatGPT для компьютера, расширение для редакторов кода (VS Code, Cursor, Windsurf) и облачный Codex на сайте chatgpt.com/codex. Аккаунт и лимиты везде одни.

Чем Codex отличается от Claude и что выбрать первым, разобрано в гайде [Claude или Codex](https://kapnin.tech/guides/claude-ili-codex-chto-vybrat-novichku/).

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

- Mac, компьютер на Linux или Windows;
- платный тариф ChatGPT: Codex входит в Plus, Pro, Business, Edu и Enterprise. На бесплатном тарифе его нет. Лимиты OpenAI меняет часто, их сверяй на странице тарифов ChatGPT;
- 10 минут.

## Способ 1. Через приложение ChatGPT, без терминала

1. Скачай приложение ChatGPT для компьютера с официального сайта chatgpt.com и войди в свой аккаунт.
2. Открой раздел **Codex** в приложении.
3. Выбери папку проекта. Для первого раза создай пустую, например «Первый проект».
4. Опиши задачу обычными словами и отправь.

Этот путь я советую новичкам: агент тот же, но всё в окне с кнопками, а изменения в файлах видно наглядно.

## Способ 2. Codex CLI в Терминале

### Шаг 1. Открой официальную инструкцию

Команда установки есть на официальной странице Codex CLI в документации OpenAI и в репозитории openai/codex на GitHub. Есть несколько вариантов: установщик одной командой для Mac и Linux, отдельная команда для Windows, установка через Homebrew или npm. Новичку подойдёт первый.

### Шаг 2. Установи

Скопируй команду с официальной страницы и вставь в приложение «Терминал». Не бери команды из чужих статей и комментариев: подменённая команда установки — частый способ подсунуть вредоносную программу.

### Шаг 3. Запусти и войди

Перейди в папку проекта и запусти Codex командой `codex`. При первом запуске выбери вход через ChatGPT: откроется браузер, подтверди вход, и Codex будет работать по твоей подписке. Вход по API-ключу тоже есть, но тогда платишь отдельно за каждый запрос.

### Шаг 4. Настрой разрешения

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

Если что-то не получилось, скопируй текст из Терминала в обычный чат ChatGPT или Claude и спроси: «Я ставлю Codex CLI и получил такую ошибку. Что делать? Объясни по шагам».

## Как проверить, что всё работает

```text
Сделай в этой папке простую страницу: заголовок «Мой первый проект с Codex», одна строка обо мне и кнопка, которая меняет цвет фона. Открой страницу в браузере. Потом объясни простыми словами, какие файлы ты создал.
```

Открылась страница и кнопка работает — всё установлено. Дальше сделай две вещи. Первая: команда `/init` создаст файл AGENTS.md с правилами для агента, что в нём писать, описано в гайде [про файл правил](https://kapnin.tech/guides/fayl-pravil-dlya-agenta-claude-md-agents-md/). Вторая: настрой [точки сохранения в git](https://kapnin.tech/guides/kak-ne-poteryat-proekt-git-dlya-vaybkodera/).

## Если что-то пошло не так

| Что видишь | Что делать |
|---|---|
| Терминал пишет «command not found» | Закрой Терминал и открой заново. Не помогло — отправь текст ошибки в чат |
| Codex просит API-ключ | Выйди и при запуске выбери вход через ChatGPT |
| Пишет, что тариф не подходит | На бесплатном тарифе Codex нет. Нужен Plus или выше |
| Агент упёрся в лимит | Подожди сброса или начни новую беседу: длинная история расходует лимит быстрее |
| Codex ничего не меняет в файлах | Проверь `/permissions`: возможно, стоит режим только для чтения |

## Частые вопросы

### Codex CLI бесплатный?

Сама программа бесплатная и с открытым кодом, но работать с ней на бесплатном тарифе ChatGPT не получится. Нужна подписка от Plus или API-ключ с оплатой за запросы.

### Чем Codex CLI отличается от Codex в приложении ChatGPT?

Агент один, отличается окно. В приложении больше кнопок, в Терминале удобнее тем, кто уже работает с кодом.

### Можно ли пользоваться Codex и Claude Code одновременно?

Да. Многие держат оба: один пишет, второй проверяет. Чтобы правила были общими, Claude Code можно попросить читать тот же AGENTS.md.

### Codex работает на Windows?

Да, для Windows есть отдельная команда установки и приложение ChatGPT. Этот гайд показывает общий путь, шаги почти те же.