Академия 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 SDK | https://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. Получите 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. Установите Codex
Через npm или, на macOS, через Homebrew:
npm install -g @openai/codex # или brew install --cask codexШаг 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. Запустите 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, оплаченные зарубежной картой: у каждого свой ключ Пионер ИИ-шлюза, баланс организации — в рублях, а расход виден по каждому сотруднику. Платите за фактические токены, а не за места.
Автоматическое исправление упавшей сборки
Когда сборка в 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-ключи, расход виден по каждому. Доступ по заявке.