Подключение Droid (Factory)

Добавьте QCode.cc как BYOK-модель в Droid CLI от Factory: provider=anthropic и baseUrl в ~/.factory/settings.json

Подключение Droid (Factory)¶

Droid — терминальный AI-агент для программирования от Factory. Он поддерживает BYOK-модели (со своим ключом), поэтому QCode.cc можно указать как источник.

Какой протокол выбрать¶

Droid выбирает протокол по полю provider. Для Claude нужен anthropic — точка OpenAI у QCode не принимает модели Claude (см. Точки доступа и форматы API).

Установка¶

curl -fsSL https://app.factory.ai/cli | sh

Устанавливается в ~/.local/bin/droid. Если установщик сообщит, что PATH не настроен, добавьте выведенную строку в ~/.zshrc / ~/.bashrc.

Проверка (доверяйте фактическому выводу):

droid --version

Настройка¶

Отредактируйте (или создайте) ~/.factory/settings.json:

{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "QCode Sonnet 5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    },
    {
      "model": "claude-haiku-4-5",
      "displayName": "QCode Haiku 4.5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 4096
    }
  ]
}

Ключ передавайте через переменную окружения:

export QCODE_KEY="cr_ваш_ключ_QCode"

По документации Factory, ключи остаются локально и не загружаются на серверы Factory. Из материкового Китая замените хост на https://asia.qcode.cc/api (узел в Гонконге).

Проверка¶

droid exec --model "claude-sonnet-5" "reply with exactly: OK"

Ответ OK означает, что связь есть.

Отрицательный контроль (доказывает, что конфигурация применилась): временно укажите в baseUrl несуществующий путь и запустите снова — должна быть ошибка. Один только успех не доказывает, что использовался именно ваш протокол.

Повседневное использование¶

# интерактивно
droid

# неинтерактивно
droid exec "прогони тесты и почини падающие"

# конкретный рабочий каталог
droid --cwd /path/to/project

# запуск в git worktree (изолированные изменения)
droid -w feature-x

# уровень автономности
droid --auto medium

Диагностика¶

model_not_available_on_endpoint¶

В provider указан вариант, совместимый с OpenAI, а модель — Claude. Установите "provider": "anthropic" и baseUrl = https://api.qcode.cc/api.

401 / ошибка авторизации¶

${QCODE_KEY} не подставилась (переменная не экспортирована) либо в ключе есть пробелы. Проверьте, что вывод echo $QCODE_KEY начинается с cr_.

Модель не видна в списке¶

Отображаются только модели из customModels[]. Добавьте запись и перезапустите.

Смежные документы¶

• Точки доступа и форматы API — таблица «протокол × семейство моделей»
• Подключение Crush — другой терминальный агент
• Китайские модели — GLM / Kimi / DeepSeek / Qwen