--- read_when: - Quieres usar modelos de Anthropic en OpenClaw summary: Usar Anthropic Claude mediante claves de API o Claude CLI en OpenClaw title: Anthropic x-i18n: generated_at: "2026-07-04T15:08:35Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 0e6fd143b85bb448f65d5d1b35ce465cce7c6f41987b39b9665910cf71761032 source_path: providers/anthropic.md workflow: 16 --- Anthropic crea la familia de modelos **Claude**. OpenClaw admite dos rutas de autenticación: - **clave de API** — acceso directo a la API de Anthropic con facturación basada en uso (modelos `anthropic/*`) - **Claude CLI** — reutiliza un inicio de sesión existente de Claude Code en el mismo host El backend Claude CLI de OpenClaw ejecuta la CLI Claude Code instalada en modo de impresión no interactivo. La documentación actual de Claude Code de Anthropic describe `claude -p` como uso programático/Agent SDK. La actualización de soporte de Anthropic del 15 de junio de 2026 pausó el cambio anunciado de facturación de Agent SDK. Por ahora, Anthropic dice que el uso de Claude Agent SDK, `claude -p` y aplicaciones de terceros sigue consumiendo los límites de uso de una suscripción. El crédito mensual de Agent SDK anunciado anteriormente no está disponible mientras Anthropic revisa ese plan. Claude Code interactivo sigue consumiendo los límites del plan Claude con sesión iniciada. La autenticación con clave de API sigue siendo facturación directa de API de pago por uso. Para hosts Gateway de larga duración, automatización compartida y gasto de producción predecible, usa una clave de API de Anthropic. Consulta los artículos de soporte actuales de Anthropic antes de depender del comportamiento de facturación de suscripción: - [Referencia de Claude Code CLI](https://code.claude.com/docs/en/cli-usage) - [Usa Claude Agent SDK con tu plan Claude](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) - [Usa Claude Code con tu plan Pro o Max](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan) - [Usa Claude Code con tu plan Team o Enterprise](https://support.claude.com/en/articles/11845131-using-claude-code-with-your-team-or-enterprise-plan) - [Gestiona los costos de Claude Code](https://code.claude.com/docs/en/costs) ## Primeros pasos **Recomendado para:** acceso estándar a la API y facturación basada en uso. Crea una clave de API en la [Consola de Anthropic](https://console.anthropic.com/). ```bash openclaw onboard # choose: Anthropic API key ``` O pasa la clave directamente: ```bash openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY" ``` ```bash openclaw models list --provider anthropic ``` ### Ejemplo de configuración ```json5 { env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } }, } ``` **Recomendado para:** reutilizar un inicio de sesión existente de Claude CLI sin una clave de API separada. Verifica con: ```bash claude --version ``` ```bash openclaw onboard # choose: Claude CLI ``` OpenClaw detecta y reutiliza las credenciales existentes de Claude CLI. ```bash openclaw models list --provider anthropic ``` Los detalles de configuración y runtime del backend Claude CLI están en [Backends de CLI](/es/gateway/cli-backends). La reutilización de Claude CLI espera que el proceso de OpenClaw se ejecute en el mismo host que el inicio de sesión de Claude CLI. Las instalaciones con Docker pueden conservar un home de contenedor e iniciar sesión en Claude Code allí; consulta [Backend Claude CLI en Docker](/es/install/docker#claude-cli-backend-in-docker). Otras instalaciones de contenedores, como [Podman](/es/install/podman), no montan el `~/.claude` del host en la configuración ni en runtime; usa allí una clave de API de Anthropic, o elige un proveedor con OAuth gestionado por OpenClaw, como [OpenAI Codex](/es/providers/openai). ### Ejemplo de configuración Prefiere la referencia canónica del modelo Anthropic más una anulación de runtime de CLI: ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" }, models: { "anthropic/claude-opus-4-8": { agentRuntime: { id: "claude-cli" }, }, }, }, }, } ``` Las referencias de modelo heredadas `claude-cli/claude-opus-4-7` siguen funcionando por compatibilidad, pero la configuración nueva debe mantener la selección de proveedor/modelo como `anthropic/*` y poner el backend de ejecución en la política de runtime de proveedor/modelo. ### Facturación y `claude -p` OpenClaw usa la ruta no interactiva `claude -p` de Claude Code para las ejecuciones de Claude CLI. Anthropic trata actualmente esa ruta como uso programático/Agent SDK: - La actualización de soporte de Anthropic del 15 de junio de 2026 pausó el plan de crédito de Agent SDK separado anunciado anteriormente. - Por ahora, el uso de Claude Agent SDK con plan de suscripción, `claude -p` y aplicaciones de terceros sigue consumiendo los límites de uso de la suscripción con sesión iniciada. - El crédito mensual de Agent SDK anunciado anteriormente no está disponible mientras Anthropic revisa ese plan. - Los inicios de sesión con Console/clave de API usan facturación de API de pago por uso y no reciben el crédito de Agent SDK de suscripción. Consulta el [artículo del plan de Agent SDK](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) de Anthropic para ver el aviso de pausa, y los artículos del plan de Claude Code para el comportamiento de suscripción de [Pro/Max](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan) y [Team/Enterprise](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan). Anthropic puede cambiar la facturación y el comportamiento de límites de tasa de Claude Code sin una versión de OpenClaw. Consulta `claude auth status`, `/status` y la documentación enlazada de Anthropic cuando la previsibilidad de la facturación importe. Para automatización de producción compartida, usa una clave de API de Anthropic en lugar de Claude CLI. OpenClaw también admite opciones de estilo suscripción de [OpenAI Codex](/es/providers/openai), [Qwen Cloud](/es/providers/qwen), [MiniMax](/es/providers/minimax) y [Z.AI / GLM](/es/providers/zai). ## Valores predeterminados de razonamiento (Claude Fable 5, 4.8 y 4.6) `anthropic/claude-fable-5` siempre usa razonamiento adaptativo y tiene como valor predeterminado el esfuerzo `high`. Como Anthropic no permite desactivar el razonamiento para este modelo, `/think off` y `/think minimal` usan esfuerzo `low`. OpenClaw también omite valores de temperatura personalizados para las solicitudes de Fable 5. Claude Opus 4.8 mantiene el razonamiento desactivado de forma predeterminada en OpenClaw. Cuando habilitas explícitamente el razonamiento adaptativo con `/think high|xhigh|max`, OpenClaw envía los valores de esfuerzo de Opus 4.8 de Anthropic; los modelos Claude 4.6 usan `adaptive` de forma predeterminada. Anula por mensaje con `/think:` o en los parámetros del modelo: ```json5 { agents: { defaults: { models: { "anthropic/claude-opus-4-8": { params: { thinking: "high" }, }, }, }, }, } ``` Documentación relacionada de Anthropic: - [Razonamiento adaptativo](https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking) - [Razonamiento extendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) ## Fallback por negativa de seguridad (Claude Fable 5) Usar Claude Fable 5 significa usar también Claude Opus 4.8. Fable 5 se distribuye con clasificadores de seguridad que pueden rechazar una solicitud, y la recuperación aprobada por Anthropic es hacer que `claude-opus-4-8` atienda ese turno. OpenClaw opta por esto automáticamente para solicitudes directas con clave de API, por lo que algunos turnos de Fable se responden y se facturan como Claude Opus 4.8. Si tu política o presupuesto no puede aceptar turnos atendidos por Opus, no selecciones `anthropic/claude-fable-5`. ### Por qué existe Los clasificadores de Fable 5 devuelven `stop_reason: "refusal"` en solicitudes de dominios restringidos, y también producen falsos positivos en trabajos benignos cercanos (herramientas de seguridad, ciencias de la vida o incluso pedir al modelo que reproduzca su razonamiento sin procesar). Sin fallback, el turno termina con un error aunque otro modelo Claude lo atendería sin problemas: el propio mensaje de negativa de Anthropic indica a los integradores de API que configuren un modelo de fallback. ### Cómo funciona 1. Para cada solicitud directa con clave de API a `anthropic/claude-fable-5`, OpenClaw envía la opción de fallback del lado del servidor de Anthropic: el encabezado beta `server-side-fallback-2026-06-01` más `fallbacks: [{"model": "claude-opus-4-8"}]`. Claude Opus 4.8 es el único destino de fallback que Anthropic permite para Fable 5. 2. Solo una negativa de un clasificador de seguridad activa el fallback. Los límites de tasa, las sobrecargas y los errores del servidor se comportan exactamente igual que antes y pasan por el [failover de modelo](/es/concepts/model-failover) normal de OpenClaw. 3. El rescate ocurre dentro de la misma llamada. Una negativa antes de cualquier salida es invisible salvo por la latencia; toda la respuesta proviene de Opus 4.8. En una negativa a mitad del stream, el texto parcial se conserva como prefijo desde el que continúa el modelo de fallback, mientras que el razonamiento y las llamadas a herramientas del modelo rechazado se descartan según las reglas de reproducción de Anthropic (no deben devolverse ni ejecutarse). 4. Si Claude Opus 4.8 también se niega, el turno muestra la negativa como un error, exactamente igual que antes de esta función. El fallback ocurre a nivel de la API de Anthropic, por lo que `claude-opus-4-8` no necesita estar en tu lista de modelos configurados ni en la cadena de fallback: una clave de API compatible con Fable siempre puede atender Opus. ### Observabilidad y facturación - Un turno atendido por fallback registra un diagnóstico `provider_fallback` en el mensaje del asistente que nombra `fromModel` y `toModel`, y el `responseModel` del mensaje informa `claude-opus-4-8`. - Anthropic factura por intento: una negativa antes de la salida es gratuita, y el rescate se factura a las tarifas de Claude Opus 4.8 (actualmente la mitad de las tarifas de Fable 5). La estimación de costo por turno de OpenClaw valora los turnos atendidos por fallback a tarifas de Opus para coincidir. - Una negativa a mitad del stream factura además el parcial de Fable ya transmitido del lado de Anthropic; esa parte se informa en el uso por intento de la API, pero no se incorpora en la estimación por turno de OpenClaw. ### Alcance Se aplica a `anthropic/claude-fable-5` con autenticación por clave de API contra `api.anthropic.com`. OAuth (reutilización de suscripción de Claude CLI), URL base de proxy, solicitudes de Bedrock, Vertex y Foundry no cambian y siguen mostrando las negativas como errores allí. Verificado en vivo: un prompt benigno que pide a Fable 5 reproducir su cadena de pensamiento sin procesar se rechaza con `category: "reasoning_extraction"` cuando se envía sin fallbacks, y el mismo prompt a través de OpenClaw devuelve una respuesta normal atendida por Opus con el diagnóstico `provider_fallback` adjunto. Consulta la [guía de negativas y fallback](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback) de Anthropic para el comportamiento subyacente. ## Caché de prompts OpenClaw admite la función de caché de prompts de Anthropic para autenticación con clave de API. | Valor | Duración de caché | Descripción | | ------------------------ | ----------------- | ------------------------------------------------ | | `"short"` (predeterminado) | 5 minutos | Se aplica automáticamente para autenticación con clave de API | | `"long"` | 1 hora | Caché extendida | | `"none"` | Sin caché | Desactiva la caché de prompts | ```json5 { agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, }, } ``` Usa parámetros a nivel de modelo como base y luego anula agentes específicos mediante `agents.list[].params`: ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, list: [ { id: "research", default: true }, { id: "alerts", params: { cacheRetention: "none" } }, ], }, } ``` Orden de combinación de configuración: 1. `agents.defaults.models["provider/model"].params` 2. `agents.list[].params` (`id` coincidente, sobrescribe por clave) Esto permite que un agente mantenga una caché de larga duración mientras otro agente en el mismo modelo desactiva la caché para tráfico con ráfagas o poca reutilización. - Los modelos Anthropic Claude en Bedrock (`amazon-bedrock/*anthropic.claude*`) aceptan el paso directo de `cacheRetention` cuando está configurado. - Los modelos Bedrock que no son de Anthropic se fuerzan a `cacheRetention: "none"` en tiempo de ejecución. - Los valores predeterminados inteligentes con clave de API también inicializan `cacheRetention: "short"` para referencias de Claude en Bedrock cuando no se establece ningún valor explícito. ## Configuración avanzada El conmutador compartido `/fast` de OpenClaw admite tráfico directo de Anthropic (clave de API y OAuth hacia `api.anthropic.com`). | Comando | Se asigna a | |---------|---------| | `/fast on` | `service_tier: "auto"` | | `/fast off` | `service_tier: "standard_only"` | ```json5 { agents: { defaults: { models: { "anthropic/claude-sonnet-4-6": { params: { fastMode: true }, }, }, }, }, } ``` - Solo se inyecta para solicitudes directas a `api.anthropic.com`. Las rutas de proxy dejan `service_tier` intacto. - Los parámetros explícitos `serviceTier` o `service_tier` sobrescriben `/fast` cuando ambos están establecidos. - En cuentas sin capacidad de Priority Tier, `service_tier: "auto"` puede resolverse como `standard`. El Plugin de Anthropic incluido registra la comprensión de imágenes y PDF. OpenClaw resuelve automáticamente las capacidades de medios a partir de la autenticación de Anthropic configurada; no se necesita configuración adicional. | Propiedad | Valor | | --------------- | --------------------- | | Modelo predeterminado | `claude-opus-4-8` | | Entrada admitida | Imágenes, documentos PDF | Cuando se adjunta una imagen o un PDF a una conversación, OpenClaw lo enruta automáticamente a través del proveedor de comprensión de medios de Anthropic. La ventana de contexto de 1M de Anthropic está disponible en modelos Claude 4.x compatibles con disponibilidad general (GA), como Opus 4.8, Opus 4.7, Opus 4.6 y Sonnet 4.6. OpenClaw dimensiona esos modelos en 1M automáticamente: ```json5 { agents: { defaults: { models: { "anthropic/claude-opus-4-6": {}, }, }, }, } ``` Las configuraciones antiguas pueden conservar `params.context1m: true`, pero OpenClaw ya no envía el encabezado beta retirado `context-1m-2025-08-07`. Las entradas antiguas de configuración `anthropicBeta` con ese valor se ignoran durante la resolución de encabezados de solicitud y los modelos Claude antiguos no compatibles permanecen en su ventana de contexto normal. `params.context1m: true` también se aplica al motor Claude CLI (`claude-cli/*`) para modelos Opus y Sonnet elegibles compatibles con disponibilidad general (GA), lo que preserva la ventana de contexto de ejecución de esas sesiones CLI para que coincida con el comportamiento de la API directa. Requiere acceso de contexto largo en tu credencial de Anthropic. La autenticación con token OAuth/de suscripción conserva sus encabezados beta requeridos de Anthropic, pero OpenClaw elimina el encabezado beta de 1M retirado si permanece en una configuración antigua. `anthropic/claude-opus-4-8` y su variante `claude-cli` tienen una ventana de contexto de 1M de forma predeterminada; no se necesita `params.context1m: true`. ## Solución de problemas La autenticación con token de Anthropic caduca y puede revocarse. Para configuraciones nuevas, usa una clave de API de Anthropic en su lugar. La autenticación de Anthropic es **por agente**: los agentes nuevos no heredan las claves del agente principal. Vuelve a ejecutar la incorporación para ese agente (o configura una clave de API en el host del Gateway) y luego verifica con `openclaw models status`. Ejecuta `openclaw models status` para ver qué perfil de autenticación está activo. Vuelve a ejecutar la incorporación o configura una clave de API para esa ruta de perfil. Revisa `openclaw models status --json` para ver `auth.unusableProfiles`. Los enfriamientos por límite de tasa de Anthropic pueden estar limitados al modelo, por lo que un modelo Anthropic relacionado aún podría ser utilizable. Agrega otro perfil de Anthropic o espera a que termine el enfriamiento. Más ayuda: [Solución de problemas](/es/help/troubleshooting) y [Preguntas frecuentes](/es/help/faq). ## Relacionado Elección de proveedores, referencias de modelo y comportamiento de conmutación por error. Configuración y detalles de ejecución del motor Claude CLI. Cómo funciona el almacenamiento en caché de prompts entre proveedores. Detalles de autenticación y reglas de reutilización de credenciales.