КАК ПОДКЛЮЧИТЬ POSITIONAPI К CODEX НА WINDOWS Вам нужны установленный Codex и ваш API-ключ с https://positionapi.top/dashboard/keys. Подписка PositionAPI оплачивает запросы через PositionAPI в пределах её лимитов. Она не активирует подписку ChatGPT или OpenAI. АВТОМАТИЧЕСКАЯ НАСТРОЙКА CODEX DESKTOP (WINDOWS) 1) Установите актуальный Codex Desktop и откройте его хотя бы один раз. 2) Полностью закройте Codex Desktop. 3) Скачайте файл: https://positionapi.top/downloads/positionapi-codex-desktop.bat 4) Запустите BAT двойным щелчком от обычного пользователя. 5) Вставьте ВАШ ключ PositionAPI и нажмите Enter. Ввод скрыт. 6) Дождитесь сообщения «ГОТОВО» и откройте Codex Desktop заново. 7) Создайте НОВУЮ локальную задачу. Напишите: «Ответь одним словом: работает». Если приложение пишет Missing POSITION_API_KEY, перезагрузите Windows один раз. BAT выбирает GPT-6 Astra, прописывает адрес PositionAPI и отключает встроенный поиск OpenAI. Остальные настройки сохраняются. Программы не устанавливаются, права администратора не требуются. Проверка ключа не запускает платную генерацию. Ключ сохраняется в переменной пользователя Windows POSITION_API_KEY. Резервная копия: config.before-positionapi-ДАТА-ВРЕМЯ-СУФФИКС.toml рядом с config.toml. Для возврата закройте Codex и скопируйте этот резервный файл поверх config.toml. Не отправляйте резервную копию другим людям: в старых настройках могут быть секреты. Если BAT успешно отработал, вручную выполнять шаги ниже НЕ НУЖНО. Ниже — ручной способ настройки с моделью GPT-5.6 Sol. ПОЧЕМУ СЕЙЧАС ОШИБКА 401 На экране «Войти в ChatGPT → API-ключ OpenAI» ожидается официальный ключ OpenAI. У ключа PositionAPI другой сервер. Поэтому одного вставленного ключа недостаточно. Поля Base URL на этом экране нет: адрес задаётся в файле настроек Codex. ШАГ 1. СОЗДАЙТЕ СВОЙ КЛЮЧ 1) Откройте https://positionapi.top/dashboard/keys под своим аккаунтом. 2) Нажмите «Создать ключ», задайте название, например Codex. 3) Скопируйте ключ целиком. Не присылайте его продавцу и не публикуйте скриншоты с ним. Если ключ уже есть и он активен, используйте его. ШАГ 2. СОХРАНИТЕ КЛЮЧ В ПЕРЕМЕННОЙ WINDOWS 1) Нажмите Win + R, введите SystemPropertiesAdvanced и нажмите Enter. 2) Нажмите «Переменные среды…». 3) В ВЕРХНЕМ блоке «Переменные среды пользователя» нажмите «Создать…». Если POSITION_API_KEY уже существует, выберите её и нажмите «Изменить…». 4) Имя переменной: POSITION_API_KEY 5) Значение переменной: вставьте ваш настоящий ключ из шага 1. Кавычки, слово Bearer и дополнительные пробелы не нужны. 6) Закройте все окна кнопками OK. ШАГ 3. ОТКРОЙТЕ ЛИЧНЫЙ ФАЙЛ НАСТРОЕК CODEX 1) Закройте Codex полностью, включая его значок в области уведомлений, если он есть. 2) Нажмите Win + R и откройте: %USERPROFILE%\.codex 3) Найдите config.toml. Сделайте его копию, например config.before-positionapi.toml. 4) Откройте config.toml в Блокноте. Если папки или файла нет, создайте их. В Блокноте выберите «Сохранить как», тип файла «Все файлы», имя config.toml, кодировку UTF-8. Проверьте, что файл не называется config.toml.txt. Нужна папка в профиле Windows, а не .codex внутри какого-либо проекта. Если вы сами задавали CODEX_HOME, используйте эту папку. ШАГ 4. ДОБАВЬТЕ НАСТРОЙКИ Если файл пустой, вставьте весь блок ниже. Если настройки уже есть, сохраните остальные разделы: - замените существующие model, model_provider и web_search в НАЧАЛЕ файла; - если этих строк нет, добавьте их в начало, ДО первого раздела в [квадратных скобках]; - раздел [model_providers.positionapi] добавьте в конец; - если такой раздел уже есть, обновите его, не создавайте второй с тем же именем. Нельзя дважды объявлять одну настройку или один и тот же раздел TOML. ----- НАЧАЛО НАСТРОЕК (эту строку не копировать) ----- model = "gpt-5.6-sol" model_provider = "positionapi" web_search = "disabled" [model_providers.positionapi] name = "PositionAPI" base_url = "https://positionapi.top/v1" env_key = "POSITION_API_KEY" wire_api = "responses" requires_openai_auth = false supports_websockets = false ----- КОНЕЦ НАСТРОЕК (эту строку не копировать) ----- Сохраните файл. Ключ в config.toml вставлять не нужно: Codex прочитает его из переменной POSITION_API_KEY. Не заменяйте env_key самим ключом. ШАГ 5. ПЕРЕЗАПУСТИТЕ И ПРОВЕРЬТЕ 1) Перезагрузите Windows, чтобы Codex точно получил новую переменную среды. 2) Откройте Codex и создайте НОВУЮ локальную задачу. Старая задача может сохранять прежний провайдер или настройки модели. 3) Напишите: «Ответь одним словом: работает». 4) Откройте https://positionapi.top/dashboard/logs и проверьте журнал запросов. Для Codex CLI: после перезапуска терминала запустите codex. Конфигурация предназначена для локального приложения и CLI, не для облачных задач ChatGPT. ЕСЛИ НЕ ПОЛУЧИЛОСЬ Ошибка содержит api.openai.com/v1/responses: Codex всё ещё использует OpenAI. Проверьте model_provider = "positionapi" именно в начале личного config.toml. Проверьте отсутствие переопределения провайдера профилем или параметрами запуска. Закройте Codex и создайте новую задачу. Missing environment variable / POSITION_API_KEY не найдена: Проверьте имя переменной, наличие значения и перезагрузите Windows. 401 от positionapi.top: Проверьте ключ в личном кабинете и переменную POSITION_API_KEY: без кавычек, пробелов и Bearer. Используется ключ PositionAPI, не ключ поставщика модели. Ошибка разбора config.toml / duplicate key / duplicate table: В файле дважды объявлено одно поле или раздел. Сравните с шагом 4. Если строка model_provider оказалась внутри чужого раздела, перенесите её в начало. Окно входа OpenAI продолжает появляться: Проверьте, что config.toml не получил расширение .txt, находится в личной папке .codex и содержит requires_openai_auth = false в разделе PositionAPI. Обновите Codex, если установленная версия не поддерживает пользовательские провайдеры. Не вводите ключ PositionAPI в официальный вход OpenAI. 402: недостаточно баланса для запроса вне действующего лимита подписки. 403: ключ отключён, истёк или имеет ограничения на модель, квоту либо IP. 429: лимит подписки, частоты запросов или ограничение поставщика модели. 502/503/504: проблема доступности модели/канала. Это не ошибка вашей установки. 501 на /v1/responses: сервер ещё не обновлён для Codex. Сообщите продавцу. Адрес https://positionapi.top/v1 в браузере может показывать 404 — это не страница. Codex сам добавляет /responses к Base URL и отправляет POST-запрос с ключом. Не дописывайте /responses в base_url самостоятельно. ОГРАНИЧЕНИЯ Используются текстовые запросы, потоковые ответы и инструменты, выполняемые вашим локальным Codex. Доступность зависит от выбранной модели и канала. Встроенный поиск OpenAI отключён. Хранение Responses на сервере, запросы по previous_response_id, фоновые Responses и WebSocket-подключение не поддерживаются. Подписка имеет лимиты; её нельзя считать безлимитной. КАК ВЕРНУТЬ ПРЕЖНИЕ НАСТРОЙКИ Полностью закройте Codex. Восстановите содержимое config.toml из своей копии config.before-positionapi.toml, затем запустите Codex заново. Если нужна помощь, отправьте только текст ошибки без ключа и уточните: Windows, версия Codex, локальное приложение или терминал. Документация PositionAPI: https://positionapi.top/docs#codex Настройка провайдеров Codex: https://learn.chatgpt.com/docs/config-file/config-advanced