Icono de la app Claude Counter

Guía de Configuración

Primeros Pasos

¡Bienvenido a Claude Counter! Esta guía te ayudará a configurar la app y a empezar a controlar tus sesiones de Claude Code en minutos.

Paso 1: Descarga e Instalación

  1. Abre la App Store en tu iPhone o iPad
  2. Busca «Claude Counter»
  3. Toca Obtener para descargar e instalar
  4. Abre la app cuando termine la instalación
Descárgalo en App Store

Paso 2: Elige tu Idioma

Al abrir Claude Counter por primera vez, se te pedirá que selecciones tu idioma preferido.

Idiomas Disponibles:

  • Inglés (Reino Unido)
  • Inglés (EE. UU.)
  • Afrikáans
  • Griego (Ελληνικά)
  • Francés (Français)
  • Español (Español)
  • Alemán (Deutsch)
  • Neerlandés (Nederlands)
  • Chino simplificado (中文 简体)
  • Chino tradicional (中文 繁體)
  • Japonés (日本語)

Toca tu idioma preferido para continuar. Puedes cambiarlo más tarde en Opciones.

Paso 3: Conecta tu Uso Real de Claude (Mac)

Este paso único activa las funciones más valiosas de Claude Counter. Claude Code guarda un registro privado de tu uso real en tu Mac — conéctalo una vez y la app te mostrará tu ventana de sesión de 5 horas en vivo, el recuento real de tokens, los costes estimados, y podrá sincronizar tus temporizadores con el momento exacto en que Claude se restablece.

En tu Mac (una sola vez)

Antes de empezar: necesitas un Mac con Apple silicon en el que uses Claude Code — ahí es donde vive el registro de uso — con iCloud Drive activado (Configuración del Sistema > tu nombre > iCloud).

  1. Abre la Mac App Store, busca Claude Counter y haz clic en la pestaña Apps para iPhone y iPad en la parte superior de los resultados — es una app de iPad que se ejecuta en tu Mac, así que no aparece listada entre las apps de Mac. Instálala
  2. Abre la app y ve a la Pestaña 2 (Uso)
  3. Toca Conceder acceso
  4. En la ventana de carpetas que se abre, pulsa Command+Shift+G, escribe ~/.claude, pulsa Return y haz clic en Abrir
  5. Sabrás que ha funcionado cuando la pestaña Uso se llene con tus recuentos de tokens, más una cuenta atrás en vivo de 5 horas si has enviado mensajes a Claude Code en las últimas 5 horas. Si aparece «Esa carpeta no tiene registros de Claude Code», toca Cambiar carpeta en la parte inferior de la pestaña y elige ~/.claude de nuevo

En tu iPhone o iPad

  • Inicia sesión con la misma cuenta de iCloud que tu Mac, con iCloud Drive activado (Ajustes > tu nombre > iCloud)
  • Abre la Pestaña 2 (Uso) y espera hasta cinco minutos la primera vez — tu Mac comparte tu uso de forma privada a través de tu propia iCloud, y tu iPhone lo recoge por sí solo. Desliza hacia abajo en la pestaña Uso para comprobarlo antes
  • Sabrás que ha funcionado cuando la parte inferior de la pestaña Uso muestre De seguido del nombre de tu Mac y la hora de su última actualización
  • Consejo: mantén Claude Counter en ejecución en tu Mac mientras trabajas — es la app que lee los registros, así que tu iPhone solo estará tan actualizado como la última actualización de la app del Mac. Si cierras la app del Mac, tu iPhone conserva la última actualización hasta que la abras de nuevo

Ejecución en Segundo Plano Sin Intervención (Opcional)

La app de Mac no necesita tener su ventana abierta — sigue leyendo tus registros y actualizando tus otros dispositivos mientras está oculta. Dos formas sencillas de hacer que funcione totalmente sin intervención:

  • Ítems de inicio: Configuración del Sistema > General > Ítems de inicio y extensiones > añade Claude Counter — se abre al iniciar sesión, y puedes ocultar la ventana y olvidarte de ella
  • Deja que Claude lo configure por ti: si usas Claude Code, pega este prompt en una sesión de tu Mac y Claude te ayudará con la configuración:
