Presupuestos de tokens: pon un tope a lo que gastan tus agentes

No quieres enterarte después de cuántos tokens quemó un agente en una tarea larga o durante la noche. Los presupuestos de tokens fijan topes por agente, por turno y por día: se te avisa cuando un agente se acerca y, al llegar al tope, se detiene sin perder su trabajo.

Tres topes

Los presupuestos de tokens están en Settings → Orchestration → “Token budget” y vienen desactivados por defecto.

  • Por agente: toda la conversación del agente. Cada agente puede tener además su propio tope en el diálogo del agente; 0 significa sin límite.
  • Por turno: una petición y el trabajo que inicia.
  • Por día: todos los agentes juntos.
  • Escribe valores como “2M”, “500k” o “1,5 milyon”.

Cómo se cuenta

El gasto se cuenta en tokens equivalentes de entrada, leídos de las propias transcripciones de conversación de la CLI. Las lecturas de caché cuentan a 0,1× y las escrituras de caché a 1,25×, para no contar de más las conversaciones largas con caché. Funciona con Claude Code, Codex y las demás CLI de agentes que registran su uso en su propio historial.

Avisos y paradas

Un presupuesto primero te avisa y después detiene al agente.

  • Llega una notificación al 80 % de un tope; el porcentaje de aviso es configurable. Va al escritorio y a Telegram si lo tienes configurado.
  • Al llegar al tope el agente se detiene pero su conversación se conserva, así que sigue cuando subes el tope.
  • El tope diario solo detiene a los agentes que están trabajando.

Una insignia en la cabecera del agente

Una insignia en la cabecera del agente muestra el gasto hasta el momento y la media por turno. La media es una estimación de lo que costará la siguiente petición.

Cómo configurarlo

  1. 1

    Activa “Token budget” en Settings → Orchestration.

  2. 2

    Introduce los topes por agente, por turno y por día, por ejemplo 2M o 500k.

  3. 3

    Si hace falta, dale a un agente concreto su propio tope en el diálogo del agente.

  4. 4

    Sigue el gasto en la insignia de la cabecera del agente.

Preguntas

¿Un agente pierde su trabajo al llegar al tope?

No. Se detiene pero conserva su conversación, y sigue donde lo dejó cuando subes el tope.

¿Cómo se cuentan los tokens en caché?

Las lecturas de caché a 0,1× y las escrituras de caché a 1,25×. Todo se cuenta como tokens equivalentes de entrada a partir de las transcripciones de la propia CLI.

¿Con qué agentes funciona?

Con agentes de Claude Code y Codex.

¿El tope diario también detiene a los agentes inactivos?

No. Solo detiene a los agentes que están trabajando en ese momento.

¿Cuándo llega el aviso?

Por defecto al 80 % de un tope; puedes cambiar el porcentaje en los ajustes.

Funciones relacionadas

Todas las funcionesVer los 18 agentes de programación compatibles

Reúne a tus agentes en un solo escritorio.

Empieza con el plan gratuito. Descárgalo, añade la carpeta de un proyecto y abre tu primer agente.