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 SDKhttps://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. Шаг 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. Шаг 2. Установите Codex

    Через npm или, на macOS, через Homebrew:

    npm install -g @openai/codex
    # или
    brew install --cask codex
  3. Шаг 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. Шаг 4. Запустите Codex и проверьте

    Откройте репозиторий и запустите codex. Попросите сделать что-то с файлами — «добавь unit-тест для utils/date.ts и запусти его». Если Codex изменил файл и запустил тест, провайдер и вызов инструментов работают. Одна задача без интерфейса: codex exec "кратко опиши, что делает этот репозиторий".

  5. Шаг 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-ключи, расход виден по каждому.

Источники

Другие гайды MegaBrain University