Подготовка
- Создайте API Key в группе с текстовой моделью, поддерживающей Responses. Проверьте доступный баланс или квоту.
- Подготовьте папку проекта, которую разрешаете читать Codex. Для первой проверки можно использовать пустую папку.
- Для установки через npm нужны поддерживаемые версии Node.js и npm. Другие способы описаны в официальной инструкции Codex.
Настройка Codex
1
Установите и проверьте команду
Выполните в терминале:Продолжайте, когда появится номер версии. Если команда не найдена, откройте терминал заново и проверьте, включена ли папка глобальных команд npm в
PATH.2
Подготовьте ключ и ID модели
Войдите на aibal.ai, откройте Использовать ключ в списке API-ключей и выберите Codex. Скопируйте ID текстовой модели, поддерживаемой текущей группой. Значение
YOUR_AVAILABLE_MODEL_ID ниже — заполнитель, его необходимо заменить.3
Отредактируйте пользовательский config.toml
Откройте Поля верхнего уровня
~/.codex/config.toml, а в Windows — %USERPROFILE%\.codex\config.toml. Если задан CODEX_HOME, используйте файл из этого каталога. Если файла нет, создайте каталог и файл; если есть, сначала сохраните резервную копию и объедините следующие поля с существующими настройками.model_provider и model должны находиться перед первой секцией [таблица]. Не дублируйте существующие поля или [model_providers.aibal]. Сохраните остальные настройки. Конфигурацию провайдера размещайте в пользовательском файле, а не в .codex/config.toml внутри проекта.4
Задайте ключ в терминале запуска
Используйте скрытый ввод, чтобы ключ не попал в историю команд. В Bash или Zsh выполните команду и вставьте ключ по запросу; символы не будут отображаться:В Windows PowerShell:Переменная действует только в этом терминале и запущенных из него процессах. После закрытия терминала задайте её повторно или используйте доверенный менеджер секретов. Не сохраняйте настоящий ключ в файлах проекта.
5
Начните новый сеанс и проверьте подключение
Выполните После нормального ответа проверьте время, ключ и модель в разделе История использования aibal.ai. Тестовый запрос может тарифицироваться.
codex в подготовленной папке проекта. Подтвердите область доверия к проекту, затем отправьте:Поля конфигурации
Если панель предлагает файл каталога моделей или специальный адрес группы, сохраните файл по инструкции Использовать ключ и укажите предоставленные путь и ID модели. Не смешивайте конфигурации разных групп.
Частые вопросы
Переменная AIBAL_API_KEY не найдена
Запуститеcodex из терминала, в котором задали переменную. Программы, открытые из Dock, меню «Пуск» или другого терминала, могут не унаследовать её. Это руководство для CLI; настольному приложению может потребоваться отдельная настройка.
Всё ещё появляется вход через ChatGPT или используется другой провайдер
Проверьте, чтоmodel_provider = "aibal" находится на верхнем уровне, пользовательский файл применяется и другой менеджер конфигураций не перезаписал настройки. Не объединяйте этот способ с env_key и способ через auth.json из другого руководства.
Модель не найдена или запрос завершается ошибкой
Замените заполнитель на ID модели, доступной ключу. Проверьте поддержку Responses, отсутствие повторного/v1 в адресе и квоту ключа. Другие ошибки описаны в обзоре интеграции.
Старый сеанс не применяет новые настройки
Завершите старый процесс Codex и запустите его снова из настроенного терминала. Если используете CC Switch, в дальнейшем редактируйте того же провайдера в нём, чтобы ручные настройки и управляемая конфигурация не перезаписывали друг друга.Можно ли создавать изображения непосредственно в Codex?
Доступ к текстовой модели не означает, что встроенный инструмент изображений автоматически использует этот шлюз. Если клиент поддерживает исполнитель генерации изображений, следуйте инструкции Codex для изображений: выберите в панели API Key Mode, сохраните всю соответствующую конфигурацию и перезапустите клиент. Не смешивайте эту конфигурацию с фрагментомenv_key из данной страницы. Также можно явно вызвать API изображений и сохранить результат по тому же руководству. Доступность инструмента зависит от клиента и группы. Для видео см. генерацию видео.