Para usar Claude Haiku 5.5 en Claude Code, actualice a la v2.1.293 o posterior con claude update. Después, inicie una sesión con claude --model claude-haiku-5-5 o cambie el modelo dentro de una sesión con /model claude-haiku-5-5. Para la mayoría de los proyectos, el uso más eficiente es como subagente: configure model: haiku en agentes dedicados a búsquedas, pruebas y resúmenes, mientras Sonnet 5.5 u Opus 5.5 coordinan las tareas complejas. Con una clave API, cuesta $0.10/$0.50 por millón de tokens de entrada/salida para prompts de hasta 100K tokens, y $0.50/$2.50 por encima de ese umbral.
Esta guía cubre la configuración, la diferencia del alias haiku, los niveles de esfuerzo, los subagentes, el salto de precio a partir de 100K tokens y cuándo mantener Sonnet u Opus como modelo principal. Para conocer el modelo, lea qué es Claude Haiku 5.5. Si su código consume APIs, Apidog permite crear escenarios de prueba que un subagente Haiku puede ejecutar.
Claude Haiku 5.5 en Claude Code de un vistazo
| Configuración | Haiku 5.5 |
|---|---|
| Versión mínima | v2.1.293 (claude update) |
| ID de modelo | claude-haiku-5-5 |
Alias haiku
|
Haiku 5.5 solo en la API de Anthropic |
| Contexto | 1M nativo en cada plan, sin sufijo [1m]
|
| Auto-compactación | Aproximadamente 967K tokens por defecto |
| Esfuerzo predeterminado |
medium (de low a max) |
| Pensamiento | Siempre activado; no se puede desactivar |
| Precio de API | $0.10/$0.50 hasta 100K tokens; $0.50/$2.50 por encima de 100K |
| Planes | Pro, Max, Team, Enterprise o clave API; no Gratis |
Paso 1: actualizar Claude Code
Haiku 5.5 requiere Claude Code v2.1.293 o posterior. El registro de cambios indica que ahora es el modelo Haiku predeterminado en la API de Anthropic.
claude update
Claude Code no está disponible en el plan Gratuito. Necesita Pro, Max, Team, Enterprise o una clave API de Anthropic. Los usuarios gratuitos pueden seleccionar Haiku 5.5 en las aplicaciones de Claude.ai. Según claude.com/pricing, Pro cuesta $17 al mes con facturación anual o $20 mensuales, y Max comienza en $100.
Paso 2: seleccionar Haiku 5.5 como modelo principal
Inicie Claude Code directamente con el ID completo:
claude --model claude-haiku-5-5
Dentro de una sesión existente:
/model claude-haiku-5-5
Si su configuración guardada usa model: haiku, una sesión creada con Haiku 4.5 se reanudará con Haiku 5.5 únicamente cuando use la API de Anthropic.
El alias haiku no siempre apunta a Haiku 5.5
| Proveedor |
haiku se resuelve a |
|---|---|
| API de Anthropic | Haiku 5.5 |
| Plataforma Claude en AWS | Haiku 4.5 |
| Amazon Bedrock | Haiku 4.5 |
| Plataforma de Agentes de Google Cloud | Haiku 4.5 |
| Microsoft Foundry | Haiku 4.5 |
En proveedores cloud, /model haiku y model: haiku en un subagente pueden seguir usando Haiku 4.5. Para evitarlo, fije el ID correcto:
- Google Cloud y Claude Platform en AWS:
claude-haiku-5-5 - Microsoft Foundry: el nombre de su implementación
- Amazon Bedrock: un perfil de inferencia como
us.anthropic.claude-haiku-5-5
También puede redirigir el alias con ANTHROPIC_DEFAULT_HAIKU_MODEL, como se muestra en el paso 5.
Paso 3: elegir un nivel de esfuerzo
Haiku 5.5 es el primer modelo Haiku con control de esfuerzo:
lowmediumhighxhighmax
Claude Code usa medium de forma predeterminada. Para cambiarlo al iniciar una sesión:
claude --model claude-haiku-5-5 --effort high
En una sesión activa:
/effort low
Use cada nivel según el tipo de tarea:
| Nivel | Uso recomendado |
|---|---|
low |
Búsquedas rápidas, llamadas de herramientas cortas y tareas de gran volumen |
medium |
Trabajo general de desarrollo |
high |
Flujos de agente más largos |
xhigh y max
|
Solo cuando sus evaluaciones demuestren una mejora útil |
El pensamiento permanece activado en Claude Code. alwaysThinkingEnabled: false y MAX_THINKING_TOKENS=0 no lo desactivan. Si necesita reducir tokens de razonamiento, baje el esfuerzo.
Paso 4: ejecutar Haiku 5.5 como subagente
Haiku 5.5 funciona bien como subagente para tareas repetitivas y con mucho contexto: explorar repositorios, ejecutar pruebas, leer logs o recuperar documentación.
Los subagentes son archivos Markdown con frontmatter YAML en:
-
.claude/agents/para un proyecto -
~/.claude/agents/para todos los proyectos
Solo name y description son obligatorios. La documentación de subagentes admite sonnet, opus, haiku, fable, un ID de modelo completo o inherit en el campo model. Consulte también esta guía para crear subagentes de Claude Code.
Reemplazar Explore por un explorador económico
El subagente integrado Explore usa el modelo de la conversación principal. Si su sesión usa Opus 5.5, las búsquedas de Explore también se ejecutan en Opus.
Puede sobrescribirlo con un subagente llamado Explore y asignarle Haiku:
---
name: Explore
description: Fast read-only codebase search. Use to find files, symbols and call sites without editing anything.
tools: Read, Grep, Glob
model: haiku
effort: low
---
Busca en la base de código e informa lo que encuentras. Devuelve las rutas de archivo con los números de línea y un breve resumen de cada coincidencia. Nunca edites archivos.
Guarde el archivo como:
.claude/agents/Explore.md
Mientras se ejecuta, use /tasks para comprobar el modelo asignado. En Google Cloud, Bedrock, Foundry o Claude Platform en AWS, sustituya haiku por el ID completo del modelo.
Forzar Haiku para todos los subagentes
Para establecer Haiku como modelo para todos los subagentes, incluido Explore, añada ambas variables al bloque env de su configuración:
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
"CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
}
}
CLAUDE_CODE_SUBAGENT_MODEL solo define un valor predeterminado. Sin CLAUDE_CODE_SUBAGENT_MODEL_FORCE, un campo model declarado por un subagente sigue teniendo prioridad y Explore no cambia de modelo.
Paso 5: dirigir el trabajo en segundo plano a Haiku 5.5
ANTHROPIC_DEFAULT_HAIKU_MODEL define el modelo usado para haiku y para funciones en segundo plano, como resumir sesiones anteriores al usar:
claude --resume
La variable anterior ANTHROPIC_SMALL_FAST_MODEL está obsoleta según la referencia de variables de entorno. Reemplácela si todavía aparece en su perfil de shell.
En la API de Anthropic no necesita configurar esta variable. En otros proveedores, puede fijar Haiku 5.5 explícitamente cuando esté habilitado para su cuenta:
# Plataforma de Agentes de Google Cloud
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5
# Amazon Bedrock: ID de perfil de inferencia
export ANTHROPIC_DEFAULT_HAIKU_MODEL=us.anthropic.claude-haiku-5-5
Gestionar el salto de precio a partir de 100K tokens
El precio de Haiku 5.5 depende de la longitud del prompt. Claude Code reenvía la conversación como prompt en cada turno, por lo que las sesiones largas pueden superar rápidamente 100K tokens.
| Longitud del prompt | Entrada / salida por millón de tokens |
|---|---|
| Hasta 100K tokens | $0.10 / $0.50 |
| Más de 100K tokens | $0.50 / $2.50 |
Por encima de 100K tokens, la tarifa es cinco veces mayor. La documentación no aclara si los tokens en caché cuentan para este límite, así que conviene asumir que sí.
La auto-compactación predeterminada ocurre cerca de 967K tokens, demasiado tarde para evitar el salto de precio. Aplique estas dos prácticas:
- Compacte antes. Configure el mínimo permitido:
/autocompact 100k
- Mueva el trabajo voluminoso a subagentes. Los logs de pruebas, resultados de búsquedas y salidas extensas permanecen en el contexto del subagente, no en la conversación principal.
Incluso por encima de 100K tokens, $0.50/$2.50 sigue siendo un cuarto de los $2/$10 de Sonnet 5.5. Para el detalle de costes, consulte el desglose de precios de Haiku 5.5.
Los créditos API mensuales de Max y Team no cubren Claude Code interactivo, según la documentación de créditos API para suscriptores.
Cuándo mantener Sonnet 5.5 u Opus 5.5 como líderes
Sonnet 5.5 y Opus 5.5 siguen siendo opciones mejores para tareas complejas de programación basadas en agentes.
En Terminal-Bench 4.0, ejecutado por Anthropic en Claude Code con esfuerzo máximo:
| Esfuerzo | Haiku 5.5 | Sonnet 5.5 |
|---|---|---|
medium |
20.3% a $0.68 | 28.8% a $0.68 |
high |
24.8% a $1.04 | 43% a $1.46 |
max |
39.2% a $2.64 | 70.6% a $10.44 |
En medium, ambos modelos cuestan aproximadamente lo mismo por intento, pero Sonnet obtiene una puntuación superior. El menor precio por token de Haiku no siempre se traduce en ahorro para tareas largas de shell.
El uso del ordenador muestra una relación distinta: en OSWorld 2.1, Haiku 5.5 con medium logró 53.3% a $0.13 por intento, mientras Sonnet 5.5 con low logró 57.9% a $0.68.
Una división práctica es:
- Sonnet 5.5 u Opus 5.5: modelo principal para coordinación, cambios complejos y depuración difícil.
- Haiku 5.5: Explore, ejecutores de pruebas, lectores de logs y recuperadores de documentación.
Consulte el desglose de benchmarks de Haiku 5.5 y la guía de Claude Code con Sonnet 5.5 para más comparativas.
Ejemplo: subagente Haiku para ejecutar pruebas de Apidog
Las pruebas de API generan salidas extensas y repetitivas, por lo que son una buena tarea para Haiku. La CLI de Apidog puede ejecutar escenarios guardados desde la terminal y devolver un resumen al modelo principal.
Cree .claude/agents/api-test-runner.md:
---
name: api-test-runner
description: Runs the project's Apidog test scenarios with the Apidog CLI after an API endpoint changes, then reports pass and fail counts with the failing requests.
tools: Bash, Read
model: haiku
effort: low
---
Ejecute el comando de prueba de la CLI de Apidog documentado en el README de este repositorio para el
escenario que cubre el endpoint modificado. Informe los recuentos de aprobación y fallo.
Para cada fallo, proporcione el nombre de la solicitud, el resultado esperado y el resultado
real. No edite código. No reintente una ejecución fallida más de una vez.
La configuración de autenticación y ejecución está disponible en Apidog CLI en Claude Code. Puede descargar Apidog para crear los escenarios que ejecutará el subagente.
Migrar una aplicación desde Haiku 4.5
Si su aplicación usa Haiku 4.5 mediante API, Claude Code puede iniciar la migración:
/claude-api migrate this project to claude-haiku-5-5
Tenga en cuenta estos cambios incompatibles en Haiku 5.5:
-
budget_tokensmanual para pensamiento -
temperatureotop_pdistintos de sus valores predeterminados - Cualquier valor de
top_k - Prefill del asistente
Estas configuraciones devuelven un error 400 en Haiku 5.5. Revise la guía Haiku 5.5 vs. Haiku 4.5 para ver todas las correcciones.
Después de migrar:
- Guarde la solicitud anterior y la nueva como un par de pruebas en Apidog.
- Almacene
ANTHROPIC_API_KEYcomo variable de entorno. - Valide
stop_reasonyusage. - Haga fallar la prueba si aparece un nuevo
refusalo un salto inesperado de tokens.
Así evitará que cambios de comportamiento lleguen a producción sin validación.
Preguntas frecuentes
¿Haiku 5.5 es el modelo predeterminado de Claude Code?
No. Es el modelo Haiku predeterminado de la API de Anthropic, por lo que el alias haiku apunta a él en esa API. Para usarlo como modelo principal, seleccione --model claude-haiku-5-5 o ejecute /model claude-haiku-5-5.
¿Puedo usar Haiku 5.5 en Claude Code con el plan Gratuito?
No. Claude Code requiere un plan de pago o una clave API. Los usuarios gratuitos pueden seleccionar Haiku 5.5 en Claude.ai. Consulte cómo usar Claude Haiku 5.5 gratis.
¿Por qué model: haiku me asigna Haiku 4.5?
Probablemente está usando Bedrock, Google Cloud, Foundry o Claude Platform en AWS, o una versión anterior a Claude Code v2.1.293. Use el ID completo del modelo o configure ANTHROPIC_DEFAULT_HAIKU_MODEL.
¿Puedo desactivar el pensamiento para ahorrar tokens?
No en Claude Code. Use low para reducir el esfuerzo y el consumo asociado.
Próximo paso
Ejecute:
claude update
Después, añada la anulación Explore con Haiku y mantenga su modelo principal actual durante una semana. Si su proyecto tiene APIs, incorpore el subagente ejecutor de pruebas.
Para integrar el modelo en su propia aplicación, comience con la guía de API de Haiku 5.5. Apidog es gratuito para empezar y permite dar a sus subagentes escenarios de prueba reales.
Top comments (0)