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

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

Последняя проверка: 2026-09-18 · 📄 По официальной документации (Droid CLI v0.222.0 от 2026-09-18; релизы частые — сверяйтесь с droid --version)

Кратко¶

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

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

🔴 Не пишите "provider": "openai" — у апстрима это только для OpenAI Responses API («Use provider: "generic-chat-completion-api" unless you are calling OpenAI's or Anthropic's official API», BYOK). GPT / китайские модели QCode говорят на Chat Completions — берите generic-chat-completion-api.

Установка¶

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

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

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

droid --version

Настройка¶

Отредактируйте ~/.factory/settings.json (создаётся автоматически при первом запуске droid; проектный .factory/settings.local.json тоже работает — сливается поверх, не забудьте в .gitignore):

{
  "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_. Вторая ловушка: конфиг в устаревшем ~/.factory/config.json (snake_case) — официально в legacy-файле apiKey не раскрывает ссылки на переменные, и ${QCODE_KEY} уйдёт как есть. Используйте settings.json.

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

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

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

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