Factory Droid

Factory Droid — CLI-агент для разработки. Добавьте OneProvider как кастомную Anthropic-совместимую модель в ~/.factory/settings.json.

Настройка

Factory Droid берёт свои модели (BYOK) из ~/.factory/settings.json — веб-интерфейса для провайдеров нет. Добавьте модель в массив customModels; baseUrl — без/v1, провайдер anthropic дописывает /v1/messages сам.

{
"customModels": [
{
"model": "claude-sonnet-5-5",
"displayName": "OneProvider claude-sonnet-5-5",
"baseUrl": "https://api.oneprovider.dev",
"apiKey": "sk-your-key-here",
"provider": "anthropic",
"maxOutputTokens": 8192
}
]
}

Для других Claude-моделей добавьте ещё элементы с нужным model. Затем в droid выполните /model и выберите модель в разделе Custom models.

Назначить модели «droid'ам»

У каждого Factory droid есть дефолтная модель. Используйте claude-sonnet-5-5как практический дефолт или claude-opus-5-5 для архитектурно тяжёлой работы.

Какую модель выбрать

Добавляйте по одной записи customModels на модель. claude-sonnet-5-5 практичный вариант по умолчанию для droid; claude-opus-5-5 берите для архитектурных задач, claude-haiku-5-5 для быстрых и дешёвых droid. provider оставьте "anthropic". Id на странице моделей , ставки на странице тарифов .

Частые ошибки и решения

404

baseUrl должен быть https://api.oneprovider.dev без /v1: провайдер anthropic сам добавляет /v1/messages.

401

Ключ в записи обрезан или в нём лишняя кавычка. Вставьте ключ целиком.

Модели нет в /model

Сохраните ~/.factory/settings.json (валидный JSON, без типографских кавычек) и откройте droid заново; свои записи появляются в разделе Custom models.

429 «Insufficient balance»

Баланс или лимит ключа исчерпан. Пополните кабинет.

Вопросы и ответы

Есть ли веб-интерфейс для провайдеров?

Нет. Модели со своим ключом настраиваются только в ~/.factory/settings.json.

Можно ли добавить несколько моделей?

Да, добавьте по объекту на модель в массив; один ключ работает для всех.

Где смотреть расход?

В разделе «Расход» кабинета по ключу.

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .