Подключение Codex

Codex — это AI-ассистент для кода, который работает в терминале. Поддерживает множество провайдеров через единую конфигурацию TOML.

Вы можете подключить NormaHub как провайдера и использовать GPT модели (кроме Claude) прямо в Codex.

Создайте API-ключ в личном кабинете NormaHub. Скопируйте ключ сразу — повторно он не показывается.

Конфигурация Codex хранится в следующих местах:

• Linux/macOS: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

Если файл не существует, создайте его вместе с директорией ~/.codex/.

Откройте или создайте файл config.toml и добавьте следующую конфигурацию:

# BEGIN NORMAHUB CODEX ROOT
model = "gpt-5.6-sol"
model_provider = "normahub"
model_catalog_json = "/home/user/.codex/normahub-models.json"
# END NORMAHUB CODEX ROOT

# BEGIN NORMAHUB CODEX PROVIDER
[model_providers.normahub]
name = "NormaHub"
base_url = "https://api.normahub.cc/v1"
wire_api = "responses"
experimental_bearer_token = "ваш_api_ключ"
# END NORMAHUB CODEX PROVIDER

Замените ваш_api_ключ на реальный ключ из личного кабинета.

Объяснение параметров:

• model — модель по умолчанию
• model_provider — идентификатор провайдера
• model_catalog_json — путь к файлу с каталогом моделей
• base_url — адрес NormaHub API
• wire_api — формат API (responses для NormaHub)
• experimental_bearer_token — ваш API-ключ

Создайте файл ~/.codex/normahub-models.json с доступными моделями:

{
  "models": [
    {
      "slug": "gpt-5.6-sol",
      "display_name": "GPT 5.6 Sol",
      "description": "Available through NormaHub",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {"effort": "low", "description": "Faster responses"},
        {"effort": "medium", "description": "Balanced reasoning"},
        {"effort": "high", "description": "Deeper reasoning"}
      ],
      "shell_type": "unified_exec",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 1,
      "context_window": 200000,
      "max_context_window": 200000
    },
    {
      "slug": "gpt-5.5-mini",
      "display_name": "GPT 5.5 Mini",
      "description": "Available through NormaHub",
      "default_reasoning_level": "medium",
      "context_window": 128000,
      "max_context_window": 128000
    }
  ]
}

Добавьте модели из каталога моделей, которые хотите использовать. Обратите внимание: Codex не поддерживает Claude модели — используйте для них Claude Code.

После сохранения конфигурации полностью перезапустите Codex. Теперь вы можете выбирать модели NormaHub через интерфейс.

Запустите Codex, выберите модель NormaHub и отправьте тестовый запрос. Если всё настроено правильно, вы получите ответ от выбранной модели.

Если не хотите настраивать вручную, используйте готовый скрипт установки из GitHub репозитория. Скрипт автоматически загружает список моделей и создаёт конфигурацию.

• 401 Unauthorized — неверный или отозванный API-ключ
• 402 Payment Required — недостаточный баланс
• 403 Forbidden — модель не доступна для вашего ключа
• 429 Too Many Requests — превышен rate limit или spend limit
• 503 Service Unavailable — провайдер модели временно недоступен

При возникновении ошибок проверьте баланс и доступные модели в личном кабинете.

Codex через NormaHub поддерживает GPT модели:

• GPT-5.6 Sol — флагманская модель с расширенным контекстом
• GPT-5.5 Mini — быстрая и экономичная модель
• Другие GPT модели из каталога NormaHub

Для моделей Claude используйте Claude Code вместо Codex.