Объявление: Новинка Kling 4.0: генерация видео по тексту и по изображению со скидкой 20% на ограниченное время, Попробовать сейчас
HiAPI
Ru
Руководства
Инструменты агентов

Быстрое подключение

Настройка по API KeyMCP в один клик

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

Получение API-ключаBase URL и протоколыУстановка Node.jsУстановка CC Switch и импорт в один кликЧастые ошибки

Командная строка

Claude CodeCodex CLIOpenCodeOpenClawHermesPi

Настольные и веб-приложения

Claude DesktopCodex DesktopCherry StudioTraeWorkBuddyDeepSeek Harness
На этой странице

Codex Desktop

Пользуйтесь только графическим интерфейсом и импортируйте конфигурацию через CC Switch, чтобы использовать модели GPT в Codex Desktop через HiAPI.

Codex Desktop может подключаться к HiAPI через импорт в один клик в CC Switch. В шагах ниже в качестве примера используется gpt-6-astra; HiAPI использует протокол OpenAI Responses. Всё выполняется в графическом интерфейсе — без установки Node.js, без команд и без правки файлов конфигурации.

1. Установите Codex Desktop

  1. Откройте официальную страницу начала работы с настольным приложением OpenAI и выберите загрузку Desktop app. На Mac можно использовать официальный Codex.dmg; требования к системе и процессору с официальной страницы сохраняются.

  2. Откройте Finder → Downloads, дважды щёлкните .dmg и перетащите приложение в папку Applications. После копирования откройте его из Applications; когда система спросит, проверьте, что источник официальный, и нажмите Open.

  3. Если при первом запуске приложение останавливается на странице входа, не закрывайте её и продолжайте установку CC Switch, импорт и включение HiAPI. Входить в ChatGPT, чтобы потом выйти, не нужно.

Windows: выберите на официальной странице установщик для Windows, завершите установку и откройте приложение из меню «Пуск»; не используйте DMG для Mac.

2. Установите и откройте CC Switch

Скачайте, установите и откройте CC Switch, как описано в разделе Установка CC Switch и импорт в один клик; если он уже установлен, просто откройте его.

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

3. Выберите API-ключ HiAPI

Выберите или создайте ключ, как описано в разделе Получение API-ключа, и запишите его название. Копировать ключ здесь не нужно: импорт перенесёт его сам.

4. Подготовьте импорт в один клик в браузере

  1. Откройте страницу подключения Codex в HiAPI и выберите API Key setup → Codex → Desktop → gpt-6-astra → macOS. В Windows выберите в качестве системы Windows.

Точка входа для импорта на странице подключения

① Выберите API Key setup; ② выберите Codex; ③ выберите Desktop; ④ выберите gpt-6-astra; ⑤ выберите macOS как систему (в Windows вместо неё выберите Windows); ⑥ нажмите Import to CC Switch.

  1. Нажмите Import to CC Switch, выберите в выпадающем списке API Key название ключа, которое записали ранее, и убедитесь, что внизу указано Responses API · https://api.hiapi.ai/v1.
  2. Нажмите Prepare import, затем Open CC Switch; разрешите открытие, когда браузер спросит.

Скриншоты каждого шага есть в разделе Подготовка импорта на странице подключения.

5. Подтвердите импорт в CC Switch

В окне «Confirm provider import» проверьте пункты ниже, оставьте Switch to this provider immediately after import выключенным, затем нажмите Import:

ПолеОжидаемое значение
App typeCodex
Provider nameHiAPI - gpt-6-astra
API endpointhttps://api.hiapi.ai/v1
Modelgpt-6-astra
API keyЗаполнен и скрыт

Вернувшись на страницу Codex в CC Switch, вы увидите карточку HiAPI - gpt-6-astra: значит, импорт прошёл (провайдер ещё не включён). См. скриншоты в разделе Подтверждение импорта в CC Switch.

6. Включите HiAPI

  1. Сначала дождитесь завершения задачи, которую выполняет Codex. На странице Codex → Direct в CC Switch нажмите кнопку Switch / Enable на карточке HiAPI - gpt-6-astra; HiAPI считается включённым только тогда, когда на карточке стоит пометка «In use». См. скриншоты в разделе Включение HiAPI.
  2. Полностью закройте и снова откройте Codex, чтобы новая конфигурация вступила в силу. CLI и Desktop могут использовать общую локальную конфигурацию Codex; чтобы позже вернуться к исходному провайдеру, переключитесь здесь на его карточку и откройте клиент заново.

7. Откройте клиент заново и при необходимости войдите

  1. Дождитесь завершения выполняемой задачи, затем на Mac нажмите Quit в меню приложения или ⌘Q и снова откройте приложение из Applications. Закрытия окна недостаточно для выхода; в Windows также выйдите через меню приложения и откройте его заново из меню «Пуск».

  2. Если сразу открылся основной интерфейс, переходите к следующему шагу. Если появился вход по API-ключу, нажмите Sign in another way, затем откройте HiAPI Console → API Keys, найдите выбранный ранее ключ, нажмите значок копирования рядом с ним и скопируйте полный API-ключ HiAPI.

  3. Вернувшись в клиент, вставьте API-ключ HiAPI в поле ввода API Key и нажмите Continue. Не вставляйте его в поле ввода чата и не копируйте название или замаскированное отображаемое значение. Формулировки могут отличаться между версиями; ориентируйтесь на вход по API-ключу, и редактировать файлы конфигурации не нужно.

8. Откройте локальную папку, выберите модель и начните работу

  1. На Mac нажмите Go → Home в меню Finder, нажмите ⌘⇧N, создайте папку с именем hiapi-project и нажмите Enter для подтверждения; можно также использовать существующую папку проекта.

    В Windows откройте свой пользовательский каталог в Проводнике, щёлкните правой кнопкой по свободному месту, выберите New → Folder и назовите её hiapi-project.

  2. В клиенте нажмите New chat / New task, введите Codex и выберите режим работы Local. Нажмите Open / Add folder; в окне выбора файлов на Mac можно нажать ⌘⇧G, ввести ~/hiapi-project, нажать Enter и нажать Open / Select folder; в Windows выберите только что созданную папку.

  3. Начните новый чат в этой папке, откройте выбор модели рядом с полем ввода и выберите GPT-6 Astra / gpt-6-astra. В разных версиях Codex может находиться в меню продуктов или в отдельной области проекта; главное, чтобы режим был локальным, а папка и модель — правильными.

  4. Оставьте права по умолчанию с подтверждением перед выполнением. Отправьте «Привет, представься одним предложением.» Нормальный ответ означает, что подключение работает. Если в Журнале запросов в консоли HiAPI виден этот запрос, значит, он идёт через HiAPI. После этого просто пишите задачу, которую нужно выполнить.

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

Здесь перечислены только проблемы, характерные для Codex Desktop. Об ошибках 401, 404, 429 и других распространённых см. Частые ошибки.

СимптомПричинаКак исправить
После повторного открытия всё ещё на странице входа ChatGPTНастольное приложение требует входа по API-ключуНажмите Sign in another way и вставьте API-ключ HiAPI, см. шаг 7
В списке моделей нет gpt-6-astraКарточка HiAPI не включена или клиент не был полностью закрытНа странице Codex в CC Switch убедитесь, что на карточке HiAPI стоит пометка «In use», затем нажмите ⌘Q для полного выхода и откройте снова
Изменился и Codex в командной строкеОба используют общую локальную конфигурацию CodexЭто ожидаемо; чтобы вернуться к исходному провайдеру, переключитесь на его карточку в CC Switch