Facade Code Документация
Настройка агентов

Codex и ваш провайдер

Укажите отдельного провайдера моделей для конфигурации запуска Codex или используйте профиль, уже настроенный в самом Codex.

Получите данные провайдера

Установите Codex и получите у провайдера базовый URL, API-ключ и идентификатор модели. Эндпоинт должен поддерживать OpenAI Responses API; совместимости с Chat Completions недостаточно.

Пример добавляет Codex · work, не меняя другие записи Codex и не редактируя глобальную конфигурацию Codex.

У вас уже есть профиль Codex? Переходите к разделу Использование существующего профиля Codex.

1. Опишите провайдера

Добавьте эту конфигурацию в facade.json (см. Настройки агентов). Замените примерные базовый URL, ключ и идентификатор модели:

facade.json
{
  "clis": {
    "Codex · work": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "args": [
        "-c",
        "model_provider=work",
        "-c",
        "model_providers.work.name=Work",
        "-c",
        "model_providers.work.base_url=https://api.example.com/v1",
        "-c",
        "model_providers.work.wire_api=responses",
        "-c",
        "model_providers.work.env_key=WORK_API_KEY"
      ],
      "env": {
        "WORK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Используйте один и тот же ID провайдера, work, в model_provider=work и во всех настройках model_providers.work.…. Имя переменной с ключом, WORK_API_KEY, должно совпадать с env_key.

2. Проверьте настройки провайдера

ПараметрЧто он делает
model_provider=workВыбирает провайдера, заданного настройками work.
model_providers.work.nameЗадаёт отображаемое имя провайдера.
model_providers.work.base_urlЗадаёт базовый URL API.
model_providers.work.wire_api=responsesИспользует формат Responses API.
model_providers.work.env_key=WORK_API_KEYУказывает Codex, в какой переменной среды хранится ключ.
env.WORK_API_KEYПередаёт этот ключ процессу Codex.

Каждый параметр -c задаёт одну опцию Codex для агентов, запущенных с этой записью.

В примере ключ хранится в facade.json. Если ключ уже есть в переменной среды, задайте для env.WORK_API_KEY значение ${env:WORK_API_KEY}. К моменту запуска агента эта переменная должна быть доступна редактору.

3. Запустите Codex с этой конфигурацией

Сохраните facade.json, выберите New Agent и укажите Codex · work. Проверьте выбранную модель командой /model, затем отправьте короткую задачу по проекту.

Если провайдер показывает статистику использования, убедитесь, что запрос относится к нужному аккаунту. Чтобы проверить конфигурацию запуска, выполните Show Agent Launch и выберите рабочее расположение. Найдите эту запись в отчёте, чтобы увидеть, как следующий агент запустится с текущими настройками.

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

Пример: QwenCloud

Для ключа QwenCloud Token Plan используйте базовый URL https://token-plan.maas.qwencloudapi.com/compatible-mode/v1 и оставьте wire_api=responses. Используйте модель, доступную в вашем тарифе. Для ключей с оплатой по мере использования нужен эндпоинт соответствующего региона.

Актуальные настройки Codex в QwenCloud ↗

Использование существующего профиля Codex

Если вы уже пользуетесь профилем Codex, выберите его через аргументы записи:

facade.json
{
  "clis": {
    "Codex · profile": {
      "type": "codex",
      "args": [
        "--profile",
        "work"
      ]
    }
  }
}

Замените work на имя своего профиля. Настройки провайдера оставьте в этом профиле, а не дублируйте их в записи Facade. Сохраните файл, выберите New Agent и укажите Codex · profile. Отправьте короткую задачу и, если провайдер показывает статистику использования, убедитесь, что запрос там отображается.

Открыть как Markdown ↗Документация

Поиск по документации

Поиск по этому руководству. ↑ ↓ — перемещение, Enter — открыть, Esc — закрыть.