Gestionar costos de manera efectiva

​

Realice un seguimiento de sus costos

​

Uso del comando /usage

Total cost:            $0.55
Total duration (API):  6m 20s
Total duration (wall): 6h 33m 10s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
   claude-sonnet-4-6:  1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)

​

Estadísticas de caché de indicaciones

Prompt cache (main):   14 requests · 91% of input tokens from cache · 2 misses (last 6m 10s ago, 310.2k tokens re-cached) · 1 expected rebuild (compaction or tool-result clearing) · warm (1h TTL, last activity 40s ago)

• Misses (Fallos): solicitudes que reprocesaron contenido que el caché ya contenía, con la hora del último fallo y cuántos tokens esas solicitudes escribieron de nuevo en el caché. Las acciones que invalidan el caché enumeran las causas habituales. Cuando Claude Code puede identificar una causa probable para el último fallo, la línea también la nombra, por ejemplo likely cause: tool definitions changed. El texto de causa probable requiere Claude Code v2.1.260 o posterior.
• Expected rebuilds (Reconstrucciones esperadas): cuando Claude Code ha reescrito la conversación, por compactación o por borrar resultados de herramientas antiguos del contexto, cuenta el mismo tipo de fallo como una reconstrucción esperada en su lugar. Esta parte aparece solo después de que ha ocurrido al menos una reconstrucción esperada.
• Warm or cold (Cálido o frío): si el prefijo en caché aún está dentro de su vida útil de caché, con el TTL en vigor. Cuando el caché está frío, la línea muestra cuánto tiempo la sesión ha estado inactiva. Cuando ninguna respuesta ha reportado tokens de caché, la línea termina con no prompt caching reported by the API en su lugar.

​

Desglose de uso del plan

• Attribution (Atribución): uso reciente atribuido a skills, subagentes, plugins y servidores MCP individuales, cada uno mostrado como un porcentaje del total. La participación de un servidor MCP cuenta solo las solicitudes que consumieron uno de sus resultados de herramientas. Antes de v2.1.222, después de una llamada a un servidor MCP, Claude Code atribuía cada solicitud posterior a ese servidor, sobrestimando su participación.
• Recommendations (Recomendaciones): cambios sugeridos, uno por fila. Cada fila comienza con una proporción de tu uso reciente, de al menos 10%, como en 25% Trim ~/code/api/CLAUDE.md · 49k tokens per request.
  • Cómo leer la proporción: indica a qué parte de tu uso se aplica la fila, no cuánto ahorra el cambio. Una misma solicitud puede contar para varias filas, por lo que las proporciones pueden sumar más del 100%.
  • Cómo aplicar las recomendaciones: para que Claude Code aplique las que puede, consulta Aplica recomendaciones con el atajo de corrección
• Loops (Bucles): una fila para cada una de las tareas /loop u otras tareas programadas con alcance de sesión más pesadas que se ejecutaron recientemente, ordenadas por tokens totales, con un recuento del resto. Requiere Claude Code v2.1.242 o posterior.
  • Qué informa cada fila: con qué frecuencia se activa la tarea, cuántas veces se ejecutó, sus tokens totales y por ejecución, y cuándo se ejecutó por última vez
  • Bucles detenidos y recreados: Claude Code identifica cada fila por el prompt de la tarea, así que un bucle que detienes y vuelves a crear sigue siendo una sola fila

​

Aplica recomendaciones con el atajo de corrección

1. Cuando termina cualquier turno en curso, Claude Code ejecuta cada comando /effort que aparece en una fila sin run.
2. Luego Claude recibe un prompt con un paso para cada una de las demás filas sobre las que puede actuar. El prompt le pide a Claude que te muestre cada cambio antes de hacerlo.

​

Verifique su gasto en créditos de uso

• Pro, Max y Ultra: tu gasto del mes actual, medido contra tu límite de gasto mensual cuando has establecido uno. Cuando no has establecido un límite, la fila muestra Unlimited y ninguna cifra de gasto.
• Team y Enterprise: su propio gasto para el mes actual, medido contra cualquier límite que su organización estableció que se le aplique. Un límite que cubre toda la organización no aparece en la fila. Cuando no tiene su propio límite, la fila muestra su gasto sin límite junto a él. Mientras los créditos de uso estén desactivados para usted, /usage no muestra ninguna fila de créditos de uso.

