Академия Pioneer Labs · гайд

Codex CLI со своим провайдером: как запустить Codex на GPT-6 без подписки ChatGPT

Обновлено · 5 мин настройка

Коротко

Чтобы запустить Codex через Пионер ИИ-шлюз, добавьте в ~/.codex/config.toml раздел [model_providers.pioneer] с base_url = "https://pioneerlabs.ru/api/gateway/v1", env_key = "PIONEER_API_KEY" и wire_api = "responses", затем задайте model_provider = "pioneer" и model = "openai/gpt-6.1-sol". После этого Codex пишет код на GPT-6 с оплатой за токены с баланса организации — без подписки ChatGPT и аккаунта OpenAI.

Параметры подключения
Base URL (OpenAI-совместимый)https://pioneerlabs.ru/api/gateway/v1
Base URL для Claude Code и Anthropic SDKhttps://pioneerlabs.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, но в его конфиге можно задать свой провайдер моделей. Пионер ИИ-шлюз отдаёт OpenAI Responses API, на котором говорит Codex, поэтому один ключ и один баланс организации дают Codex модели GPT-6.1 Sol и Terra, а тот же ключ работает со всеми остальными моделями и агентами из Академии Pioneer Labs.

Настройка по шагам

  1. Шаг 1. Получите API-ключ Пионер ИИ-шлюза

    Пионер ИИ-шлюз работает для компаний и их сотрудников, по приглашениям. Компания оставляет заявку, мы заводим организацию, а сотрудники получают приглашение на почту с паролем. Сотрудник входит и создаёт ключ на странице «API-ключ». Один ключ открывает все текстовые модели, а также модели изображений и видео.

    Баланс организации в рублях, без VPN и зарубежной карты, доступ — по заявке. Подписки нет, каждый запрос оплачивается по цене модели, а расход виден по каждому сотруднику.

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

    # ~/.zshrc или ~/.bashrc
    export PIONEER_API_KEY="ваш-ключ-pioneer"
    curl https://pioneerlabs.ru/api/gateway/v1/chat/completions \
      -H "Authorization: Bearer $PIONEER_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. Добавьте Пионер ИИ-шлюз как провайдера моделей

    Откройте ~/.codex/config.toml. Провайдер должен быть именно в этом пользовательском файле: .codex/config.toml проекта не может задавать model_provider.

    model = "openai/gpt-6.1-sol"
    model_provider = "pioneer"
    
    [model_providers.pioneer]
    name = "Pioneer"
    base_url = "https://pioneerlabs.ru/api/gateway/v1"
    env_key = "PIONEER_API_KEY"
    wire_api = "responses"

    env_key — имя переменной окружения, в которой лежит ключ, так что сам ключ в файл не попадает. wire_api = "responses" заставляет Codex обращаться к /responses, который Пионер ИИ-шлюз поддерживает.

  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, оплаченные зарубежной картой: у каждого свой ключ Пионер ИИ-шлюза, баланс организации — в рублях, а расход виден по каждому сотруднику. Платите за фактические токены, а не за места.

Автоматическое исправление упавшей сборки

Когда сборка в 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.pioneer] в ~/.codex/config.toml.

401, хотя ключ правильный

PIONEER_API_KEY не экспортирован в оболочке, из которой запускается Codex. Добавьте export в профиль оболочки и откройте новый терминал.

Предупреждение «Model metadata for `openai/gpt-6.1-sol` not found»

Не мешает работе. Codex хранит встроенные параметры только для знакомых ему названий моделей, а ID из каталога идут с префиксом разработчика, поэтому он берёт значения по умолчанию. Запросы проходят, модель отвечает как обычно.

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

Можно ли пользоваться Codex без подписки ChatGPT?

Да. Со своим провайдером, указывающим на https://pioneerlabs.ru/api/gateway/v1, Codex оплачивается за токены с баланса организации в Пионер ИИ-шлюзе; подписка ChatGPT и аккаунт OpenAI не нужны.

Какой wire_api указать?

"responses". Codex работает через OpenAI Responses API, а Пионер ИИ-шлюз отдаёт его по адресу /responses под тем же базовым URL.

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

Вы платите за токены по цене модели с баланса организации в рублях. Подписки и платы за места нет, поэтому агент, который простаивает, ничего не стоит. Цены в рублях за миллион токенов — в каталоге; mb-auto/free бесплатна.

Это работает из России без VPN?

Да. Агент обращается к https://pioneerlabs.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 больше не читаются.

Пионер ИИ-шлюз · один API для всех моделей

Claude, GPT, Gemini, Kimi, GLM и DeepSeek в любом агенте — один ключ и один баланс.

Без VPN и иностранной карты: один баланс в рублях на всю команду, сотрудники получают свои API-ключи, расход виден по каждому. Доступ по заявке.

Источники

Другие гайды Академии Pioneer Labs