Source: https://aiprimetech.io/ru/learn/use-claude-api-with-codex/ [Главная](/ru/) / [Обучение](/ru/learn/) / Codex CLI с пользовательским провайдером: config.toml, модели GPT и Claude, расширение для IDE и устранение ошибок # Codex CLI с пользовательским провайдером: config.toml, модели GPT и Claude, расширение для IDE и исправления Codex читает один файл, ~/.codex/config.toml, общий для CLI, codex exec и расширения для IDE. Пользовательский провайдер в этом файле направляет Codex на этот шлюз, где одна и та же конфигурация позволяет запускать модели GPT и Claude. Текущие версии Codex работают только с Responses API (wire_api = "responses"), поэтому старые руководства, в которых используется wire_api = "chat" больше не работают. ## Установите Codex терминалКопировать ``` # macOS / Linux curl -fsSL https://chatgpt.com/codex/install.sh | sh # or with a package manager npm install -g @openai/codex brew install --cask codex codex --version ``` Windows PowerShellКопировать ``` powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" ``` Расширение Codex для VS Code, Cursor и Windsurf устанавливается из магазина расширений редактора и использует тот же ~/.codex/config.toml что и CLI, поэтому всё описанное ниже относится к обоим вариантам. ## Используйте ключ из нужной группы Ключ шлюза относится к одной группе, и эта группа определяет, какие модели можно вызывать с помощью ключа. Для моделей GPT создайте ключ в группе **Codex** в панели управления. Для моделей Claude подойдёт любой ключ Claude с оплатой по мере использования. Для ключа из безлимитной группы нужен активный тариф; без него каждый запрос завершается ошибкой No active subscription found for this group. ~/.bashrc или ~/.zshrcКопировать ``` export AIPRIME_CODEX_KEY=key_from_the_codex_group # GPT models export AIPRIME_CLAUDE_KEY=key_from_a_claude_group # Claude models ``` WindowsКопировать ``` setx AIPRIME_CODEX_KEY "key_from_the_codex_group" setx AIPRIME_CLAUDE_KEY "key_from_a_claude_group" # open a new terminal afterwards ``` ## config.toml для моделей GPT ~/.codex/config.tomlКопировать ``` model_provider = "aiprime" model = "gpt-6-astra" model_reasoning_effort = "high" [model_providers.aiprime] name = "AI Prime Tech" base_url = "https://aiprimetech.io/v1" env_key = "AIPRIME_CODEX_KEY" wire_api = "responses" supports_websockets = false ``` | Настройка | Почему | [model_providers.aiprime] | Любой идентификатор, кроме зарезервированного openai, ollama и lmstudio | base_url = "https://aiprimetech.io/v1" | Codex добавляет /responses к нему | env_key | **Имя** переменной окружения, которая содержит ключ, а не сам ключ | wire_api = "responses" | Единственное значение, которое принимает текущая версия Codex | supports_websockets = false | Оставляет Codex на обычной потоковой передаче HTTP, которая работает через любой прокси или VPN Не добавляйте requires_openai_auth = true или experimental_bearer_token для этого провайдера. При requires_openai_auth = true Codex игнорирует env_key и вместо этого отправляет данные авторизации ChatGPT или OpenAI, которые шлюз отклоняет. ## Запускайте Codex с моделями Claude Шлюз принимает запросы Responses API для моделей Claude и преобразует их, поэтому Codex может работать и с Claude. Добавьте второго провайдера, использующего ваш ключ Claude, а затем профиль для переключения на него. ~/.codex/config.toml (добавьте ниже первого провайдера)Копировать ``` [model_providers.aiprime_claude] name = "AI Prime Tech (Claude)" base_url = "https://aiprimetech.io/v1" env_key = "AIPRIME_CLAUDE_KEY" wire_api = "responses" supports_websockets = false ``` ~/.codex/claude.config.tomlКопировать ``` model_provider = "aiprime_claude" model = "claude-sonnet-5" model_reasoning_effort = "high" ``` терминалКопировать ``` codex --profile claude codex exec --profile claude "review the last commit for bugs" ``` Начиная с Codex 0.134.0 профиль хранится в отдельном файле, ~/.codex/.config.toml, с ключами на верхнем уровне; [profiles.] таблицы внутри config.toml больше не читаются. Профили и провайдеры можно задавать только в пользовательской конфигурации: файл проекта .codex/config.toml игнорирует model_provider и model_providers. ## Модели и интенсивность рассуждений | Идентификатор модели | Провайдер | Для каких задач | gpt-6-astra | Ключ группы Codex | Самая мощная модель GPT на шлюзе; длительные задачи агента | gpt-6-sol | Ключ группы Codex | Более быстрая и дешёвая модель GPT для повседневного программирования | gpt-5.6-terra | Ключ группы Codex | Простые задачи и быстрые правки | claude-sonnet-5 | Ключ Claude | Модель Claude по умолчанию для программирования | claude-opus-5-5 | Ключ Claude | Более сложные рассуждения и масштабный рефакторинг | claude-fable-5-1 | Ключ Claude | Самая функциональная и самая дорогая model_reasoning_effort принимает low, medium, high, xhigh или max, в зависимости от модели. Не задавайте none: эти модели отклоняют это значение с ошибкой 'none' is not supported. review_model задаёт другую модель для /review если это нужно. В панели управления отображаются все модели, доступные группе вашего ключа. ## Расширение для IDE и codex exec Расширение для IDE читает тот же config.toml, но env_key берётся из собственного окружения редактора. Редактор, запущенный из Dock или меню «Пуск», не видит переменные, экспортированные в .bashrc, и тогда Codex завершается с ошибкой Invalid API key хотя CLI работает. Задайте переменную на уровне системы (в Windows setx делает это) или запустите редактор из терминала, например code .. codex exec выполняет одну задачу без интерактивного интерфейса, что подходит для скриптов и CI. Используются те же конфигурация и профили: терминалКопировать ``` codex exec "write unit tests for utils.py" codex exec --profile claude "summarise the changes on this branch" codex login status # which authentication method is active ``` ## Повторные попытки и тайм-ауты У каждого провайдера свои настройки повторных запросов и потоковой передачи. По умолчанию выполняется 4 повторных попыток запроса, 5 повторных подключений к потоку, а тайм-аут бездействия каждого потока составляет 5 мин. Длительные этапы рассуждений могут какое-то время не выдавать данных, поэтому увеличение тайм-аута бездействия помогает при высоких уровнях интенсивности рассуждений. ~/.codex/config.tomlКопировать ``` [model_providers.aiprime] # ...settings from above... request_max_retries = 6 stream_max_retries = 8 stream_idle_timeout_ms = 600000 ``` ## Устранение неполадок: ошибки, с которыми сталкиваются пользователи Codex Ниже приведены ошибки, которые действительно возникают у клиентов Codex при работе с этим шлюзом, начиная с самых распространённых. | Что вы видите | Причина | Решение | 403 No active subscription found for this group | Ключ относится к безлимитной группе без активного тарифа | Используйте ключ из группы с оплатой по мере использования (Codex для GPT) или купите тариф | 401 Invalid API key | Переменная пуста в процессе, запускающем Codex (часто это IDE), или requires_openai_auth = true заставило Codex отправить другие данные авторизации | echo $AIPRIME_CODEX_KEY; удалите requires_openai_auth; перезапустите редактор | 404 Model "..." is not supported by any configured account in this group | Модель не относится к группе ключа, например модель Claude используется с ключом GPT | Переключите провайдера или профиль, чтобы ключ соответствовал модели | 426 WebSocket upgrade required | Транспорт WebSocket включён, но соединение не было переключено на этот протокол | supports_websockets = false, и удалите responses_websockets_v2 из [features] | 403 Your API key has expired | Ключ был создан с ограниченным сроком действия | Создайте новый ключ в панели управления | 'none' is not supported | Интенсивность рассуждений задана как none | Используйте low или выше | 404 page not found | base_url содержит /v1 дважды | Используйте в точности https://aiprimetech.io/v1 | Ошибка конфигурации, связанная с wire_api после обновления | A wire_api = "chat" строка из старого руководства | Задайте wire_api = "responses" | Your balance is used up | Баланс исчерпан | [Пополнить баланс](/ru/topup/) | Concurrency limit exceeded for user | Несколько агентов или окон Codex работают одновременно | Запускайте меньше экземпляров параллельно или обратитесь в поддержку, чтобы увеличить лимит одновременных запусков Сравниваете Codex с Claude Code, прежде чем выбрать один из них? См. [Claude Code и Codex: сравнение](/ru/claude-code/vs-codex/). ## Часто задаваемые вопросы Где находится файл конфигурации Codex? ~/.codex/config.toml (или $CODEX_HOME/config.toml). Его читают CLI, codex exec и расширение для IDE. Задать провайдеров в файле .codex/config.toml проекта нельзя. Можно ли использовать модели Claude в Codex CLI? Да, через шлюз, который принимает запросы Responses API для моделей Claude. Добавьте провайдера с ключом Claude и задайте в model идентификатор, например claude-sonnet-5. Работает ли ещё wire_api = "chat" в Codex? Нет. В справочнике конфигурации Codex responses указан как единственное поддерживаемое значение; оно также используется по умолчанию, если параметр не задан. Почему расширение Codex для VS Code сообщает о недействительном ключе API, хотя CLI работает? env_key считывается из окружения редактора. Задайте переменную на уровне системы или запустите редактор из терминала, в котором она экспортирована. Что означает сообщение «Для этой группы не найдена активная подписка» в Codex? Ключ принадлежит группе с подпиской (Unlimited), у которой нет активного тарифного плана. Используйте ключ из группы с оплатой по мере использования или приобретите тарифный план. Начните использовать Claude за несколько минут Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.[Получить ключ API](/register) AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев. Руководства по API Codex и GPT: [API-ключ Codex и доступ](/ru/codex-api/) · [API, совместимый с OpenAI](/ru/openai-api/) · [Настройка Codex CLI](/ru/docs/guides/codex-cli/) · [Сравнение моделей GPT-6](/ru/blog/gpt-6-models-for-codex/) ## Другие руководства по Claude API [Как получить ключ Claude API](/ru/learn/how-to-get-a-claude-api-key/)[Как устроены цены Claude API](/ru/learn/claude-api-pricing-explained/)[Самый дешевый способ использования API Claude](/ru/learn/cheapest-way-to-use-claude-api/)[Безлимитный Cursor с API Claude](/learn/use-claude-api-with-cursor/)[Безлимитный доступ к Claude Code](/ru/learn/use-claude-api-with-claude-code/)[Шлюз API Claude и прямой доступ к Anthropic: сравнение](/ru/learn/claude-api-vs-anthropic-direct/)[Использование Claude через API, совместимый с OpenAI](/ru/learn/openai-compatible-claude-api/)[Объяснение моделей Claude: сравнение Claude Opus, Sonnet, Haiku и Fable — все модели Claude API, названия моделей Anthropic и цены (2026)](/ru/learn/claude-api-models-compared/)[Оплата API Claude криптовалютой](/ru/learn/claude-api-with-crypto-payment/)[Доступ к API Claude без листа ожидания](/ru/learn/claude-api-without-waitlist/)[Как сократить расход токенов Claude](/ru/learn/how-to-reduce-claude-token-usage/)[Безлимитный Cline с API Claude](/ru/learn/use-claude-api-with-cline/)[Безлимитный Roo Code с API Claude](/ru/learn/use-claude-api-with-roo-code/)[Безлимитный Claude в IDE JetBrains](/ru/learn/use-claude-api-with-jetbrains/)[Aider без ограничений с Claude API](/ru/learn/use-claude-api-with-aider/)[Безлимитный Claude в VS Code](/ru/learn/use-claude-api-with-vscode/)[Конфигурация OpenCode для Claude: настройка opencode.json, модели и распространённые ошибки](/ru/learn/use-claude-api-with-opencode/)[Запуск агента Hermes без ограничений на Claude](/ru/learn/run-hermes-agent-with-claude-api/)[Запуск OpenClaw с Claude без ограничений](/ru/learn/run-openclaw-with-claude-api/)[Что означает API, совместимый с Anthropic](/ru/learn/anthropic-compatible-api/)[Ключ API Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-token](/ru/learn/claude-code-api-key-setup/)[Расходы на API Claude Code — цены и способы их снизить](/ru/learn/claude-code-api-costs/)[Объяснение ошибок API Claude: ошибка сервера 500, перегрузка 529, лимит запросов 429, некорректный запрос 400 — и исправление каждой из них](/ru/learn/claude-api-errors-troubleshooting/)[Как купить кредиты Claude API — и почему кредиты Claude лучше любого предложения «купить аккаунт Claude»](/ru/learn/buy-claude-api-credits/)[Бесплатный API Claude: существует ли бесплатный ключ API Claude и что действительно бесплатно в 2026?](/ru/learn/claude-api-free-trial/)[API Claude или подписка Claude Pro/Max — что выбрать](/ru/learn/claude-api-vs-subscription/)[Подключение Claude к n8n](/ru/learn/use-claude-api-with-n8n/)[Маршрутизация LiteLLM к Claude](/ru/learn/use-claude-api-with-litellm/)[Использование Claude в Kilo Code](/ru/learn/use-claude-api-with-kilo-code/)[Подключение Claude к GitHub Copilot](/ru/learn/use-claude-api-with-github-copilot/)[Подключите Zed к Claude через шлюз](/ru/learn/use-claude-api-with-zed/)[Подключите Cherry Studio к Claude](/ru/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic в LangChain: импорт, base_url, потоковая передача, инструменты и ошибки](/ru/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: установка, настройка base_url, потоковая передача и обработка ошибок](/ru/learn/anthropic-python-sdk/)[Claude с Vercel AI SDK: baseURL в createAnthropic, потоковая передача и устранение проблем](/ru/learn/use-claude-api-with-vercel-ai-sdk/)[Используйте Factory Droid с Claude](/ru/learn/use-claude-api-with-factory-droid/)[Как устроен API Claude Code](/ru/learn/claude-code-api/)[Интеграция API Claude в ваше приложение](/ru/learn/claude-api-integration/)[Как пользоваться Claude без ограничений — и почему «взломанного Claude Code» не существует](/ru/learn/get-unlimited-claude-usage/)