Codex OpenAI: установка и настройка в РФ

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

Что такое Codex и зачем он нужен

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

От привычного чат-бота он отличается главным: чат выдает текст, который вы потом копируете к себе руками, а агент работает с вашими файлами напрямую. Вы ставите задачу и смотрите на результат, а не переносите куски кода туда-сюда. Для человека, который правит сайт раз в месяц и каждый раз вспоминает, что где лежит, разница ощущается сразу.

Для обеспечения безопасности агент заперт в папке вашего проекта: читать может всё, менять файлы — только внутри нее, а на всё остальное спрашивает разрешение. Насколько ослабить поводок, решаете вы. К этой настройке мы еще вернемся.

Четыре способа добраться до Codex

Под одним названием OpenAI собрала не одну программу, а несколько входов к одному и тому же агенту. Выбор зависит от того, где вам привычнее работать.

• Codex CLI — версия для командной строки. Основной и самый гибкий вариант, наиболее подходящий для того, чтобы пользоваться им в РФ. Это открытый проект, он бесплатен и ставится буквально одной командой в терминале.

• Приложение ChatGPT — обычная программа с окнами для Windows, macOS и Linux, где Codex включается рядом с привычным чатом. Подходит тем, кого терминал пугает.

• Расширение для редактора — панель внутри VS Code, Cursor, Windsurf, Xcode и редакторов JetBrains. Правки показываются прямо рядом с кодом.

• Codex Cloud — облачный режим: задача уходит на серверы OpenAI, которые сами поднимают копию вашего проекта с GitHub и присылают готовый результат.

Важная деталь: первые три варианта работают на вашем компьютере, а облачный — нет. И именно облачный накладывает самые жесткие ограничения на использование. У остальных, как мы сейчас увидим, есть обходной путь.

Как пользоваться Codex в России: условия доступа

Теперь к главному. Как известно, Россия не входит в список стран, которые OpenAI не обслуживает. Это касается и ChatGPT, и платного API — то есть обоих способов официально войти в Codex под аккаунтом OpenAI.

На практике это значит, что для работы с официальным аккаунтом нужны три вещи.

1. Зарубежный IP-адрес — сервисы OpenAI не открываются с российских адресов.

2. Аккаунт ChatGPT на иностранный номер телефона — регистрация с российским номером отклоняется.

3. Карта иностранного банка — российские карты при оплате подписки или пополнении счета API не проходят.

Неприятно, но таковы условия, и внутри самого продукта они не обходятся никак. И даже при их наличии нет никаких гарантий, что связка будет работать завтра так же, как сегодня.

И вот тут у меня для вас хорошая новость.

Как запустить Codex без аккаунта OpenAI

Есть легальный способ запустить «Кодекс» в России: Codex CLI. Это открытая программа под лицензией Apache 2.0. Сама по себе она ничего не знает про подписки и страны: просто отправляет запросы к модели по стандартному протоколу. К какой именно модели — задается в настройках, и возможность указать своего поставщика заложена в агент разработчиками. 

Это не лазейка и не самодеятельность, а штатная настройка, описанная в официальной документации.

Практический вывод простой. Ставите Codex CLI, берете ключ доступа у поставщика моделей, который работает в России и принимает рубли, прописываете пять строк в конфигурационный файл — и агент работает. Ни аккаунта OpenAI, ни иностранной карты, ни зарубежного IP-адреса для этого не нужно.

Что понадобится перед установкой

Еще одна хорошая новость: готовить почти ничего не нужно. Codex CLI — программа для командной строки, и всё, что для нее требуется, в вашей системе уже есть.

• Терминал. На macOS это программа «Терминал»: нажмите Cmd и пробел, наберите ее название и откройте. На Windows — PowerShell: откройте меню «Пуск» и начните печатать PowerShell. На Linux терминал вы и так знаете где.

• Пять минут времени. Установка запускается одной командой и занимает меньше минуты на обычном интернете.

• Папка с проектом. Это любая папка с файлами, над которыми вы хотите работать. Для первого знакомства подойдет и пустая — мы такую заведем.

Ничего больше ставить заранее не нужно — ни Node.js, ни редактор кода (частое заблуждение, которое отпугивает людей еще на подступах). Пригодится разве что Git: он не обязателен, но позволяет одной командой отменить всё, что агент сделал не так. Дальше я буду на него опираться.

Где скачать Codex CLI

Страницы с кнопкой «Скачать Codex CLI», к сожалению, нет. Но искать установочный файл и не нужно. Программа ставится одной командой, которую вы вводите в терминал, а та уже сама забирает нужную сборку с серверов OpenAI. 

Исходный код при этом открыт и лежит в репозитории github.com/openai/codex, так что посмотреть, что именно вы ставите, можно прямо сейчас.

И сразу ответ на вопрос, который возникает следом. Одна и та же программа ставится на Маке и на компьютере с Windows. Работает она одинаково, и все команды внутри нее совпадают. Отличается ровно одна строка — та, которой вы запускаете установку. 

Выбирайте свой вариант в зависимости от того, на какой конфигурации вы работаете. Остальное в гайде будет общим.

1. Как установить Codex на macOS и Linux

Самый короткий путь — официальный установщик. Откройте терминал и выполните одну строку:

Этой же командой агент потом обновляется — отдельной процедуры не предусмотрено.

2. Как установить Codex на Windows через PowerShell

Еще недавно ответ на вопрос, как установить Codex на Windows, начинался словами «сначала поставьте подсистему Linux». Сейчас этого не требуется: агент запускается нативно, слава роботам. Но при условии, что ваша версия «винды» не ниже 10.1809.

Откройте новое окно PowerShell и выполните команду:

Windows 11 настоятельно рекомендуется. «Десятка», начиная со сборки 1809, тоже поддерживается, но уже по остаточному принципу.

3. Как установить Codex на Windows с WSL

Подсистема Linux по-прежнему пригодится, если ваш проект изначально рассчитан на Linux или репозитории уже лежат в ней. Тогда порядок действий такой.

1. В PowerShell с правами администратора выполните wsl --install и выберите дистрибутив, например Ubuntu.

2. Запустите подсистему командой wsl и поставьте агент тем же скриптом, что и на Linux.

3. Держите проекты в домашней папке Linux, а не на диске C — через смонтированный диск всё работает заметно медленнее.

4. Codex CLI: как установить через npm и Homebrew

Если вы не любите запускать скрипты из интернета и предпочитаете пакетные менеджеры, установить Codex CLI тоже легко. Для npm, который входит в состав Node.js, команда такая.

Пользователям macOS доступен еще и Homebrew.

Обновляется такая установка командой brew upgrade --cask codex. 

Функционально все четыре способа дают один и тот же агент. Разница только в вашем компьютере и личных предпочтениях.

Работа в Codex CLI: проверяем, что программа встала

После завершения установки, независимо от выбранного способа, закройте окно терминала, откройте новое и наберите команду проверки версии.

В ответ должен появиться номер версии. Если вместо него вы видите сообщение, что команда не найдена, почти наверняка дело в старом окне терминала: установщик прописывает путь к программе, и уже открытая сессия о нем не знает. Закройте и откройте терминал заново — это решает проблему в девяти случаях из десяти.

Настройка Codex CLI: подключаем модель

Программа установлена, но сама по себе она ничего не умеет. Ей нужна модель, которая будет думать. 

Вот здесь и расходятся те два пути, о которых я говорил выше. Выбирайте тот, который вам подходит.

Вариант первый: вход под аккаунтом ChatGPT

Если у вас есть аккаунт OpenAI и выполнены три условия из раздела про доступ, всё просто. Перейдите в терминале в папку проекта и наберите одно слово.

При первом запуске программа предложит выбрать способ входа и откроет окно браузера для подтверждения. После этого можно работать. Проверить, что вход сохранился, позволяет команда codex login status, а выйти из аккаунта — codex logout. 

Сохраненный вход при этом общий у терминала и расширения для редактора: однажды авторизовавшись, вы получаете доступ в обоих.

Вариант второй: сторонний поставщик, без аккаунта OpenAI

