MegaBrain University · гайд
Codex CLI со своим провайдером: как запустить Codex на GPT-6 без подписки ChatGPT
Обновлено · 5 мин настройка
Коротко
Чтобы запустить Codex через MegaBrain, добавьте в ~/.codex/config.toml раздел [model_providers.megabrain] с base_url = "https://themegabrain.ru/api/gateway/v1", env_key = "MEGABRAIN_API_KEY" и wire_api = "responses", затем задайте model_provider = "megabrain" и model = "openai/gpt-6.1-sol". После этого Codex пишет код на GPT-6 с оплатой за токены с баланса организации — без подписки ChatGPT и аккаунта OpenAI.
| Base URL (OpenAI-совместимый) | https://themegabrain.ru/api/gateway/v1 |
|---|---|
| Base URL для Claude Code и Anthropic SDK | https://themegabrain.ru/api/anthropic |
| Ключ | Authorization: Bearer <ключ> — страница «API-ключ» в кабинете |
| Модель по умолчанию | anthropic/claude-sonnet-5.5 |
| Бесплатная модель для проверки | mb-auto/free |
Что такое Codex
Codex — открытый ИИ-агент OpenAI для программирования. Он работает в терминале (codex), в IDE и без интерфейса в CI (codex exec): читает репозиторий, следует инструкциям проекта из AGENTS.md, правит файлы и выполняет команды в песочнице с режимами подтверждения, подключает MCP-серверы.
По умолчанию Codex входит через ChatGPT, но в его конфиге можно задать свой провайдер моделей. MegaBrain отдаёт OpenAI Responses API, на котором говорит Codex, поэтому один ключ и один баланс организации дают Codex модели GPT-6.1 Sol и Terra, а тот же ключ работает со всеми остальными моделями и агентами из MegaBrain University.
Настройка по шагам
Шаг 1. Получите API-ключ MegaBrain
themegabrain.ru работает для компаний и их сотрудников, по приглашениям. Компания оставляет заявку, мы заводим организацию, а сотрудники получают приглашение на почту с паролем. Сотрудник входит и создаёт ключ на странице «API-ключ». Один ключ открывает все текстовые модели, а также модели изображений и видео.
Баланс организации пополняется безналичным переводом по счёту в рублях: без VPN и зарубежной карты. Подписки нет, каждый запрос оплачивается по цене модели, а расход виден по каждому сотруднику.
Сохраните ключ в переменной окружения, чтобы он не попал в конфиг, которым вы делитесь с коллегами:
# ~/.zshrc или ~/.bashrc export MEGABRAIN_API_KEY="ваш-ключ-megabrain"curl https://themegabrain.ru/api/gateway/v1/chat/completions \ -H "Authorization: Bearer $MEGABRAIN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "anthropic/claude-sonnet-5.5", "messages": [{"role": "user", "content": "Ответь: OK"}]}'Проверьте ключ до настройки агента. Ответ в JSON с полем
choicesзначит, что ключ, баланс и модель работают:Шаг 2. Установите Codex
Через npm или, на macOS, через Homebrew:
npm install -g @openai/codex # или brew install --cask codexШаг 3. Добавьте MegaBrain как провайдера моделей
Откройте
~/.codex/config.toml. Провайдер должен быть именно в этом пользовательском файле:.codex/config.tomlпроекта не может задаватьmodel_provider.model = "openai/gpt-6.1-sol" model_provider = "megabrain" [model_providers.megabrain] name = "MegaBrain" base_url = "https://themegabrain.ru/api/gateway/v1" env_key = "MEGABRAIN_API_KEY" wire_api = "responses"env_key— имя переменной окружения, в которой лежит ключ, так что сам ключ в файл не попадает.wire_api = "responses"заставляет Codex обращаться к/responses, который MegaBrain поддерживает.Шаг 4. Запустите Codex и проверьте
Откройте репозиторий и запустите
codex. Попросите сделать что-то с файлами — «добавь unit-тест для utils/date.ts и запусти его». Если Codex изменил файл и запустил тест, провайдер и вызов инструментов работают. Одна задача без интерфейса:codex exec "кратко опиши, что делает этот репозиторий".Шаг 5. Переключайте модели профилями
Профиль — отдельный файл рядом с конфигом со своими ключами верхнего уровня. Создайте
~/.codex/cheap.config.tomlи запускайтеcodex --profile cheapдля рутинной работы (Codex 0.134 и новее; в старых версиях профили задавались таблицами[profiles.<name>]):# ~/.codex/cheap.config.toml model = "openai/gpt-6.1-terra" model_reasoning_effort = "low"
Какую модель выбрать
Codex настроен под модели OpenAI: по умолчанию берите openai/gpt-6.1-sol, а для недорогих рутинных прогонов — openai/gpt-6.1-terra. Остальные модели каталога доступны через тот же эндпоинт Responses, но промпты и инструменты Codex построены вокруг GPT: сначала проверьте другую модель на небольшой задаче, а для Claude лучше подойдёт Claude Code.
| ID модели | Когда брать |
|---|---|
anthropic/claude-sonnet-5.5 | Модель по умолчанию для агента: надёжно вызывает инструменты, держит длинные задачи, контекст 1 млн токенов. |
anthropic/claude-opus-5.5 | Сложные многошаговые задачи, ревью кода, аналитика, где ошибка дороже токенов. |
openai/gpt-6.1-sol | Флагман OpenAI: альтернатива Claude для кода и рассуждений. |
google/gemini-3.8-flash | Быстро и недорого: длинные документы, таблицы, разбор входящих. |
moonshotai/kimi-k3.1-pro | Сильная открытая модель для агентов и кода. |
z-ai/glm-5.3 | Открытая модель для кода и инструментов, хорошее соотношение цены и качества. |
deepseek/deepseek-v4.1-flash | Массовые рутинные задачи: классификация, черновики, саммари. |
mb-auto/free | Бесплатно, для проверки настройки. Контекст 128 тыс., слабее в вызове инструментов; не отправляйте конфиденциальные данные. |
Все модели с ценами и размером контекста — в каталоге. Каждая модель вызывается одним и тем же ключом.
Что можно делать
AGENTS.md
Инструкции проекта в AGENTS.md (команды сборки, соглашения, что нельзя трогать) читаются при каждом запуске, так что агент следует правилам команды.
Песочница и подтверждения
Codex выполняет команды в песочнице и спрашивает разрешения перед рискованными шагами; режим подтверждения определяет, сколько он может делать сам.
codex exec для автоматизации
codex exec выполняет одну задачу без интерактива — в CI, по cron или из скрипта — и выводит результат.
MCP-серверы
Добавьте MCP-серверы в config.toml, чтобы дать Codex доступ к трекеру задач, базе данных или документации.
Сценарии для бизнеса
Codex для всей команды без подписок ChatGPT
Разработчикам не нужны личные подписки ChatGPT, оплаченные зарубежной картой: у каждого свой ключ MegaBrain, баланс организации пополняется по счёту в рублях, а расход виден по каждому сотруднику. Платите за фактические токены, а не за места.
Автоматическое исправление упавшей сборки
Когда сборка в GitHub Actions или GitLab CI падает, следующий шаг запускает codex exec с логом: Codex находит причину, исправляет её в отдельной ветке и оставляет короткое объяснение для ревьюера.
Задача для агента:
CI упал, лог в ci.log. Найди первопричину, исправь её минимальным изменением, запускай упавшие тесты, пока они не пройдут, и запиши в FIX.md три строки: в чём была причина и что исправлено.Второе мнение по коду Claude
Команды, которые пишут код в Claude Code, просят Codex на GPT-6.1 Sol проверить диф: модель другой лаборатории находит другие ошибки, а платите вы с того же баланса.
Ночная рутина по многим репозиториям
Скрипт по cron обходит репозитории и запускает codex exec с дешёвым профилем: обновить зависимость, поправить заголовок лицензии, исправить линтер — по одному pull request на репозиторий.
Если не работает
401 Unauthorized
Ключ не указан или скопирован с ошибкой, либо агент не прочитал переменную окружения (перезапустите агент после export). Проверьте ключ командой curl из шага 1.
402 Payment Required
Закончился баланс организации. Администратор пополняет его по счёту на странице «Баланс»; пока платёж идёт, проверять настройку можно на mb-auto/free.
Model not found
ID модели должен точно совпадать с каталогом, вместе с префиксом лаборатории: anthropic/claude-sonnet-5.5, а не claude-sonnet-5.5. Базовый URL должен заканчиваться на /v1.
Codex игнорирует провайдера и просит войти через ChatGPT
Провайдер записан в .codex/config.toml проекта, а там его задавать нельзя. Перенесите model_provider и [model_providers.megabrain] в ~/.codex/config.toml.
401, хотя ключ правильный
MEGABRAIN_API_KEY не экспортирован в оболочке, из которой запускается Codex. Добавьте export в профиль оболочки и откройте новый терминал.
Частые вопросы
Можно ли пользоваться Codex без подписки ChatGPT?
Да. Со своим провайдером, указывающим на https://themegabrain.ru/api/gateway/v1, Codex оплачивается за токены с баланса организации в MegaBrain; подписка ChatGPT и аккаунт OpenAI не нужны.
Какой wire_api указать?
"responses". Codex работает через OpenAI Responses API, а MegaBrain отдаёт его по адресу /responses под тем же базовым URL.
Сколько это стоит?
Вы платите за токены по цене модели с баланса организации в рублях. Подписки и платы за места нет, поэтому агент, который простаивает, ничего не стоит. Цены в рублях за миллион токенов — в каталоге; mb-auto/free бесплатна.
Это работает из России без VPN?
Да. Агент обращается к https://themegabrain.ru/api/gateway/v1, VPN для запросов к моделям не нужен, зарубежная карта тоже: баланс организации пополняется по счёту в рублях.
Может ли Codex работать на Claude или Gemini?
Все модели каталога доступны через тот же эндпоинт Responses, так что указать их в model можно. Но Codex построен вокруг GPT: для Claude лучше подходит Claude Code, а OpenCode — для любой модели.
Где хранить профили?
В отдельных файлах ~/.codex/<name>.config.toml, запуск — codex --profile <name>. Начиная с Codex 0.134 таблицы [profiles.<name>] внутри config.toml больше не читаются.
MegaBrain · один API для всех моделей
Claude, GPT, Gemini, Kimi, GLM и DeepSeek в любом агенте — один ключ и один баланс.
Без VPN и иностранной карты: компании пополняют баланс по счёту в рублях, сотрудники получают свои API-ключи, расход виден по каждому.