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:
{
"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
| Ajuste | Qué hace |
|---|---|
ANTHROPIC_BASE_URL | Dirige Claude Code a la API de tu proveedor compatible con Anthropic. |
ANTHROPIC_AUTH_TOKEN | Proporciona el token del proveedor. |
ANTHROPIC_API_KEY: null | Elimina una clave de API de Anthropic heredada para esta configuración. |
model | Establece el modelo inicial de esta entrada. |
ANTHROPIC_DEFAULT_…_MODEL | Asigna 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.