Claudio código de estado de la línea Uso de tokens: etiqueta cada contador

Una línea de estado de código Claude confiable no debe derribar cada señal de uso en un número de tokens. Muestre el contexto actual, el costo acumulativo de la sesión, la cuota de suscripción y la actualidad de los datos como ámbitos separados. Para los totales de tokens de sesión acumulados, apunta a /usage ; los campos modernos de tokens de línea de estado no proporcionan ese total. Esa distinción es importante porque el contrato oficial de campo cambió. Desde el código Claude v2.1.132, context window.total input tokens y context window.total output tokens describen el contexto actual a partir de la respuesta de la API más reciente. Antes de esa versión, los mismos campos eran totales acumulados de sesiones. Un guión de línea de estado escrito en contra del antiguo significado puede seguir funcionando después de una actualización mientras que en silencio da al número una etiqueta falsa. El defecto seguro es una línea como esta: Es menos llamativo que una sola barra de progreso. También es mucho más difícil de leer mal. Da a cada contador un alcance Claude Code dirige JSON al comando configurado statusLine . Según el Documentación oficial de línea de estado, el comando se ejecuta localmente y no consume tokens de API. Se ejecuta cuando se inicia una sesión, después de un nuevo mensaje de asistente, después de /compact , cuando varios modos de interfaz cambian, y en un temporizador de actualización opcional. La carga útil contiene varias mediciones que responden a diferentes preguntas: Pregunta de la Comisión Campo o comando documentado El ámbito de aplicación La etiqueta honesta ¿Qué tan completo es el contexto activo? context window.used percentage Contexto actual de la última respuesta de la API ctx 42% ¿Cuáles son las cuentas de entrada y salida en ese contexto? context window.total input tokens , total output tokens Contexto actual de la cuestión v2.1.132+ context , nunca session total ¿Cuánto ha costado esta sesión? cost.total cost usd Estimación local acumulada; reajustes en /clear en las versiones actuales $0.12 est ¿Cuáles son los tokens totales acumulados de la sesión? /usage Sesión actual del Código Claude tokens use /usage ¿Cuánto subsidio se consume? rate limits.five hour , rate limits.seven day Las ventanas del plan rodante para los suscriptores elegibles quota 5h … · 7d … ¿Cuántos años tiene la observación de cuotas? Ningún sello de tiempo en el objeto de línea de estado documentado Desconocido age unknown Hay dos trampas en esa mesa. En primer lugar, used percentage es una medida de contexto de entrada. Claude Code lo calcula a partir de nuevas entradas, creación de caché y tokens de lectura de caché. No incluye tokens de salida. Esto hace que sea útil para decidir si la conversación activa se está acercando a la compactación, pero no es un porcentaje del gasto de la sesión o la cuota de planificación. En segundo lugar, rate limits. .resets at es el momento en que se restablece una ventana de cuotas. No es el momento en que Claude Code trajo el porcentaje. El objeto de línea de estado documentado no tiene campo fetched at . Un tiempo de restablecimiento no puede demostrar frescura. La pantalla separada /usage tiene un contrato de datos obsoletos más fuerte. El Guía oficial de costes dice que si la solicitud de límite de plan es limitada, /usage puede mostrar una instantánea almacenada en caché de los últimos 60 minutos y marcarla explícitamente como el último uso conocido con su edad. La carga útil de la línea de estado no documenta un campo de edad equivalente. Si la edad afecta una decisión, abra /usage en lugar de decorar el porcentaje de la línea de estado como en vivo. Configurar una línea de estado con etiqueta de verdad Salvar el siguiente como ~/.claude/usage statusline.mjs : Haga que el guión sea ejecutable si su plataforma lo requiere, luego añada una línea de estado respaldada por comandos a ~/.claude/settings.json : El intervalo de actualización es opcional. Las actualizaciones basadas en eventos son suficientes para los cambios de contexto. Un temporizador es útil cuando la sesión principal está inactiva mientras se continúa el trabajo de fondo, pero no hace que los datos de cuota sean más frescos que su fuente. Reexaminar un valor no datado cada 30 segundos aún deja su edad desconocida. Este script también evita una solución tentadora pero insegura: añadir context window.current usage a cada invocación de línea de estado para reconstruir un total acumulado. El comando puede ejecutarse para la compactación, cambios de modo de permiso, cambios de Vim y cronometradores, no solo para nuevas llamadas de API. La carga útil documentada no proporciona un identificador estable de solicitud de API además de current usage . Por lo tanto, la adición repetida puede contar la misma respuesta más de una vez. Utilice /usage para los tokens de sesión acumulados. Su bloque de sesión informa el uso por modelo, incluidos los datos de entrada, salida, lectura de caché y totales de escritura de caché. La cifra en dólares sigue siendo una estimación local basada en las tasas de lista estándar, por lo que puede diferir de un contrato con descuento, precios promocionales, una factura de un proveedor de nube o una franquicia de suscripción. Prueba la versión y los caminos nulos Una línea de estado es un código operativo. Prueba las cargas útiles inconvenientes, no sólo un ejemplar poblado copiado de la documentación. El artefacto inspectable para este artículo reproduce tres accesorios a través del renderizador: 1. Una sesión activa moderna tiene un 42% de uso de contexto, un costo estimado de la sesión y ambas ventanas de cuotas. 2. Una sesión post compacción moderna tiene current usage: null , porcentajes nulos y ningún objeto de cuota. 3. Una sesión de v2.1.131 tiene campos simbólicos cuyo significado documentado es anterior al cambio de v2.1.132. La producción observada fue: Las tres afirmaciones fueron aprobadas. Lo más importante es que ninguno de los caminos de fracaso se convirtió en cero. Ese comportamiento sigue los límites oficiales de nulabilidad. context window.current usage puede ser nula antes de la primera respuesta de la API e inmediatamente después de /compact hasta que llegue otra respuesta. Los porcentajes de contexto también pueden ser nulos al principio de una sesión. rate limits aparece sólo para las sesiones de suscripción elegibles de Claude.ai después de la primera respuesta de la API, y cualquiera de las ventanas puede estar ausente de forma independiente. En la descripción de estos casos como 0% se presentan tres alegaciones que la carga útil no respalda: el contexto está vacío, no se ha consumido ninguna cuota y la medición es actual. unknown y unavailable son más útiles porque le dicen al operador que espere la próxima respuesta o consulte a /usage . Hay un límite de versión más que vale la pena mantener en la prueba. Antes de v2.1.132, los campos de entrada y salida totales eran totales de sesiones acumuladas. En las versiones actuales, son contextuales actuales. Si el campo version está perdido o antiguo, no adivines qué significado se aplica. O se ramifica deliberadamente para la versión desplegada o muestra el estado semántico como desconocido. Saber lo que la línea no puede probar La línea de estado responde a una estrecha pregunta interactiva: ¿qué expone actualmente esta sesión local de Código Claude? No establece: la factura autorizada para el uso de la API o del proveedor de servicios en la nube; la actividad total de otras máquinas o de claude.ai ; un progreso verificable o útil; el coste por resultado de ingeniería completado; la edad de los datos de las cuotas de suscripción en la carga útil documentada de la línea de estado. Esos límites afectan a la acción. El alto uso de contexto puede justificar la inspección de si la conversación todavía sirve una tarea; no significa automáticamente que /compact sea seguro. Un alto porcentaje de cinco horas puede justificar la verificación de /usage ; no demuestra qué proyecto o subagente lo causó. El aumento del coste estimado puede justificar la terminación de un ciclo improductivo; no demuestra que una carrera costosa haya fracasado. Utilice la línea como un enrutador: las rutas ctx known hacia una decisión contextual; session … est envía las preguntas de facturación a la consola y las preguntas de tokens acumuladas a /usage ; quota … age unknown rutas de trabajo sensible a los límites a /usage ; las rutas de observación unknown o unavailable , no un veredicto verde; cualquier reclamación de que el trabajo haya sido objeto de una verificación de entrega por separado. Sidewisp trata el tiempo y el presupuesto como señales de salud junto con el progreso y los resultados, pero no convierte a un contador en un veredicto de salud. Sidewisp se encuentra actualmente en versión preliminar privada. Los análisis de uso de tokens y los adaptadores de código Claude son territorio de producto planificado, no una capacidad de monitoreo enviada.