> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routify.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

## Что такое Codex?

Codex — агентная система для разработки, которая умеет планировать, писать и запускать код в длительных задачах. Она интегрируется с OpenAI‑совместимыми API, поэтому вы можете направить Codex на Routify и использовать Codex‑модели через единый шлюз.

## Настройка

### Рекомендуемый способ: OpenAI‑совместимые переменные окружения

Самый простой способ — задать стандартные OpenAI‑совместимые переменные окружения:

```bash theme={null}
export OPENAI_API_KEY="$ROUTIFY_API_KEY"
export OPENAI_BASE_URL="https://api.routify.ru/v1"
```

Это рекомендуемый вариант для новых пользователей и минимум конфигурации.

### Быстрый старт (CLI)

После настройки переменных запустите Codex как обычно:

```bash theme={null}
codex
```

Codex будет отправлять запросы через Routify, используя заданные base URL и ключ.

## Ручная настройка

<Warning>
  **Только для опытных пользователей:** ручная настройка нужна, если вы хотите явно задать модель или другие параметры.
</Warning>

### Шаг 1: получите API‑ключ Routify

1. Зарегистрируйтесь или войдите на [routify.ru](https://routify.ru/auth)
2. Создайте новый API‑ключ
3. Скопируйте ключ (начинается с `sk-...`)

### Шаг 2: задайте API‑ключ

Сохраните ключ в переменную окружения:

```bash theme={null}
export ROUTIFY_API_KEY="sk-..."
```

Затем убедитесь, что Codex использует его через OpenAI‑совместимые переменные:

```bash theme={null}
export OPENAI_API_KEY="$ROUTIFY_API_KEY"
export OPENAI_BASE_URL="https://api.routify.ru/v1"
```

<Note>
  Routify совместим с OpenAI. Можно использовать любой OpenAI‑совместимый клиент.
</Note>

### Шаг 3: выберите модель

Выберите ID модели из каталога Routify. Популярные варианты для Codex:

**Codex Mini (быстро и экономично):**

```
openai/gpt-5.1-codex-mini
```

**Codex (сбалансировано):**

```
openai/gpt-5.1-codex
```

**Codex Max (максимальная мощность):**

```
openai/gpt-5.1-codex-max
```

Полный список моделей — на [routify.ru/models](https://routify.ru/models).

### Шаг 4: запустите Codex

Запустите Codex и начните сессию:

```bash theme={null}
codex
```

Теперь Codex будет использовать Routify для маршрутизации запросов к выбранной модели.

## Формат модели

ID моделей Routify обычно имеют формат `<provider>/<model>`, например:

* `openai/gpt-5.1-codex-mini`
* `openai/gpt-5.1-codex`
* `openai/gpt-5.1-codex-max`

Точные ID смотрите в каталоге Routify.

## Надёжность и failover

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

## Частые ошибки

### "No API key found"

Codex не находит ваш ключ Routify.

**Решение:**

1. Проверьте `ROUTIFY_API_KEY` и `OPENAI_API_KEY`: `echo $ROUTIFY_API_KEY`
2. Убедитесь, что `OPENAI_BASE_URL` равен `https://api.routify.ru/v1`
3. Перезапустите терминал и снова выполните `codex`

### Ошибки аутентификации (401/403)

Если возникают ошибки аутентификации:

**Решение:**

1. Проверьте валидность ключа на [routify.ru](https://routify.ru/auth)
2. Убедитесь, что на балансе есть средства
3. Проверьте, что ключ не отозван

### Модель не работает

Если конкретная модель не работает:

**Решение:**

1. Проверьте ID модели в каталоге Routify
2. Используйте формат `<provider>/<model>` (например, `openai/gpt-5.1-codex-mini`)
3. Попробуйте другую Codex‑модель

## Ресурсы

* [Модели Routify](https://routify.ru/models)
* [Routify API](https://api.routify.ru)