Factory Droid

~/.factory/settings.json의 customModels 항목 — model, baseUrl, provider — 으로 Droid를 Anthropic Messages 또는 OpenAI Chat Completions를 지원하는 모든 엔드포인트에 연결합니다

// ~/.factory/settings.json  (Windows: %USERPROFILE%\.factory\settings.json)
{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "Sonnet 5 [Kunavo]",
      "baseUrl": "https://api.kunavo.com",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "anthropic"
    },
    {
      "model": "gpt-5-6-sol",
      "displayName": "GPT-5.6 Sol [Kunavo]",
      "baseUrl": "https://api.kunavo.com/v1",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "generic-chat-completion-api"
    }
  ]
}

// Then, in the shell Droid starts from:
//   export KUNAVO_API_KEY=sk-kn-...
// ${VAR_NAME} expansion is a settings.json feature. It does NOT apply to the
// legacy ~/.factory/config.json, which Factory still loads and merges.

단계별 안내

1. /app/keys에서 키를 만들고 복사하세요. 키는 한 번만 표시됩니다. Droid를 실행할 셸에서 키를 KUNAVO_API_KEY로 내보내면 키 자체를 설정 파일에 저장하지 않아도 됩니다.
2. ~/.factory/settings.json를 열고(없으면 만드세요) 위의 customModels 배열을 추가합니다. Factory가 필수로 지정한 필드는 정확히 세 가지, model, baseUrl, provider입니다. displayName는 선택기에 표시되는 레이블입니다.
3. provider의 철자를 확인하세요. 값은 반드시 anthropic, openai, generic-chat-completion-api 중 하나와 정확히 일치해야 합니다. Factory의 문제 해결 섹션은 이 값을 잘못 입력한 경우 "Invalid provider" 오류가 발생한다고 설명합니다.
4. CLI에서 /model를 실행하세요. Factory 자체 모델 아래의 별도 사용자 지정 모델 섹션에 항목이 표시되며, 설정한 displayName가 레이블로 사용됩니다. Factory는 설정 파일을 감시하므로 저장만 하면 됩니다. 다시 시작할 필요가 없습니다.
5. 인사말 대신 파일을 읽고 수정하는 작업을 지정하세요. Droid는 거의 모든 작업에서 도구 호출에 의존하므로, 단순한 채팅 턴으로는 그 동작을 확인할 수 없습니다. 그런 다음 /cost를 실행하세요. 여기에서 Factory가 캐시 적중률을 표시합니다. Kunavo는 Anthropic의 cache_control 마커를 기본 지원하지만, 일반 Chat Completions 제공자에 대해서는 Factory가 “캐싱은 제공자에 따라 다르며 보장할 수 없다”고 안내합니다.

Factory의 Custom Models (BYOK) 페이지에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Factory Droid에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

Droid에서 사용자 지정 모델로 할 수 없는 작업

Factory의 공식 문서에 명시된 제한은 세 가지입니다. 각 제한은 위 구성이 작동하는지 여부가 아니라, 구성으로 무엇을 기대할 수 있는지를 바꿉니다.

• 로컬 환경에서만 사용할 수 있습니다. Factory의 BYOK 페이지에 따르면 사용자 지정 모델은 로컬 settings.json을 읽는 Droid CLI와 데스크톱 앱에서 사용할 수 있으며, “Factory의 호스팅 웹 또는 모바일 플랫폼에는 표시되지 않습니다”. 호스팅 제품을 통해 위임한 작업은 여기에 어떤 키를 설정했든 계속 Factory 비용이 청구되는 추론을 사용합니다.
• 관리자가 기능을 끌 수 있습니다. Factory의 엔터프라이즈 제어 문서에는 사용자 BYOK를 완전히 비활성화하거나 모든 사용자 지정 모델을 승인된 호스트 하나로 고정하는 modelPolicy.allowCustomModels 및 allowedBaseUrls가 설명되어 있습니다. 관리되는 기기라면 파일 문제를 해결하기 전에 이 설정부터 확인하세요.
• 요금제 비용은 그대로 부과됩니다. 여기에 키를 설정해도 Factory 요금제가 대체되는 것은 아닙니다. BYOK 허용량 초과 시 Factory가 청구하는 금액과 해당 허용량은 비용 안내에서 다루며, 이 페이지에서는 다시 산출하지 않습니다.

다른 곳에서 설정을 복사하기 전에 알아둘 함정이 하나 있습니다. Factory는 snake_case의 custom_models와 base_url가 포함된 기존 ~/.factory/config.json도 계속 불러와 settings.json와 병합하며, 이 파일에는 ${VAR_NAME} 확장이 적용되지 않는다고 설명합니다. 이 파일에 자리표시자로 작성된 키는 문자 그대로 전송됩니다. settings.json를 사용하세요.