Этот путь не требует ни аккаунта OpenAI, ни иностранной карты, ни зарубежного IP-адреса. Возможность указать своего поставщика моделей заложена в Codex разработчиками и описана в официальной документации — то есть это штатная и легальная настройка, а не «серая зона».

Порядок действий такой.

1. Зарегистрируйтесь у поставщика моделей, который работает в России и принимает рубли. Получите в личном кабинете ключ доступа.

2. Создайте файл с именем config.toml в папке .codex вашего домашнего каталога. Если папки нет, создайте и ее.

3. Впишите в файл настройки, заменив адрес, название модели и имя поставщика на те, что указаны в документации выбранного сервиса.

4. Положите сам ключ в переменную окружения с тем именем, которое вы указали в строке env_key.

5. Закройте терминал, откройте заново и наберите codex в папке проекта.

Содержимое файла должно выглядеть примерно так.

Всё остальное — песочница, подтверждения, работа с файлами — функционирует ровно так же, как с официальным аккаунтом. 

Выбирая поставщика, смотрите на три вещи: 

• совместимость с интерфейсом OpenAI, 

• наличие адреса с окончанием /v1, 

• оплата в рублях. 

Качество результата при этом целиком определяется выбранной моделью — агент лишь передает ей задачу, поэтому проверить связку на небольшом проекте стоит до того, как доверять ей рабочий код.

Codex через Ollama или LM Studio 

Отдельно отмечу вариант для совсем осторожных: Codex умеет работать с моделями, запущенными прямо на вашем компьютере через Ollama или LM Studio. Качество будет скромнее, зато ни ключей, ни оплаты, ни интернета для самой модели не потребуется. Включается это режимом codex --oss.

Первый запуск: безопасный тест

Главная ошибка новичка — натравить агента на важный проект в первый же вечер. Потратьте десять минут на пустую папку и посмотрите, как он себя ведет, пока цена ошибки равна нулю. Вот сценарий, который я прогоняю сам на каждой новой машине.

1. Создайте пустую папку, перейдите в нее в терминале и выполните git init. Это включит историю изменений — вашу страховку на случай, если агент сделает не то.

2. Положите внутрь пару простых файлов: например, небольшой скрипт и текстовое описание проекта в три строки.

3. Запустите агент только на чтение командой codex --sandbox read-only. В этом режиме он может изучать файлы, но ничего не меняет.

4. Дайте первую задачу обычными словами: «Опиши, что делает этот проект, и перечисли файлы, которые ты прочитал». Посмотрите, как он рассуждает.

5. Наберите /status. Эта команда покажет текущую модель, уровень разрешений и расход. Она отвечает на большинство вопросов из разряда «почему он отказывается».

6. Теперь разрешите правки: выйдите и запустите codex --sandbox workspace-write --ask-for-approval on-request. Переключить режим можно и на ходу командой /permissions.

7. Поставьте маленькую задачу вроде «добавь в скрипт функцию, которая выводит текущую дату». Агент будет спрашивать разрешение перед каждым выходом за границу папки.

8. Посмотрите, что изменилось, командой git diff. Не понравилось — откатите всё командой git checkout . и попробуйте сформулировать задачу иначе.

Десять минут такого прогона дают больше понимания, чем час чтения документации.

Разрешения простыми словами

Уровень свободы агента описывается тремя режимами.

1. read-only — только смотрит. Ничего не меняет и не запускает без вашего согласия. Идеален, чтобы разобраться в чужом проекте.

2. workspace-write — работает внутри папки проекта, за ее пределы не просится. Это режим по умолчанию и тот, в котором вы проведете почти всё время.

3. danger-full-access — снимает вообще все ограничения, включая сетевые. Название говорит само за себя.

Третий режим я упоминаю только затем, чтобы посоветовать им не пользоваться. Если агенту нужен доступ к соседней папке, честнее выдать его точечно флагом --add-dir, чем открывать всю систему разом.

AGENTS.md: как объяснить агенту правила

Есть еще один прием, который влияет на качество результата сильнее, чем выбор модели — файл AGENTS.md.

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

Заготовка файла делается командой /init, дальше дописываете всё что нужно вручную. Агент читает эту «библию» перед каждой задачей, так что один раз потраченные полчаса окупаются на всей дальнейшей работе. 

