Providers

​

Quick Setup

1. Open Settings (Cmd+, / Ctrl+,)
2. Navigate to Providers
3. Expand any provider and enter your API key
4. Start using models from that provider

​

Supported Providers

​

Environment Variables

​

Advanced: Manual Configuration

{
  "anthropic": {
    "apiKey": "sk-ant-...",
    "baseUrl": "https://api.anthropic.com", // Optional custom endpoint
  },
  "openrouter": {
    "apiKey": "sk-or-v1-...",
    // Provider routing preferences
    "order": ["Cerebras", "Fireworks"],
    "allow_fallbacks": true,
  },
  "xai": {
    "apiKey": "sk-xai-...",
    // Search orchestration settings
    "searchParameters": { "mode": "auto" },
  },
  "bedrock": {
    "region": "us-east-1",
    // Uses AWS credential chain if no explicit credentials
  },
  "ollama": {
    "baseUrl": "http://your-server:11434/api", // Custom Ollama server
  },
}

​

OpenAI wire format

{
  "openai": {
    "baseUrl": "https://your-openai-gateway.example/v1",
    "wireFormat": "chatCompletions",
  },
}

​

Cyber mode (OpenAI Daybreak)

​

Custom providers

{
  "local-vllm": {
    "providerType": "openai-compatible",
    "displayName": "Local vLLM",
    "baseUrl": "http://localhost:8000/v1",
    "models": ["qwen3-coder"],
  },
}

• openai-compatible and openai-responses: an origin-only URL such as http://localhost:8080 gains /v1. Explicit paths remain unchanged. A trailing slash, such as http://localhost:8080/, keeps requests at the origin root.
• anthropic-messages: trailing slashes are removed and /v1 is appended unless the URL already ends in /v1. For example, https://gateway.example/anthropic becomes https://gateway.example/anthropic/v1.

​

llama.cpp

{
  "llama-cpp": {
    "providerType": "openai-compatible",
    "displayName": "llama.cpp",
    "baseUrl": "http://localhost:8080/v1",
    "models": ["qwen3-coder"],
  },
}

​

vLLM

{
  "local-vllm": {
    "providerType": "openai-compatible",
    "displayName": "Local vLLM",
    "baseUrl": "http://localhost:8000/v1",
    "models": ["qwen3-coder"],
  },
}

​

LM Studio

{
  "lm-studio": {
    "providerType": "openai-compatible",
    "displayName": "LM Studio",
    "baseUrl": "http://localhost:1234/v1",
    "models": ["local-model"],
  },
}

• baseUrl is resolved from the Xum backend process. In desktop mode, this is your local machine. In server mode, the endpoint must be reachable from the server.
• Most compatible servers require the /v1 suffix in the URL. Use the normalization rules above when a gateway mounts its API under another path.
• Keep the official providers for provider-specific account features such as Codex OAuth and OpenAI service tiers. Custom providers select the request format but do not inherit those features.
• Custom providers are direct-only and do not participate in gateway routing.
• You no longer need to set a fake apiKey to point Xum at a keyless local server.

​

Coder (Login with Coder)

• The OAuth2 provider experiment: start coderd with --experiments=oauth2 (or CODER_EXPERIMENTS=oauth2)
• AI Gateway entitlement and --aibridge-enabled, with at least one provider configured

1. Open Settings → Providers → Coder
2. Set the Deployment URL (e.g. https://coder.example.com)
3. Click Login with Coder and approve the request in your browser

​

Model routing

• Only providers of the same type are offered: an Anthropic mapping must point at an anthropic-type provider, and so on.
• Default keeps the built-in behavior: Anthropic and OpenAI models use the gateway provider named anthropic or openai; Google models route through Coder only when mapped.
• A mapping to a provider that is no longer known (or has a different type) shows as “(not found)”, and that native provider does not route through Coder until you pick another one.
• Mapping does not change whether Coder is used: route priority and per-model Route overrides still decide that. Explicit coder:<provider>/<model> selections always address the named provider literally.
• The Coder card’s Routes to line lists the native providers that currently route through Coder, including a mapped Google and excluding a “(not found)” mapping.
• The model picker does not show the route: Settings → Models shows it per model, and replies from native models sent through Coder are marked “via Coder” in the transcript.
• The deployment’s AI Gateway logs attribute Gemini traffic to openai, because Xum speaks the OpenAI-compatible protocol to google-type providers.
• Mappings are stored as canonicalRoutes in the coder section of ~/.xum/providers.jsonc. Xum also keeps its own bookkeeping keys there (discoveredProviders, discoveredModels, staleDiscoveredModels, discoveredModelsUnlisted, coderCatalogGeneration); do not edit them by hand.

{
  "coder": {
    "additionalProviders": [{ "name": "llm-proxy", "type": "openai-compat" }],
    "models": ["llm-proxy/llama-3.3-70b"],
  },
}

​

Bedrock Authentication

1. Bearer Token - Single API key via bearerToken config or AWS_BEARER_TOKEN_BEDROCK env var
2. Explicit Credentials - accessKeyId + secretAccessKey in config
3. AWS Credential Chain - Automatic resolution from environment, ~/.aws/credentials, SSO, EC2/ECS roles

​

Anthropic Fast mode

​

OpenRouter Provider Routing

• order: Priority list of providers (e.g., ["Cerebras", "Fireworks"])
• allow_fallbacks: Whether to try other providers if preferred ones are unavailable
• only / ignore: Restrict or exclude specific providers
• data_collection: "allow" or "deny" for training data policies

​

xAI Search Orchestration

​

Model Parameter Overrides

{
  "anthropic": {
    "apiKey": "sk-ant-...",
    "modelParameters": {
      // Override for a specific model
      "claude-sonnet-4-5": {
        "temperature": 0.7,
        "max_output_tokens": 16384,
      },
      // Wildcard default for all Anthropic models
      "*": {
        "max_output_tokens": 8192,
      },
    },
  },
}

​

Supported parameters

​

Resolution order

1. Effective model ID - a dated snapshot like claude-sonnet-4-5-20250929
2. Canonical model ID - the model you selected, e.g. claude-sonnet-4-5
3. Wildcard "*" - catch-all for that provider

​

Priority with other settings

1. Explicit per-message override (from thinking level or UI)
2. modelParameters config value
3. Model’s built-in default