Используйте Factory Droid с Claude

Droid от Factory — агентный CLI того же класса, что и Claude Code, который позволяет подключать собственные модели через файл конфигурации. Если направить его на шлюз AI Prime Tech, агентные циклы Droid будут выполняться на Claude наряду с любыми другими моделями, доступными через шлюз.

Отредактируйте файл настроек

Droid читает ~/.factory/settings.json. Добавьте массив customModels, в котором каждая запись описывает одну модель, которую вы хотите сделать доступной. Это актуальный путь к конфигурации; прежний config.json устарел и поддерживает не все возможности settings.json.

Один файл содержит все настройки Droid, поэтому единый список customModels определяет все модели, между которыми CLI может переключаться. Храните его на уровне пользователя, а не отдельных проектов.

Знание того, что settings.json — актуальный файл, помогает избежать путаницы: старые заметки и обсуждения всё ещё ссылаются на config.json, а некоторые функции в этих файлах работают по-разному. Если что-то работает в одном файле и не работает в другом, почти всегда стоит ориентироваться на settings.json. Если рекомендации противоречат друг другу, выбор settings.json вместо config.json разрешает большинство разногласий. Именно новый файл активно поддерживается Factory, и именно в нём работает синтаксис переменных.

Опишите модель

Каждая запись customModels содержит идентификатор модели, baseUrl, apiKey, provider и maxOutputTokens. Задайте в model идентификатор модели на шлюзе, например claude-sonnet-4-5, а в baseUrl — адрес шлюза.

Вместе эти поля точно указывают Droid, как обращаться к модели. Поскольку Droid не привязан к одному провайдеру, вы явно задаёте каждый параметр, и именно это позволяет гибко настроить подключение к шлюзу.

Такая явная настройка позволяет подключить к одному экземпляру Droid несколько моделей Claude на одном шлюзе: каждой соответствует отдельная запись customModels с общими baseUrl и ключом. CLI считает их отдельными моделями, доступными для выбора, хотя все они обращаются к одной конечной точке на стороне шлюза. Именно явное указание полей позволяет одному экземпляру работать с несколькими моделями Claude через одну конечную точку. Все записи используют общие baseUrl и ключ, но у каждой свой идентификатор модели, поэтому маршрутизацию выполняет шлюз, а Droid лишь выбирает имя.

Выберите режим провайдера

Поле provider задаёт формат обмена данными. Используйте anthropic для нативного интерфейса Messages шлюза, openai для формата Responses или generic-chat-completion-api для конечной точки чата /v1 в формате OpenAI. Для Claude на шлюзе естественный выбор — anthropic.

Соответствие provider фактическому интерфейсу шлюза помогает избежать ошибок при первом запуске. С provider anthropic Droid использует нативный формат, который шлюз предоставляет для Claude.

Три режима провайдера также хорошо соответствуют интерфейсам, которые может предоставлять многомодельный шлюз. Поэтому, если тот же шлюз обслуживает модель в формате OpenAI, добавьте её отдельной записью с generic-chat-completion-api. Соответствие provider каждой записи её интерфейсу — правило, которое позволяет смешанной конфигурации работать без ошибок. Согласование provider с интерфейсом в каждой записи позволяет поддерживать корректную смешанную конфигурацию шлюза. Запись для нативного интерфейса Claude и запись в формате OpenAI могут без проблем сосуществовать.

Настройте ключ API

Укажите ключ в apiKey, желательно в виде ссылки ${VAR}, например ${AIPRIME_API_KEY}, чтобы секрет хранился в окружении, а не в файле. Учтите, что подстановка ${VAR} работает в settings.json, но не в устаревшем config.json.

Поле apiKey также не должно быть пустым, даже если шлюз технически принимает анонимные запросы. Droid проверяет наличие значения в этом поле, поэтому всегда указывайте ключ или переменную, в которой он хранится.

Эти два факта объясняют распространённую ошибку: пользователи помещают ${VAR} в старый config.json, где подстановка не выполняется, и Droid видит буквальную строку с неразрешённой переменной. Для записи через переменную используйте settings.json и убедитесь, что переменная действительно экспортирована в оболочке, из которой запускается Droid. Проверка экспорта переменной в запускающей оболочке — последний шаг, о котором часто забывают. Droid видит только переменные, присутствующие в окружении, из которого он был запущен.

Переключитесь и запустите

В Droid CLI переключайтесь между настроенными моделями с помощью команды /model. Добавьте вторую запись для claude-opus-4-8, и вы сможете переключаться на неё для более сложных задач, больше не меняя конфигурацию.

После этого Droid выполняет свой агентный цикл на Claude через шлюз. Поскольку настройки хранятся в settings.json, одна и та же конфигурация применяется при каждом запуске CLI.

Готовые записи для Sonnet и Opus позволяют на ходу выбирать модель под задачу: Sonnet для повседневной реализации, Opus для задач, требующих более сложных рассуждений, — и всё это через шлюз без перенастройки. Команда /model позволяет сделать это одной строкой прямо во время сеанса. Именно переключение одной строкой через /model в ходе сеанса делает подбор модели под задачу столь простым. Вы переходите с Sonnet на Opus, не покидая сеанс.

// ~/.factory/settings.json
{
  "customModels": [
    {
      "model": "claude-sonnet-4-5",
      "baseUrl": "https://aiprimetech.io",
      "apiKey": "${AIPRIME_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    }
  ]
}
// export AIPRIME_API_KEY=<key>   (apiKey must NOT be empty)
// Switch models in the CLI with /model

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.