По моему опыту, разница между проектом с внятным AGENTS.md и без него — это разница между опытным кодером, который давно с вами в проекте, и человеком с улицы, случайно владеющим навыками программирования.

Приложение и расширение для редактора

Терминал нравится не всем, и это нормально. Я от него тоже иногда устаю. На этот случай есть ламповые оконные решения двух типов.

Приложение ChatGPT для Windows и macOS скачивается со страницы загрузки на сайте chatgpt.com, для Linux есть отдельная инструкция. Внутри вы выбираете папку проекта, переключаетесь на Codex рядом с обычным чатом и дальше работаете мышкой: несколько задач одновременно, запуск по расписанию, доступ к файлам.

Расширение для редактора ставится из каталога Visual Studio Marketplace. Искать нужно функцию openai.chatgpt. Оно же работает в Cursor и Windsurf, а для Xcode и редакторов JetBrains предусмотрены собственные интеграции. Удобство здесь в том, что правки приходят сразу рядом с исходным файлом и принимаются выборочно.

Правда, здесь есть подводный камень: оба варианта рассчитаны на вход под аккаунтом OpenAI. Настройка со сторонним поставщиком моделей, описанная выше, полноценно работает только в версии для командной строки.

Сколько это стоит

Если вы всё же идете официальным путем, цена привязана к тарифу ChatGPT, причем набор возможностей на разных тирах отличается довольно сильно.

Сама OpenAI называет указанные лимиты ориентировочными. На тарифе Plus это примерно от 350 до 3000 обращений за пятичасовое окно на легкой модели — и в разы меньше на тяжелой. На Pro пятичасового окна сейчас нет вовсе. 

Облачные задачи расходуют квоту заметно быстрее обычных. 

Для сравнения, у сторонних поставщиков оплата обычно идет за фактическое потребление без подписки, что при нерегулярной работе выходит дешевле.

Чего не стоит путать с Codex

Название настолько популярно, что им названа масса продуктов, и в поисковой выдаче их вам непременно подсунут. Не путайте. Чтобы сэкономить вам время, назову несколько главных «двойников».

• Модель Codex 2021 года — работала в первых версиях GitHub Copilot. Отключена в 2023 году, к нынешнему агенту отношения не имеет.

• Codex для заметок — бесплатная программа для конспектов, лежит на GitHub.

• CodeX — команда разработчиков, известная по редактору Editor.js и движку документации CodeX Docs. Названия звучат одинаково, продукты разные.

• Похожие пакеты в npm — официальный называется @openai/codex, на остальные не обращайте внимания.

Критерий простой: то, что вам нужно, лежит по ссылкам на chatgpt.com, learn.chatgpt.com или в репозиторий github.com/openai/codex. Установщики с других адресов смело игнорируйте.

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

Большинство затруднений, возникающих при установке, довольно типичны. Прежде чем идти на форумы, пробегитесь по списку.

• Команда codex не найдена сразу после установки. Виновато старое окно терминала, которое не знает о новой программе. Закройте его и откройте заново.

• Ошибка о неподдерживаемой стране при входе. Вы пытаетесь войти под аккаунтом OpenAI без выполнения условий, описанных выше. Либо выполняйте их, либо переходите на стороннего поставщика.

• Установлен не тот пакет. В npm нужен именно @openai/codex. Будьте внимательны, чтобы не скачать посторонний проект.

• Агент не видит ключ стороннего поставщика. Проверьте, что имя переменной окружения совпадает с тем, что указано в строке env_key, и что терминал перезапущен после ее создания.

• Работа через подсистему Linux идет медленно. Скорее всего, проект лежит на диске C — перенесите его в домашнюю папку Linux.

Заключение

Установка Codex занимает минуту, и самое приятное, что в России работать с ним тоже вполне реально, и даже законно. Правда, если вы внимательно прочитали этот гайд и последовали нашим советам. 

Последний совет: не спешите подключать агента к большому проекту. Заведите тестовую папку, дайте пару заданий, посмотрите, где он угадывает, а где идет не туда. Через некоторое время вы будете понимать про возможности и границы ИИ-агентов больше, чем из любого обзора, включая этот.