Factory Droid Integration

Factory is an AI-native software development platform. Delegate complete tasks like refactors, incident response, and migrations to Droids without changing your workflow. This guide shows you how to connect Factory Droid to LLMCloud.

Prerequisites

Factory CLI installed (Quickstart guide)
LLMCloud API key (Get one here)

Configuration

Factory CLI supports custom models through BYOK (Bring Your Own Key). Your API keys remain local and are not uploaded to Factory servers.

Settings File Location

OS	Path
macOS / Linux	`~/.factory/settings.json`
Windows	`%USERPROFILE%\.factory\settings.json`

Add Custom Models

Edit your settings file and add the custom_models array:

{
  "custom_models": [
    {
      "model": "anthropic/claude-opus-4.5-thinking",
      "base_url": "https://llmcloud.studio",
      "api_key": "your_llmcloud_api_key",
      "provider": "anthropic"
    },
    {
      "model": "anthropic/claude-sonnet-4.5",
      "base_url": "https://llmcloud.studio",
      "api_key": "your_llmcloud_api_key",
      "provider": "anthropic"
    },
    {
      "model": "anthropic/claude-sonnet-4.5-thinking",
      "base_url": "https://llmcloud.studio",
      "api_key": "your_llmcloud_api_key",
      "provider": "anthropic"
    },
    {
      "model": "google/gemini-3-pro-preview",
      "base_url": "https://llmcloud.studio/v1",
      "api_key": "your_llmcloud_api_key",
      "provider": "openai"
    },
    {
      "model": "google/gemini-3-flash-preview",
      "base_url": "https://llmcloud.studio/v1",
      "api_key": "your_llmcloud_api_key",
      "provider": "openai"
    }
  ]
}

Available Models

Model	Model ID	Provider
Claude Opus 4.6	`anthropic/claude-opus-4.6`	anthropic
Claude Opus 4.5 Thinking	`anthropic/claude-opus-4.5-thinking`	anthropic
Claude Sonnet 4.6	`anthropic/claude-sonnet-4.6`	anthropic
Claude Sonnet 4.5	`anthropic/claude-sonnet-4.5`	anthropic
Claude Sonnet 4.5 Thinking	`anthropic/claude-sonnet-4.5-thinking`	anthropic
Claude Haiku 4.5	`anthropic/claude-haiku-4.5`	anthropic
Gemini 3 Flash Preview	`google/gemini-3-flash-preview`	openai
Gemini 3 Pro Preview	`google/gemini-3-pro-preview`	openai

Usage

After configuration, switch between models using the /model command in Factory Droid.

Troubleshooting

Invalid API Key

Problem: “API Key invalid or unauthorized” error

Solutions:

Verify your API key is correct
Check your account has sufficient balance at LLMCloud Dashboard

Connection Failed

Problem: Unable to connect to API

Solutions:

Verify Base URL matches the provider:
- Anthropic: https://llmcloud.studio
- OpenAI: https://llmcloud.studio/v1
Check your internet connection

Test with curl:

curl https://llmcloud.studio/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Model Not Found

Problem: “Model not found” error

Solutions:

Use the exact model ID format
Verify the model is available in your subscription
Check provider matches the model type

Support

Official Website: https://llmcloud.studio
API Documentation: https://docs.llmcloud.studio
Factory Documentation: https://docs.factory.ai