메인 콘텐츠로 건너뛰기
Factory Droid CLI (명령 droid)는 Factory AI의 터미널 AI 소프트웨어 엔지니어링 에이전트입니다.
프로토콜: OpenAI 호환
  • Base URL: https://api.orcarouter.ai/v1 (/v1 접미사가 포함됩니다)

​
설치

macOS/Linux: 
curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): 
irm https://app.factory.ai/cli/windows | iex
설치되는 명령은 droid입니다.

​
구성

설정 파일: ~/.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
    }
  ]
}
원하면 orcarouter/auto를 특정 모델로 바꾸세요, 예: anthropic/claude-opus-4.8 또는 google/gemini-2.5-flash. 모델 ID는 항상 vendor/model 형식을 사용합니다.

​
실행

droid exec -m "orcarouter/auto" --auto low "Reply with exactly: OK"
예상 출력: OK.

​
참고 사항

  • 커스텀 모델은 custom_models 배열에 들어갑니다.
  • OpenAI 호환 프로토콜에는 provider: "generic-chat-completion-api"를 사용하세요.
  • base_url에는 /v1이 포함되어야 합니다.
  • --auto <low|medium|high>는 자율성(에이전트가 감독 없이 얼마나 많은 일을 할 수 있는지)을 제어합니다 — 이는 reasoning 제어가 아닙니다. thinking에 대해서는 아래를 참고하세요.
VS Code 확장: Factory의 공식 VS Code 확장은 CLI와 동일한 ~/.factory/config.json을 공유합니다 — 위의 custom_models 항목이 둘 모두에 적용되며, 에디터 전용 엔드포인트 설정이 따로 없습니다. 두 가지 주의 사항: Factory는 공식 Anthropic/OpenAI API에 대해서만 완전히 테스트하고 벤치마크하며, 알려진 문제로 인해 subagent가 커스텀 모델 대신 Anthropic으로 다시 라우팅될 수 있습니다.

​
thinking / reasoning 활성화

reasoning effort는 -r / --reasoning-effort 플래그로 제어하세요(--auto와 별개): 
droid exec -m "anthropic/claude-sonnet-4.6" -r high --auto low "What is 17*23?"
레벨: low / medium / high (기본값은 모델별 — Anthropic 모델은 기본 꺼짐, GPT-5는 기본 medium). settings.json에서 reasoningEffort를 통해 영구적으로 설정할 수도 있습니다. 검증됨: -r high는 OrcaRouter로 전달됩니다. (참고: custom_models 항목에는 reasoning 필드가 없습니다 — -r 또는 settings.json으로 제어하세요.)