# Claude Code + seu provedor

Mantenha o Claude Code como sua CLI e conecte uma configuração de inicialização a outro provedor de modelos compatível com a Anthropic.

## Obtenha os dados do provedor

Instale o Claude Code e obtenha a URL base compatível com a Anthropic do seu provedor, a chave de API e os IDs de modelo. Um endpoint compatível apenas com OpenAI não funciona com o Claude Code.

Este exemplo cria uma entrada separada chamada `Claude · work`. Suas outras entradas do Claude Code mantêm as configurações atuais.

## 1. Adicione a configuração do provedor

Adicione esta configuração ao facade.json (veja [Configurações dos agentes](https://facadecode.com/pt-br/docs/settings/)). Substitua a URL, a chave e os IDs de modelo do exemplo por valores do seu provedor:

```json
{
  "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"
      }
    }
  }
}
```

Para cada alias, use um modelo disponível no seu provedor. O modelo associado ao Haiku é usado em tarefas menores em segundo plano e pode ser diferente do principal.

## 2. Confira o endpoint e os mapeamentos de modelo

| Configuração | O que faz |
| --- | --- |
| `ANTHROPIC_BASE_URL` | Direciona o Claude Code para a API compatível com a Anthropic do provedor. |
| `ANTHROPIC_AUTH_TOKEN` | Fornece o token do provedor. |
| `ANTHROPIC_API_KEY: null` | Remove uma chave de API da Anthropic herdada para esta configuração. |
| `model` | Define o modelo inicial desta entrada. |
| `ANTHROPIC_DEFAULT_…_MODEL` | Mapeia solicitações Opus, Sonnet e Haiku para IDs que o provedor atende. |

O exemplo armazena a chave no facade.json. Para ler uma variável de ambiente existente, use `"ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}"`. O editor precisa ter essa variável antes de o agente iniciar.

Estas variáveis valem apenas para agentes iniciados com esta entrada. Você não precisa editar as configurações globais do Claude Code.

## 3. Inicie o Claude Code com esta configuração

Salve o facade.json, escolha **New Agent** e selecione `Claude · work`. Dê a ele uma tarefa curta no seu projeto.

Se seu provedor mostra dados de uso, confirme que a solicitação aparece na conta certa. Se o agente não iniciar ou a solicitação falhar, execute **Show Agent Launch** e escolha o local de trabalho. Encontre esta entrada no relatório para ver como o Facade a iniciaria.

Para erros de autenticação ou de modelo ausente, veja [Solução de problemas](https://facadecode.com/pt-br/docs/troubleshooting/).

## Exemplo: QwenCloud

Para uma chave do plano Token do QwenCloud, use `https://token-plan.maas.qwencloudapi.com/apps/anthropic` como URL base. Selecione IDs de modelo disponíveis no seu plano. Chaves de pagamento por uso usam um endpoint regional.

[Endpoint e configurações de modelo atuais do QwenCloud ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/claude-code)