​

Cuando la solicitud de uso falla

​

Lee el conteo de tokens junto al indicador de actividad

• Qué incluye: la salida que genera el turno, como el texto y las llamadas a herramientas que Claude devuelve en streaming, su pensamiento y la salida de los subagentes que se ejecutan en primer plano
• Qué deja fuera: lo que Claude Code envía al modelo, por lo que tu prompt, el historial de la conversación y el resto de tu contexto no lo modifican
• Cuándo se restablece: al inicio de cada turno y cuando Claude Code compacta la conversación
• Cuándo permanece oculto: hasta que empieza a llegar la salida, cuando la fila es demasiado estrecha para mostrarlo y en el modo de lector de pantalla

​

Analice sus patrones de uso

​

Agregue créditos de uso a su suscripción

​

Administra los costos de tu organización

​

Informa el gasto con tus tarifas contratadas

​

Claude for Teams y Enterprise

• Ver el gasto: el informe de gasto en las analíticas de la organización muestra el gasto estimado por usuario y por modelo, con exportación a CSV, y se actualiza a diario. El informe cubre el gasto en créditos de uso y aparece una vez que se activan los créditos de uso. El uso dentro de la asignación del puesto no se mide en dólares.
• Ver la adopción: el panel de analíticas muestra los usuarios activos diarios, las sesiones y las métricas de contribución, con exportación a CSV de los datos de contribución. Consulta haz seguimiento del uso del equipo con analíticas.
• Limitar el gasto: la asignación del puesto es el tope predeterminado. Para permitir que los miembros continúen más allá de ella, activa los créditos de uso y establece límites de gasto a nivel de organización, de grupo o de miembro individual.
• Obtener cifras por usuario: en el plan Enterprise, la Enterprise Analytics API devuelve informes de uso y costo por usuario en todas las superficies de Claude, incluido Claude Code. Un Primary Owner crea una clave con el alcance read:analytics en claude.ai/analytics/api-keys. En el plan Teams, exporta el CSV del informe de gasto, que enumera el uso de tokens y el gasto estimado por usuario y por modelo.

​

Claude Console

​

Recomendaciones de rate limits

​

Proveedores de nube

• OpenTelemetry: exporta métricas desde la máquina de cada desarrollador a tu propia pila de observabilidad. Esto te da conteos de tokens, costos y actividad de herramientas por usuario, independientemente del proveedor.
• Un Claude apps gateway: un Claude apps gateway autoalojado proporciona atribución de uso por usuario, métricas OTLP con conteos de tokens y límites de gasto por usuario en estos proveedores.
• Un gateway de LLM: enruta todo el tráfico de Claude Code a través de un proxy que haga seguimiento del gasto por clave. Varias grandes empresas informaron que usan LiteLLM, una herramienta de código abierto que hace seguimiento del gasto por clave. Este proyecto no está afiliado a Anthropic y no ha sido auditado en cuanto a seguridad.

​

Cuando un desarrollador pregunta por un límite

• “You’ve hit your session limit” o “You’ve hit your weekly limit”: una ventana de uso basada en puestos de un plan de suscripción, compartida entre todos los modelos, así que el desarrollador no puede recuperar el acceso cambiando de modelo con /model. El mensaje muestra cuándo se restablece la ventana. Tras el mensaje específico de modelo “You’ve hit your Opus limit” o “You’ve hit your Sonnet limit”, cambiar con /model a un modelo fuera de esa familia sí permite que el desarrollador siga trabajando. Consulta errores de límite de uso. Lo que el desarrollador puede hacer mientras tanto:
  • Ejecutar /usage-credits para solicitar uso más allá de la asignación, si tienes los créditos de uso activados.
  • En Claude Code v2.1.234 o posterior, esperar y continuar la tarea interrumpida automáticamente tras el restablecimiento; esa sección indica cuándo Claude Code inicia la espera por su cuenta y cuándo el desarrollador la elige desde /rate-limit-options. Para controlar en toda tu flota si Claude Code inicia esa espera por su cuenta, establece autoContinueAtUsageLimit en la configuración administrada.
• “You’ve hit your individual spend limit”, “org’s monthly spend limit” o “team’s shared budget”: la solicitud del desarrollador se facturaría a créditos de uso, y esos créditos alcanzaron un límite de gasto que estableciste. Para permitir que el desarrollador continúe, ve a Organization settings > Usage y aumenta el límite que nombra el mensaje. Cuando el mensaje también nombra una hora de restablecimiento del plan, el desarrollador puede en cambio esperar hasta entonces. Consulta la referencia de errores para cada variante.
• Un mensaje de límite de gasto de un Claude apps gateway: el desarrollador superó un tope de gasto que tú estableciste en tu gateway autoalojado, y el gateway bloquea sus solicitudes hasta que se restablezca el período o hasta que tú aumentes el tope. Consulta límites de gasto del gateway para conocer los topes, los calendarios de restablecimiento y el mensaje que ve el desarrollador.
• Una advertencia de contexto o de compactación automática: no es un límite de uso. La conversación se acercó a la ventana de compactación automática de la sesión, el umbral en el que Claude Code resume el historial más antiguo para liberar espacio. Dirige al desarrollador a reduce el uso de tokens.
• Gasto inesperadamente alto en un plan de API o de proveedor de nube: suele deberse a sesiones largas que nunca se limpiaron o a Opus dejado como modelo predeterminado. Los hábitos de mayor impacto para compartir son limpiar entre tareas no relacionadas y ajustar el modelo a la tarea, ambos descritos en reduce el uso de tokens.

​

Costos de tokens de los equipos de agentes

• Usa Sonnet para los compañeros de equipo. Equilibra capacidad y costo para las tareas de coordinación.
• Mantén los equipos pequeños. Cada compañero de equipo ejecuta su propia ventana de contexto, así que el uso de tokens es aproximadamente proporcional al tamaño del equipo.
• Mantén enfocados los prompts de creación. Los compañeros de equipo cargan CLAUDE.md, los servidores MCP y los skills automáticamente, pero todo lo que hay en el prompt de creación se suma a su contexto desde el inicio.
• Cierra los compañeros de equipo cuando terminen su trabajo. Cada compañero de equipo activo sigue consumiendo tokens hasta que sale o termina la sesión.
• Los equipos de agentes están desactivados de forma predeterminada. Establece CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 en tu settings.json o en el entorno para activarlos. Consulta activa los equipos de agentes.

​

Reducir el uso de tokens

​

Gestiona el contexto de manera proactiva

• Limpia entre tareas: Usa /clear para comenzar de nuevo cuando cambies a trabajo no relacionado. El contexto obsoleto desperdicia tokens en cada mensaje posterior. Usa /rename antes de limpiar para que puedas encontrar la sesión más tarde, luego /resume para volver a ella.
• Agrega instrucciones de compactación personalizadas: /compact Focus on code samples and API usage le dice a Claude qué preservar durante el resumen.

# Compact instructions

When you are using compact, please focus on test output and code changes

​

Elige el modelo correcto

​

Reduce la sobrecarga de los servidores MCP

• Prefiere herramientas CLI cuando estén disponibles: Herramientas como gh, aws, gcloud y sentry-cli siguen siendo más eficientes en contexto que los servidores MCP porque no agregan ningún listado por herramienta. Claude puede ejecutar comandos CLI directamente.
• Deshabilita servidores no utilizados: Ejecuta /mcp para ver los servidores configurados y deshabilita cualquiera que no estés usando activamente.

​

Instala plugins de inteligencia de código para lenguajes tipados

​

