Source: https://aiprimetech.io/ru/learn/use-claude-api-with-factory-droid/

[Главная](/ru/) / [Обучение](/ru/learn/) / Запуск Factory Droid на Claude 

# Используйте 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
```

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

 Как запустить Factory Droid на Claude?

Добавьте запись customModels в ~/.factory/settings.json, указав provider anthropic, baseUrl https://aiprimetech.io,, идентификатор модели и apiKey. Переключайтесь с помощью /model. Какое значение provider использовать для Claude?

anthropic для нативного интерфейса Messages. openai и generic-chat-completion-api предназначены для конечных точек в формате OpenAI. Можно ли оставить apiKey пустым?

Нет — Droid требует указать значение. Используйте ссылку ${VAR}, например ${AIPRIME_API_KEY}; подстановка работает в settings.json, но не в устаревшем config.json. Как переключать модели?

Используйте команду /model в Droid CLI, чтобы переключаться между любыми записями в списке customModels.  

Начните использовать Claude за несколько минут

Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.[Получить ключ API](/register) 

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

## Другие руководства по Claude API

[Как получить ключ Claude API](/ru/learn/how-to-get-a-claude-api-key/)[Как устроены цены Claude API](/ru/learn/claude-api-pricing-explained/)[Самый дешевый способ использования API Claude](/ru/learn/cheapest-way-to-use-claude-api/)[Безлимитный Cursor с API Claude](/learn/use-claude-api-with-cursor/)[Безлимитный доступ к Claude Code](/ru/learn/use-claude-api-with-claude-code/)[Шлюз API Claude и прямой доступ к Anthropic: сравнение](/ru/learn/claude-api-vs-anthropic-direct/)[Использование Claude через API, совместимый с OpenAI](/ru/learn/openai-compatible-claude-api/)[Объяснение моделей Claude: сравнение Claude Opus, Sonnet, Haiku и Fable — все модели Claude API, названия моделей Anthropic и цены (2026)](/ru/learn/claude-api-models-compared/)[Оплата API Claude криптовалютой](/ru/learn/claude-api-with-crypto-payment/)[Доступ к API Claude без листа ожидания](/ru/learn/claude-api-without-waitlist/)[Как сократить расход токенов Claude](/ru/learn/how-to-reduce-claude-token-usage/)[Безлимитный Cline с API Claude](/ru/learn/use-claude-api-with-cline/)[Безлимитный Roo Code с API Claude](/ru/learn/use-claude-api-with-roo-code/)[Безлимитный Claude в IDE JetBrains](/ru/learn/use-claude-api-with-jetbrains/)[Aider без ограничений с Claude API](/ru/learn/use-claude-api-with-aider/)[Безлимитный Claude в VS Code](/ru/learn/use-claude-api-with-vscode/)[Конфигурация OpenCode для Claude: настройка opencode.json, модели и распространённые ошибки](/ru/learn/use-claude-api-with-opencode/)[Запуск агента Hermes без ограничений на Claude](/ru/learn/run-hermes-agent-with-claude-api/)[Запуск OpenClaw с Claude без ограничений](/ru/learn/run-openclaw-with-claude-api/)[Что означает API, совместимый с Anthropic](/ru/learn/anthropic-compatible-api/)[Ключ API Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-token](/ru/learn/claude-code-api-key-setup/)[Расходы на API Claude Code — цены и способы их снизить](/ru/learn/claude-code-api-costs/)[Объяснение ошибок API Claude: ошибка сервера 500, перегрузка 529, лимит запросов 429, некорректный запрос 400 — и исправление каждой из них](/ru/learn/claude-api-errors-troubleshooting/)[Как купить кредиты Claude API — и почему кредиты Claude лучше любого предложения «купить аккаунт Claude»](/ru/learn/buy-claude-api-credits/)[Бесплатный API Claude: существует ли бесплатный ключ API Claude и что действительно бесплатно в 2026?](/ru/learn/claude-api-free-trial/)[API Claude или подписка Claude Pro/Max — что выбрать](/ru/learn/claude-api-vs-subscription/)[Запуск Codex CLI на Claude](/ru/learn/use-claude-api-with-codex/)[Подключение Claude к n8n](/ru/learn/use-claude-api-with-n8n/)[Маршрутизация LiteLLM к Claude](/ru/learn/use-claude-api-with-litellm/)[Использование Claude в Kilo Code](/ru/learn/use-claude-api-with-kilo-code/)[Подключение Claude к GitHub Copilot](/ru/learn/use-claude-api-with-github-copilot/)[Подключите Zed к Claude через шлюз](/ru/learn/use-claude-api-with-zed/)[Подключите Cherry Studio к Claude](/ru/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic в LangChain: импорт, base_url, потоковая передача, инструменты и ошибки](/ru/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: установка, настройка base_url, потоковая передача и обработка ошибок](/ru/learn/anthropic-python-sdk/)[Claude с Vercel AI SDK: baseURL в createAnthropic, потоковая передача и устранение проблем](/ru/learn/use-claude-api-with-vercel-ai-sdk/)[Как устроен API Claude Code](/ru/learn/claude-code-api/)[Интеграция API Claude в ваше приложение](/ru/learn/claude-api-integration/)[Как пользоваться Claude без ограничений — и почему «взломанного Claude Code» не существует](/ru/learn/get-unlimited-claude-usage/)