Ayúdame a configurar la app Claude Counter para que se ejecute sin intervención en segundo plano en este Mac, de modo que mantenga mis datos de uso actualizados mientras está oculta. Añade un hook SessionStart a mi ~/.claude/settings.json que ejecute el comando: open -gja "Claude Counter" para que la app se abra oculta cada vez que inicie una sesión de Claude Code. Mantén mi configuración existente intacta, explica el cambio antes de hacerlo, y valida el JSON después.

Qué Desbloquea Esto

  • Cuenta atrás en vivo de la ventana de sesión en las Pestañas 1 y 2 — ve exactamente cuándo se restablece Claude
  • Registrar y sincronizar — cuando ya hay una ventana de Claude en marcha, un solo toque registra la sesión y sitúa tus temporizadores en el momento real de restablecimiento
  • Ventanas recientes e importación — las sesiones que olvidaste registrar se pueden añadir a tu Historial con un solo toque
  • Costes estimados y Valor de la suscripción — lo que costaría tu uso con las tarifas de pago por token de la API, comparado con lo que cuesta tu plan
  • Seguimiento por modelo — etiqueta las sesiones con los modelos de Claude que realmente usas

Privacidad y Cómo Prescindir de un Mac

Tus registros nunca salen de tus dispositivos, salvo a través de tu propia iCloud privada — no se envía nada a nosotros ni a nadie más. ¿No tienes Mac? No hay problema: el seguimiento manual de sesiones funciona perfectamente sin este paso, y puedes conectar un Mac más adelante cuando quieras.

Paso 4: Comprende tus Límites de Sesión

Usuarios Free

  • 5 sesiones incluidas gratis con seguimiento
  • 1 sesión de cortesía como margen antes de la mejora a Pro
  • El recuento de sesiones de Claude Counter se restablece el día del mes en que se renueva tu suscripción a Claude (configurable por el usuario)

Usuarios Pro

  • Más sesiones al mes
  • Temporizadores personalizados
  • Widgets de pantalla de bloqueo
  • 2 semanas de prueba gratuita en todos los planes

Paso 5: Configura tus Temporizadores

Ve a Opciones (Pestaña 5) > Configuración del Temporizador para personalizar:

Temporizador de Duración de Sesión

  • Predeterminado: 5 horas (300 minutos)
  • Objetivo: controla cuánto dura tu sesión de Claude Code
  • Recomendación: ajústalo para que coincida con el tiempo límite de sesión de Claude Code

Temporizador de Guardar Progreso

  • Predeterminado: 4:45 horas (285 minutos)
  • Objetivo: te recuerda guardar tu progreso con Claude
  • Recomendación: ajústalo a un tiempo inferior a la duración de tu sesión, según tu forma de ir guardando el progreso

Paso 6: Configura tu Día de Restablecimiento

Tu recuento de sesiones se restablece mensualmente. Esto ocurre en el día del mes que hayas configurado en Configuración del Temporizador para cuando se renueva tu suscripción a Claude.

Para cambiar tu día de restablecimiento:

  1. Ve a Opciones (Pestaña 5)
  2. Toca Configuración del Temporizador
  3. Busca Día de Restablecimiento
  4. Selecciona cualquier día del 1 al 31

Paso 7: Elige tu Tema

Claude Counter incluye más de 15 preciosos temas de color.

  1. Ve a Opciones (Pestaña 5)
  2. Toca Tema y Apariencia
  3. Selecciona tu tema preferido:
    • Sistema (sigue a iOS)
    • Azul, Morado, Verde, Rosa, Dorado
    • Cobalto, Índigo, Azul Dodger
    • Naranja, Rojo, Amarillo
    • Gris, Negro, Marrón
  4. Elige el modo Claro, Oscuro o Sistema
  5. Hay muchas combinaciones, así que tómate tu tiempo para encontrar el tema que más te guste

