Claude Code + your provider

Get the provider details#

Install Claude Code, then get your provider’s Anthropic-compatible base URL, API key, and model IDs. An OpenAI-compatible endpoint alone will not work with Claude Code.

This example creates a separate entry called Claude · work. Your other Claude Code entries keep their existing settings.

1. Add the provider setup#

Add this setup to facade.json (see Agent settings). Replace the example URL, key, and model IDs with values from your provider:

{
  "clis": {
    "Claude · work": {
      "type": "claude",
      "model": "YOUR_MODEL_ID",
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": null,
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
      }
    }
  }
}

Use a model your provider supports for each alias. The Haiku mapping is used for smaller background tasks; it can use a different model from the main one.

2. Check the endpoint and model mappings#

The example stores the key in facade.json. To read an existing environment variable instead, use "ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}". The editor must have that variable before the agent starts.

These variables apply only to agents started with this entry. You do not need to edit your global Claude Code settings.

3. Start Claude Code with this setup#

Save facade.json, choose New Agent, and select Claude · work. Give it a short task in your project.

If your provider reports usage, confirm that the request appears on the right account. If the agent cannot start or the request fails, run Show Agent Launch and choose the working location. Find this entry in the report to see how Facade would start it.

For authentication or missing-model errors, see Troubleshooting.

Example: QwenCloud#

For a QwenCloud Token Plan key, use https://token-plan.maas.qwencloudapi.com/apps/anthropic as the base URL. Select model IDs available on your plan. Pay-as-you-go keys use a regional endpoint instead.

QwenCloud’s current endpoint and model settings ↗