Descarga el procesamiento en hooks y skills

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
pattern='^(npm test|pytest|go test)( [^;&|<>`$#\\[:cntrl:]]*)?$'
if [[ "$cmd" =~ $pattern ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "$input" | jq --arg filtered "$filtered_cmd" \
    '{hookSpecificOutput: {hookEventName: "PreToolUse", updatedInput: (.tool_input + {command: $filtered})}}'
else
  echo "{}"
fi

​

Mueve instrucciones de CLAUDE.md a skills

​

Ajusta el pensamiento extendido

​

Delega operaciones detalladas a subagentes

​

Gestiona los costos de los equipos de agentes

​

Escribe prompts específicos

​

Trabaja eficientemente en tareas complejas

• Usa el modo plan para tareas complejas: Presiona Shift+Tab para pasar al modo plan antes de la implementación. Claude explora la base de código y propone un enfoque para tu aprobación, evitando retrabajo costoso cuando la dirección inicial es incorrecta.
• Corrige el rumbo temprano: Si Claude comienza a ir en la dirección equivocada, presiona Escape para detenerlo inmediatamente. Usa /rewind o presiona Escape dos veces para restaurar la conversación y el código a un checkpoint anterior.
• Proporciona objetivos de verificación: Incluye casos de prueba, pega capturas de pantalla o define la salida esperada en tu prompt. Cuando Claude puede verificar su propio trabajo, detecta problemas antes de que necesites solicitar correcciones.
• Prueba incrementalmente: Escribe un archivo, pruébalo y luego continúa. Esto detecta problemas temprano.

​

Uso de tokens en segundo plano

​

Por qué el uso aumenta en una sesión larga

• Contexto largo: Claude Code envía su conversación completa con cada solicitud, y cada vez que Claude utiliza herramientas envía otra solicitud que lleva ese lote de resultados de herramientas. Con almacenamiento en caché de solicitudes, Claude Code relee ese historial a la tasa de token almacenado en caché, por lo que una pregunta de una línea en una sesión que ha estado abierta todo el día sigue consumiendo uso para toda la conversación. Consulte Gestionar el contexto de forma proactiva para conocer formas de mantener su contexto pequeño
• Fallos de caché: tu primer mensaje después de una pausa más larga que la duración de la caché falla en la caché y reprocesa tu contexto completo. Consulta qué duración obtienen tus solicitudes y los controles para configurarla
• Tareas programadas: una tarea programada con alcance de sesión se ejecuta en su intervalo incluso mientras la sesión está inactiva, enviando tu contexto completo cada vez
• Mensajes entre sesiones: Claude Code entrega un mensaje de otra de sus sesiones como un nuevo turno cuando esta sesión está inactiva, enviando su contexto completo cada vez. Para retener los mensajes entrantes en lugar de entregarlos, establezca crossSessionInbound en hold
• Verificaciones de objetivos: mientras el trabajo en segundo plano mantiene un objetivo activo en espera, Claude Code le pide a Claude que verifique ese trabajo incluso cuando la sesión está inactiva, iniciando un nuevo turno que envía su contexto completo. Claude Code inicia como máximo tres verificaciones inactivas por objetivo entre sus solicitudes. Antes de v2.1.246, las verificaciones inactivas eran ilimitadas. Para desactivar las verificaciones, establezca CLAUDE_CODE_GOAL_CHECKIN_MINUTES en 0. Las verificaciones inactivas requieren Claude Code v2.1.236 o posterior
• Subagentes y flujos de trabajo: cada subagente, y cada agente que un flujo de trabajo dinámico genera, envía sus propias solicitudes además de las de la conversación principal. El desglose de atribución muestra la parte del subagente
• Compañeros agentes: cada compañero activo sigue consumiendo tokens hasta que sale
• Compactación: /compact lee la conversación que resume, por lo que compactar un contexto grande es en sí una solicitud grande. Cuando desea un nuevo comienzo en lugar de continuidad, /clear no cuesta nada

​

Entender los cambios en el comportamiento de Claude Code

• Planes de suscripción (Pro, Max, Ultra, Team, Enterprise): inicia sesión en claude.ai, haz clic en tus iniciales en la esquina inferior izquierda y selecciona Obtener ayuda
• Facturación de Console (API): inicie sesión en platform.claude.com, haga clic en sus iniciales y seleccione Obtener ayuda