Paso 8: Configura los Widgets de Pantalla de Bloqueo (Pro)

Los widgets de pantalla de bloqueo te permiten ver la información de la sesión sin abrir la app.

Añadir Widgets

  1. Mantén pulsada tu Pantalla de Bloqueo
  2. Toca Personalizar
  3. Toca la Pantalla de Bloqueo para editarla
  4. Toca la zona de widgets (encima o debajo de la hora)
  5. Busca Claude Counter
  6. Elige entre los widgets disponibles:
    • Temporizador de Sesión - tiempo de sesión restante
    • Guardar Progreso - tiempo hasta el recordatorio de guardado
    • Sesiones Restantes - número de sesiones disponibles
    • Días Restantes - días disponibles hasta que se renueve tu suscripción a Claude

Actualización de los Widgets

Los widgets se actualizan automáticamente mientras los temporizadores están en marcha.

Paso 9: Inicia tu Primera Sesión

¡Ya estás listo! Así es como empezar a hacer seguimiento:

Iniciar una Sesión

  1. Abre Claude Counter en la Pestaña 1 (Sesión)
  2. (Opcional) Añade una descripción de la sesión. Incluye etiquetas de proyecto o cliente para poder filtrar por palabra clave al exportar los datos
  3. (Opcional) Elige el modelo de Claude que vas a usar — se guarda junto con la sesión
  4. Toca el botón grande Iniciar Sesión
  5. Confirma que quieres iniciar una nueva sesión

Con tu Mac conectado (Paso 3): si ya hay una ventana de Claude en marcha al abrir la app, se te ofrecerá Registrar y sincronizar en su lugar — acéptalo, añade una descripción, y tus temporizadores se situarán en el momento real de restablecimiento de Claude. Esa ventana ya cuenta como una de tus sesiones, así que registrarla solo mantiene tu recuento exacto.

Qué Sucede a Continuación

  • El Temporizador de Sesión empieza la cuenta atrás
  • El Temporizador de Guardar Progreso inicia su cuenta atrás
  • El recuento de sesiones se incrementa
  • El progreso circular muestra las sesiones usadas

Durante tu Sesión

  • Mantén Claude Counter abierta o usa los widgets para controlar el tiempo
  • Recibirás un recordatorio para guardar cuando se alcance el objetivo del temporizador de guardado
  • Recibirás un recordatorio cuando se alcance el objetivo del temporizador de sesión
  • Ten en cuenta que cualquier instrucción o respuesta enviada a Claude AI después de que expire una sesión de Claude inicia automáticamente una nueva sesión

Finalizar tu Sesión

  • Si decides dejar de trabajar con Claude antes de que acabe la sesión, toca de nuevo el botón para Finalizar Sesión
  • Confirma para detener todos los temporizadores
  • El tiempo de la sesión se guarda en tu historial

Paso 10: Revisa tus Estadísticas

Después de unas cuantas sesiones, explora tus estadísticas:

  1. Ve a la Pestaña 4 (Estadísticas)
  2. Consulta tu panel de Estadísticas Rápidas
  3. Desplázate para ver los gráficos:
    • Uso por períodos de 7 días
    • Duración de sesión por fecha
    • Uso por día de la semana
    • Sesiones por hora
  4. Usa el Filtro de Período para ver:
    • Solo el período actual
    • Todos los datos históricos
    • Rangos de períodos concretos

Paso 11: Exporta tus Datos

¿Necesitas informar de tu uso o facturar a un cliente?

Exportación Rápida

  1. Ve a la Pestaña 3 (Historial) o a la Pestaña 4 (Estadísticas)
  2. Toca el botón Exportar
  3. Elige:
    • Copiar al Portapapeles - texto con formato
    • Compartir como CSV - para hojas de cálculo

