راه‌اندازی Droid (Factory)

افزودن QCode.cc به‌عنوان یک مدل سفارشی BYOK در Droid CLI از Factory: provider=anthropic به‌همراه baseUrl در ~/.factory/settings.json

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

آخرین بازبینی: 2026-09-18 · 📄 بر پایه مستندات رسمی (Droid CLI v0.222.0 منتشر شده در 2026-09-18؛ انتشارهای پرتکرار — به droid --version اعتماد کنید)

در یک نگاه¶

Droid عامل کدنویسی ترمینالی با هوش مصنوعی از Factory است. از مدل‌های سفارشی BYOK پشتیبانی می‌کند، بنابراین QCode.cc را می‌توان به‌عنوان یک مدل سفارشی افزود.

کدام پروتکل¶

Droid پروتکل را از طریق فیلد provider انتخاب می‌کند. برای Claude از anthropic استفاده کنید — نقطه پایانی OpenAI در QCode مدل‌های Claude را نمی‌پذیرد (به نقاط پایانی و مسیرهای API مراجعه کنید).

🔴 "provider": "openai" را ننویسید — Factory آن را برای OpenAI Responses API رزرو کرده است («مگر اینکه API رسمی OpenAI یا Anthropic را فراخوانی می‌کنید، از provider: "generic-chat-completion-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-5-5",
      "displayName": "QCode Haiku 5.5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 4096
    }
  ]
}

کلید را از طریق متغیر محیطی تزریق کنید:

export QCODE_KEY="cr_your_qcode_key"

بر پایه مستندات Factory، کلیدهای API محلی می‌مانند و به سرورهای Factory بارگذاری نمی‌شوند. از سرزمین اصلی چین، میزبان را با https://asia.qcode.cc/api عوض کنید (نود آسیا، نزدیک‌ترین از کره / تایوان / هنگ‌کنگ).

تأیید¶

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

OK یعنی اتصال برقرار است.

کنترل منفی (برای اثبات اینکه پیکربندی واقعاً اعمال شده است): baseUrl را موقتاً روی مسیری قرار دهید که وجود ندارد و دوباره اجرا کنید — باید شکست بخورد. یک موفقیت به‌تنهایی ثابت نمی‌کند که از نقطه پایانی شما استفاده شده است.

استفاده روزمره¶

# interactive
droid

# non-interactive
droid exec "run the tests and fix the failures"

# specific working directory
droid --cwd /path/to/project

# run inside a git worktree (isolated changes)
droid -w feature-x

# autonomy level
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) — به‌طور رسمی فایل قدیمی ارجاعات محیطی apiKey را بسط نمی‌دهد، بنابراین ${QCODE_KEY} عیناً به‌عنوان کلید ارسال می‌شود. از settings.json استفاده کنید.

مدل در فهرست انتخاب وجود ندارد¶

فقط مدل‌هایی نمایش داده می‌شوند که در customModels[] فهرست شده‌اند. یک ورودی اضافه کنید و دوباره راه‌اندازی کنید.

مرتبط¶

• نقاط پایانی و مسیرهای API — جدول پروتکل × خانواده مدل
• راه‌اندازی Crush — یک عامل ترمینال دیگر
• مدل‌های چینی — GLM / Kimi / DeepSeek / Qwen

سازمانی ←