Chuyển đến nội dung chính
Factory Droid CLI (lệnh droid) là agent kỹ thuật phần mềm AI terminal của Factory AI.
Giao thức: tương thích OpenAI
  • Base URL: https://api.orcarouter.ai/v1 (có chứa hậu tố /v1)

​
Cài đặt

macOS/Linux: 
curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): 
irm https://app.factory.ai/cli/windows | iex
Lệnh được cài là droid.

​
Cấu hình

Tệp cấu hình: ~/.factory/config.json. 
{
  "custom_models": [
    {
      "model_display_name": "OrcaRouter Auto",
      "model": "orcarouter/auto",
      "base_url": "https://api.orcarouter.ai/v1",
      "api_key": "sk-orca-...",
      "provider": "generic-chat-completion-api",
      "max_tokens": 8192
    }
  ]
}
Thay orcarouter/auto bằng một model cụ thể nếu bạn thích, ví dụ anthropic/claude-opus-4.8 hoặc google/gemini-2.5-flash. ID model luôn dùng định dạng vendor/model.

​
Chạy

droid exec -m "orcarouter/auto" --auto low "Reply with exactly: OK"
Kết quả mong đợi: OK.

​
Ghi chú

  • Các model tùy chỉnh nằm trong mảng custom_models.
  • Dùng provider: "generic-chat-completion-api" cho giao thức tương thích OpenAI.
  • base_url phải chứa /v1.
  • --auto <low|medium|high> điều khiển mức tự chủ (agent được làm bao nhiêu việc mà không cần giám sát) — nó không phải là điều khiển suy luận. Xem bên dưới về thinking.
Tiện ích mở rộng VS Code: Tiện ích mở rộng VS Code chính thức của Factory dùng chung tệp ~/.factory/config.json với CLI — mục custom_models ở trên áp dụng cho cả hai, không có thiết lập endpoint riêng trong trình soạn thảo. Hai điểm lưu ý: Factory chỉ kiểm thử và benchmark đầy đủ với các API chính thức của Anthropic/OpenAI, và một vấn đề đã biết có thể định tuyến các subagent trở lại Anthropic thay vì model tùy chỉnh của bạn.

​
Bật suy luận / thinking

Điều khiển mức effort suy luận bằng cờ -r / --reasoning-effort (tách biệt với --auto): 
droid exec -m "anthropic/claude-sonnet-4.6" -r high --auto low "What is 17*23?"
Các mức: low / medium / high (mặc định tùy theo từng model — model Anthropic mặc định tắt, GPT-5 mặc định medium). Bạn cũng có thể đặt nó cố định trong settings.json qua reasoningEffort. Đã kiểm chứng: -r high được truyền qua đến OrcaRouter. (Lưu ý: các mục custom_models không có trường suy luận — hãy điều khiển nó qua -r hoặc settings.json.)