Qué Incluye

  • El ID de desarrollador configurado por el usuario
  • Fechas y horas de las sesiones
  • Duración de cada sesión
  • Descripciones de las sesiones
  • Modelo de Claude usado (cuando esté configurado)
  • Estadísticas resumidas
  • Información del período

Consejo Pro: Evita Sesiones Accidentales

Los diálogos de confirmación de Claude Counter ayudan a evitar sesiones desperdiciadas:

  1. Confirmación de Inicio de Sesión - «¿Seguro que quieres iniciar una nueva sesión?»
  2. Confirmación de Fin de Sesión - «Esto detendrá todos los temporizadores. ¿Continuar?»
  3. Enfriamiento entre sesiones - breve período de espera entre sesiones

Estas medidas garantizan que solo inicies sesiones cuando realmente lo pretendes.

Mejorar a Pro

Cuando estés listo para más funciones:

  1. Ve a Opciones (Pestaña 5)
  2. Toca Suscripción
  3. Elige Mensual ($0.99) o Anual ($9.99)
  4. Completa la compra

Funciones Pro Desbloqueadas

  • Más sesiones al mes
  • Temporizadores personalizados
  • Widgets de pantalla de bloqueo
  • Todas las futuras funciones Pro

Solución de Problemas

Las Sesiones No se Cuentan

Asegúrate de tocar «Iniciar Sesión» y confirmar

Los Widgets No se Actualizan

  • Los widgets se actualizan periódicamente según iOS
  • Prueba a eliminar el widget y añadirlo de nuevo
  • Asegúrate de haber abierto la app recientemente

Los Sonidos del Temporizador No Suenan

  • Comprueba que tu iPhone no esté en modo silencio
  • Verifica los permisos de notificación en Ajustes de iOS

La Pestaña Uso Está Esperando a tu Mac

  • Abre Claude Counter en tu Mac y concede acceso a la carpeta (Paso 3) — la propia pestaña Uso del Mac debe mostrar números antes de que pueda hacerlo el iPhone
  • Asegúrate de que ambos dispositivos han iniciado sesión con la misma cuenta de iCloud y que iCloud Drive está activado
  • Espera hasta cinco minutos para la primera sincronización y luego desliza hacia abajo en la pestaña Uso para actualizar. Tu iPhone solo recibe actualizaciones mientras la app del Mac está en ejecución

«Se perdió el acceso a la carpeta» o «Esa carpeta no tiene registros de Claude Code»

  • El acceso se puede perder tras reinstalar o actualizar la app del Mac — toca Cambiar carpeta en la parte inferior de la pestaña Uso y elige ~/.claude de nuevo
  • «Sin registros de Claude Code» significa que se eligió una carpeta distinta — debe ser la carpeta oculta ~/.claude en tu carpeta de inicio. Pulsa Command+Shift+G en la ventana de carpetas y escríbela

Se Muestra «Sin Ventana Activa»

  • Una ventana solo aparece una vez que has enviado un mensaje a Claude Code — tu próximo mensaje inicia una nueva ventana de 5 horas
  • Las pestañas Sesión y Uso se comprueban cada 30 segundos mientras están abiertas; el botón Actualizar de la pestaña Uso comprueba al instante
  • En el iPhone, la cuenta atrás está tan actualizada como la última actualización de tu Mac — abre la app del Mac para ponerla al día

¿Necesitas Más Ayuda?

Visita: Guía del Usuario

Próximos Pasos

Ahora que ya está todo configurado:

  1. Empieza a hacer seguimiento de tus sesiones de Claude Code
  2. Crea temporizadores personalizados para tu flujo de trabajo (Pro)
  3. Revisa las estadísticas semanalmente para entender tus patrones
  4. Exporta informes según los necesites para facturación o gestión

¡Feliz programación!

¿Necesitas Ayuda?

Estamos aquí si tienes preguntas o te encuentras con algún problema.

Guía del Usuario Completa Página del Producto Contactar con Soporte