Facade CodeClaude 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). Substitua a URL, a chave e os IDs de modelo do exemplo por valores do seu provedor:
{
"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.
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.