Facade Code Documentación
Configurar agentes

Claude Code + tu proveedor

Mantén Claude Code como CLI y conecta una configuración de inicio a otro proveedor de modelos compatible con Anthropic.

Prepara los datos del proveedor

Instala Claude Code y obtén la URL base compatible con Anthropic de tu proveedor, su clave de API y sus IDs de modelo. Un endpoint solo compatible con OpenAI no funcionará con Claude Code.

Este ejemplo crea una entrada aparte llamada Claude · work. Tus demás entradas de Claude Code conservan su configuración actual.

1. Añade la configuración del proveedor

Añade esta configuración a facade.json (consulta Configuración de los agentes). Sustituye la URL, la clave y los IDs de modelo del ejemplo por los valores de tu proveedor:

facade.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"
      }
    }
  }
}

Usa en cada alias un modelo compatible con tu proveedor. La asignación de Haiku se emplea para tareas más pequeñas en segundo plano y puede usar un modelo distinto del principal.

2. Revisa el endpoint y las asignaciones de modelos

AjusteQué hace
ANTHROPIC_BASE_URLDirige Claude Code a la API de tu proveedor compatible con Anthropic.
ANTHROPIC_AUTH_TOKENProporciona el token del proveedor.
ANTHROPIC_API_KEY: nullElimina una clave de API de Anthropic heredada para esta configuración.
modelEstablece el modelo inicial de esta entrada.
ANTHROPIC_DEFAULT_…_MODELAsigna las peticiones de Opus, Sonnet y Haiku a los IDs que sirve el proveedor.

El ejemplo guarda la clave en facade.json. Para leer una variable de entorno existente, usa "ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}". El editor debe tener esa variable antes de que se inicie el agente.

Estas variables solo se aplican a los agentes iniciados con esta entrada. No necesitas modificar tu configuración global de Claude Code.

3. Inicia Claude Code con esta configuración

Guarda facade.json, elige New Agent y selecciona Claude · work. Dale una tarea breve en tu proyecto.

Si tu proveedor registra el uso, comprueba que la petición aparece en la cuenta correcta. Si el agente no se inicia o la petición falla, ejecuta Show Agent Launch y elige la ubicación de trabajo. Busca esta entrada en el informe para ver cómo la iniciaría Facade.

Para errores de autenticación o de modelo no disponible, consulta Solución de problemas.

Ejemplo: QwenCloud

Para una clave del plan Token de QwenCloud, usa https://token-plan.maas.qwencloudapi.com/apps/anthropic como URL base. Elige IDs de modelo disponibles en tu plan. Las claves de pago por uso usan un endpoint regional distinto.

Endpoint y modelos actuales de QwenCloud ↗

Ver como Markdown ↗Documentación

Buscar en la documentación

Busca en esta guía. Usa ↑ ↓ para moverte, Intro para abrir y Esc para cerrar.