Codex

Как подключить Codex к Флоктору: установка, config.toml с base_url и wire_api, ключ в auth.json и решение частых ошибок.

Codex обращается к OpenAI-совместимому API Флоктора. Настройка занимает два файла: в одном адрес и модель, в другом ключ.

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

Способ установки выберите в официальном руководстве.

Для Visual Studio Code есть официальное расширение.

Шаг 2. Пропишите настройки

Откройте файл ~/.codex/config.toml, а если его нет — создайте:

macOS и Linux: выполните mkdir -p ~/.codex и откройте эту папку.
Windows: нажмите Win + R, введите %userprofile%\.codex и создайте там файл config.toml.

Содержимое:

#:schema https://developers.openai.com/codex/config-schema.json
model_provider = "custom"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.custom]
name = "FLOCTOR API"
base_url = "https://api.floctor.com/v1"
wire_api = "responses"
requires_openai_auth = true

В отличие от Claude Code, у Codex base_url должен заканчиваться на /v1: сам он версию не дописывает. Параметр wire_api обязан быть "responses" — это единственный формат, который принимает наша сторона.

Шаг 3. Положите ключ

Ключ хранится отдельно от настроек, в файле ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "flk_••••••••••••••••"
}

Вместо flk_•••••••••••••••• подставьте свой ключ. В config.toml ключу делать нечего: этот файл люди пересылают друг другу и кладут в репозитории.

Шаг 4. Проверьте подключение

Перезапустите терминал и запустите Codex в любом проекте:

codex

Если диалог отвечает, всё настроено. Запросы появятся в статистике ключа в личном кабинете.

Что делать, если не работает

401, Unauthorized. Ключ не принят. Проверьте, что он скопирован целиком и лежит именно в auth.json, а не в config.toml.

404, model not found. Такой модели нет. Сверьтесь со списком в личном кабинете, см. «Модели».

Обрывы потока, таймауты. Сначала проверьте своё соединение. Если оно в порядке, причиной может быть нагрузка — на стороне модели или на нашей. Если повторяется, напишите в поддержку.

Полный разбор кодов ошибок — в разделе «Ошибки».

Полезные ссылки

Базовая настройка Codex — где лежат config.toml и auth.json и какие ещё параметры бывают.