irm https://app.factory.ai/cli/windows | iex

위 명령어를 PowerShell에서 실행하여 설치를 진행합니다. 설치 과정은 몇 분 정도 소요될 수 있습니다.

설치가 완료되면 사용자 프로필 디렉토리(C:\Users\사용자명.factory) 내의 설정 파일(setting.json)을 찾아야 합니다. 이전 버전의 config.json은 더 이상 사용되지 않습니다.

다음은 최대 출력 토큰을 65536으로 설정한 설정 파일 예시입니다:

{
  "customModels": [
    {
      "model": "your-model-id",
      "displayName": "My Custom Model",
      "baseUrl": "https://api.provider.com/v1",
      "apiKey": "${PROVIDER_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384
    }
  ]
}

정확한 설정 형식은 다음과 같습니다. 주의할 점은 카멜 케이스를 사용해야 한다는 것입니다:

{
  "customModels": [
    {
      "displayName": "agentrouter-deepseek-v3.1",
      "model": "deepseek-v3.1",
      "baseUrl": "",
      "apiKey": "",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 65536
    }
  ],
  "logoAnimation": "off"
}

공식 문서를 참고하여 더 자세한 정보를 얻을 수 있습니다. 설정이 완료되면 Droid 애플리케이션에서 모델을 선택하고 기본 모델로 지정할 수 있습니다.

CLI의 무모드(Headless) 사용법은 다음과 같습니다:

사용법: droid exec [옵션] [프롬프트]

단일 명령 실행 (비대화형 모드)

인수:
  프롬프트 실행할 프롬프트

옵션:
  -o, --output-format <포맷> 출력 형식 (기본값: "text")
  --input-format <포맷> 입력 형식: stream-json for multi-turn sessions
  -f, --file <경로> 파일에서 프롬프트 읽기
  --auto <레벨> 자동 수준: low|medium|high
  --skip-permissions-unsafe 모든 권한 확인 건너뛰기 - 모든 권한 허용 (안전하지 않음)
  -s, --session-id <ID> 기존 세션 계속 (프롬프트 필요)
  -m, --model <ID> 사용할 모델 ID
  -r, --reasoning-effort <레벨> 추론 노력 (모델별 기본값)
  --spec-model <ID> 사양 모드에 사용할 모델 ID
  --use-spec 사양 모드로 시작
  --enabled-tools <ID> 특정 도구 활성화 (쉼표 또는 공백으로 구분된 목록)
  --disabled-tools <ID> 특정 도비 비활성화 (쉼표 또는 공백으로 구분된 목록)
  --list-tools 선택된 모델의 사용 가능한 도구 나열 및 종료
  --cwd <경로> 작업 디렉토리 경로
  -h, --help 명령어 도움말 표시

Python을 사용하여 CLI를 호출하는 예제 코드:

import subprocess

# droid.exe 실행 파일 경로 확인
cli_path = r'C:\Users\Administrator\bin\droid.exe'
prompt_text = "안녕하세요, 오늘 날씨는 어떤가요?"

# CLI 실행
process = subprocess.run(
    [cli_path, 'exec', prompt_text],
    check=True,
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True,
    encoding='utf-8'
)

# 결과 출력
print(process.stdout)

설정 파일 내에서 auto 값을 변경한 후 애플리케이션을 다시 시작하면 권한 수준을 조절할 수 있습니다. CLI에서 --auto 매개변수를 사용하여 다음과 같은 자동화 수준을 지정할 수 있습니다:

• Auto (Low): 저위험 자동 실행
• Auto (Medium): 중위험 자동 실행
• Auto (High): 고위험 자동 실행