как настроить API в Cockpit Tools

Cockpit Tools управляет профилями Codex. Чтобы Codex действительно использовал API 穷哥么, выполните цепочку: добавить поставщика → привязать к экземпляру → включить и запустить.

Краткая настройка

Путь
Страница Codex → вкладка поставщиков моделей → новый пользовательский поставщик
Base URL
https://qionggeme.com/v1
Не используйте адрес сайта документации или /docs
API Key
API Key из консоли 穷哥么
В документации должен быть только заполнитель, не публикуйте настоящий Key
wireApi
responses
Не выбирайте chat_completions
Модель
gpt-5.3-codex-spark
Фактический ID берите из списка моделей, доступных текущему токену
Действие для применения
Привязать поставщика → включить и запустить
Сохранение не означает переключение

Перед началом:

Эта схема позволяет Cockpit Tools управлять файлами профиля Codex auth.json и config.toml. Переключайте поставщика через интерфейс Cockpit и не редактируйте одновременно управляемые файлы вручную.

Порядок настройки

  1. Откройте вкладку поставщиков моделей Codex

    В Cockpit Tools откройте страницу Codex, перейдите на вкладку поставщиков моделей и нажмите добавление пользовательского поставщика. Не помещайте Base URL из этой инструкции в поле локального сервиса Cockpit: настраивается внешний поставщик модели.

  2. Укажите название, Base URL и API Key

    Заполните поля:

    • Название: например qionggeme-codex.
    • Base URL: https://qionggeme.com/v1.
    • API Key: вставьте собственный API Key 穷哥么 без кавычек и лишних пробелов.

    Base URL — адрес API, а не URL сайта документации; никогда не добавляйте /docs.

  3. Установите wireApi = responses и выберите модель

    В поле wireApi выберите responses. В качестве примера можно указать gpt-5.3-codex-spark. Если ID недоступен текущему токену, замените его Codex-совместимой моделью из консоли; страница цен служит ориентиром. Не выбирайте chat_completions: эта схема использует нативный Codex Responses.

  4. Сохраните поставщика

    Сохраните форму и убедитесь, что карточка появилась в списке. Сохранение только записывает данные поставщика в Cockpit и не переключает на него экземпляр Codex автоматически.

  5. Вернитесь к экземпляру и привяжите поставщика

    Откройте управление экземплярами Codex, выберите нужный экземпляр и привяжите только что сохранённого поставщика. Пока связь не задана, профиль Codex не будет использовать поставщика, даже если его карточка успешно сохранена.

  6. Явно выполните «включить и запустить»

    После привязки нажмите «Включить и запустить» и проверьте состояние экземпляра. Только это действие направляет профиль Codex на выбранного поставщика: сохранение не равно переключению.

  7. Проверьте работу Codex с новым поставщиком

    Когда экземпляр запущен, запустите или перезапустите Codex из него и отправьте простой запрос. Если старый терминал или профиль работал до переключения, завершите старый процесс, чтобы он не продолжал читать прежнюю конфигурацию.

Пример конфигурации

# Cockpit Tools → Codex → поставщики моделей → новый пользовательский поставщик
Название: qionggeme-codex
Base URL: https://qionggeme.com/v1
API Key:  ваш API Key 穷哥么
wireApi:  responses
Модель:    gpt-5.3-codex-spark (или Codex-модель, видимая текущему токену)

# После сохранения обязательно
1. Вернуться к экземпляру
2. Привязать поставщика
3. Выполнить «включить и запустить»

# Важно
Сохранение не переключает экземпляр. Не редактируйте одновременно управляемые Cockpit файлы auth.json / config.toml.

Устранение неполадок

Поставщик сохранён, но Codex использует старый маршрут

Сохранение лишь записывает данные. Проверьте привязку поставщика к экземпляру, явно выполните «Включить и запустить», затем перезапустите Codex. Ориентируйтесь на состояние экземпляра, а не только на наличие карточки поставщика.

Выбран chat_completions, и Responses возвращает ошибку

Измените wireApi на responses, оставив Base URL https://qionggeme.com/v1. Схеме не нужны Chat Completions, преобразование протокола или локальный маршрут.

Поставщик есть, но не применяется к экземпляру

Проверьте отдельное действие привязки к текущему экземпляру. При смене экземпляра связь нужно проверять заново, после чего снова выполнить «включить и запустить».

Экземпляр не запускается или занят порт

Проверьте состояние и порт экземпляра Cockpit, убедитесь, что сервис запущен и порт не занят другим процессом. Сначала определите владельца порта и не завершайте процессы вслепую; после смены порта перезапустите экземпляр и повторите проверку.

Читается старый профиль или ручные изменения запутали состояние

Остановите управляемый экземпляр, проверьте привязку и состояние, затем снова выполните через Cockpit «включить и запустить». Cockpit управляет auth.json и config.toml профиля Codex и восстанавливает сохранённый профиль своим механизмом; не изменяйте эти файлы вручную во время управления.

Готовы начать?

Зарегистрируйтесь в 穷哥么, получите API Key и сразу используйте все доступные модели

Зарегистрироваться

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

Какой Base URL указывать в Cockpit Tools?

Укажите https://qionggeme.com/v1 — endpoint Codex API qionggeme. Не используйте URL сайта документации и адрес с /docs.

Почему wireApi должен быть responses?

Codex использует нативный Responses. chat_completions — другой протокол; неправильный выбор приводит к несовпадению формата или маршрута.

Сохранение поставщика уже переключает Codex?

Нет. Нужно вернуться к экземпляру, привязать поставщика, явно выполнить «включить и запустить», а затем проверить состояние и реальный запрос.

Какие файлы Codex изменяет Cockpit Tools?

Cockpit управляет auth.json и config.toml профиля Codex и при включении направляет профиль на выбранного поставщика. Для отключения используйте механизм Cockpit и не редактируйте одновременно управляемые файлы.

Обязательно ли доступна gpt-5.3-codex-spark?

Нет, это пример. Реальный ID берите из списка моделей, видимых текущему токену. Если модели нет, выберите доступную Codex-совместимую модель; страница цен показывает только основные варианты.