Referencia de Niveles de Esfuerzo y Opciones de Visualización de Pensamiento
Una tabla de referencia rápida para cada nivel de esfuerzo y modo de visualización de pensamiento, y cómo combinarlos en una sola solicitud.
Cómo Usar Esta Referencia
- Busca primero el nivel de esfuerzo que coincida con las necesidades de velocidad y costo de tu carga de trabajo.
- Luego, decide por separado si el rastro de razonamiento debe mostrarse, resumirse u ocultarse.
- Trata el esfuerzo y la visualización como dos ejes independientes, no como una configuración combinada.
- Revisa estas opciones por cada endpoint a medida que cambian los patrones de uso y los objetivos de costo.
Niveles de Esfuerzo
| Nivel | Velocidad relativa | Costo relativo | Profundidad del razonamiento | Adecuación típica |
|---|---|---|---|---|
low | Más rápido | Más bajo | Mínimo | Clasificación, extracción, búsquedas cortas |
medium | Equilibrado | Moderado | Estándar | Respuestas generales de asistente, resumen |
high | Más lento | Más alto | Profundo | Revisión de código, planificación multi-paso |
max | Más lento | Más alto | Máximo | Análisis de seguridad crítica, depuración compleja |
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
output_config={"effort": "high"},
messages=[{"role": "user", "content": "..."}],
)Opciones de Visualización de Pensamiento
| Modo de visualización | Qué devuelve | Cuándo usar |
|---|---|---|
Summarized | Una versión condensada del contenido del bloque thinking | Depuración, justificación opcional para el usuario, registros de auditoría |
Omitted | Ningún contenido del bloque thinking devuelto, incluso si el razonamiento ocurrió internamente | Rutas de UI de producción donde el razonamiento crudo nunca debe llegar al cliente |
El modo de visualización es una configuración de presentación sobre cualquier razonamiento que ya haya ocurrido; no cambia el nivel de esfuerzo ni la profundidad del razonamiento en sí.
Combinando Esfuerzo y Visualización
| Esfuerzo | Visualización | Resultado |
|---|---|---|
low | Omitted | Más rápido, más barato, sin rastro de razonamiento devuelto, el mejor valor predeterminado para tareas simples de alto volumen |
medium | Summarized | Costo equilibrado con una justificación condensada disponible para depuración |
high | Summarized | Razonamiento profundo con un rastro legible, bueno para herramientas de revisión de código |
max | Omitted | Máxima profundidad de razonamiento interna, pero el cliente solo ve la respuesta final, útil cuando el razonamiento es sensible o verboso pero la calidad de la respuesta aún importa |
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=2048,
thinking={"type": "adaptive"},
output_config={"effort": "max"},
messages=[{"role": "user", "content": "..."}],
)Valores Predeterminados del Modelo
| Modelo | Predeterminado de pensamiento adaptativo | Notas |
|---|---|---|
| Claude Fable 5 | Siempre activado | Modelo de primer nivel, 1M de contexto, 128K de salida máxima |
| Claude Opus 4.8 | Configurable | Modelo de razonamiento insignia, 1M de contexto |
| Claude Sonnet 5 | Configurable | Modelo general predeterminado |
| Claude Haiku 4.5 | Configurable | El más rápido y barato, 200K de contexto, combina bien con esfuerzo low |
Eligiendo un Punto de Partida
- Tareas simples de alto volumen: esfuerzo
low, visualizaciónOmitted. - Respuestas generales de asistente: esfuerzo
medium, visualizaciónSummarizedsolo para registro interno. - Herramientas de revisión de código y planificación: esfuerzo
high, visualizaciónSummarizedmostrada a los desarrolladores. - Análisis de seguridad crítica o sensible al cumplimiento: esfuerzo
max, visualizaciónSummarizedretenida en un registro de auditoría, incluso si se omite de la respuesta del usuario final.
Preguntas Frecuentes
¿Son el nivel de esfuerzo y la visualización del pensamiento la misma configuración?
No. El esfuerzo (output_config.effort) controla la profundidad del razonamiento y el costo. La visualización del pensamiento controla si ese razonamiento se devuelve resumido u omitido. Son independientes y se pueden combinar.
¿Cuáles son los cuatro niveles de esfuerzo en orden?
low, medium, high, max, del más rápido y barato al más completo y caro.
¿La visualización omitida significa que no ocurrió ningún razonamiento?
No. El razonamiento aún puede ocurrir internamente al nivel de esfuerzo que establezcas, la visualización omitida solo significa que ese rastro de razonamiento no se devuelve en la respuesta.
¿Qué contiene realmente la visualización resumida?
Una versión condensada del razonamiento del modelo, más corta que el rastro interno completo pero aún útil para depuración o divulgación opcional.
¿Qué nivel de esfuerzo debería usar un endpoint de clasificación de alto volumen?
Esfuerzo low, típicamente emparejado con visualización Omitted, ya que las tareas de clasificación rara vez se benefician de un razonamiento visible profundo y el volumen hace que el costo sea la principal preocupación.
¿Se empareja siempre el esfuerzo máximo con la visualización resumida?
No, son independientes. Puedes ejecutar esfuerzo max con visualización Omitted cuando deseas la máxima profundidad de razonamiento interna pero no deseas exponer ni almacenar el rastro crudo.
¿Claude Fable 5 necesita configurar el esfuerzo de manera diferente a otros modelos?
Claude Fable 5 se ejecuta con pensamiento adaptativo siempre activado por defecto, pero el parámetro de esfuerzo todavía se aplica de la misma manera que con otros modelos para limitar la profundidad del razonamiento y el costo.
¿Debería usar siempre la visualización resumida para depurar?
Es un valor predeterminado razonable durante el desarrollo. Para producción, sopesa el tamaño adicional de la respuesta y cualquier sensibilidad del contenido del razonamiento antes de decidir mantener activada la visualización resumida.
¿Puedo cambiar el nivel de esfuerzo por solicitud sin cambiar la configuración de pensamiento?
Sí. output_config.effort y thinking se configuran de forma independiente en cada llamada a messages.create, por lo que puedes variar uno sin tocar el otro.
¿Qué sucede si no establezco un nivel de esfuerzo en absoluto?
La solicitud utiliza el comportamiento de razonamiento predeterminado del modelo. Para un control explícito y predecible del costo y la latencia, establece output_config.effort deliberadamente en lugar de depender de los valores predeterminados.
¿Hay un nivel entre alto y máximo para un control más fino?
No, los cuatro niveles cubiertos aquí (low, medium, high, max) son el conjunto estándar. El control granular más allá de estos cuatro se logra enrutando diferentes tipos de solicitudes a diferentes niveles, no con un quinto nivel.
Relacionados
- Pensamiento Extendido y el Parámetro de Esfuerzo Explicados - el trasfondo conceptual de estas dos configuraciones.
- Ajustando el Parámetro de Esfuerzo para Costo y Velocidad - un recorrido completo de la elección del esfuerzo por carga de trabajo.
- Habilitando el Pensamiento Adaptativo con thinking: {type: 'adaptive'} - cómo el pensamiento adaptativo interactúa con estas configuraciones.
- Conceptos Básicos de Pensamiento Extendido, Esfuerzo y Multimodal - ejemplos mínimos ejecutables que usan estas configuraciones juntas.
- Mejores Prácticas de Pensamiento Extendido, Esfuerzo y Multimodal - prácticas numeradas para elegir niveles y modos de visualización en producción.
Versiones de Stack: Escrito contra la línea de modelos Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado), y Claude Haiku 4.5 - y el SDK oficial de Python
anthropic(última versión 0.x). Los nombres de los modelos, las versiones del SDK y los precios cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.