Saltar al contenido
KendorDocs

Fija presupuestos de tokens para los agentes de IA

Para propietarios y editores ·

Limita lo que pueden gastar Claude Code y Codex con un presupuesto de tokens por candidato en cada prueba y un límite mensual de tokens para toda la organización.

Hay dos límites, y ambos son opcionales. Un Presupuesto de tokens por candidato en una prueba limita lo que puede gastar el agente de un candidato en esa prueba. Un Límite mensual de tokens en Integraciones limita lo que pueden gastar todos los candidatos juntos en un mes natural. Cuando se agota cualquiera de los dos, la siguiente llamada del agente se rechaza con un mensaje claro en la terminal. Si no hay ninguno definido, el gasto solo lo limita la cuenta de tu proveedor.

Qué cuenta como token

Ambos límites cuentan lo que el agente lee y escribe: la nueva entrada enviada al modelo más la salida del modelo. El contexto en caché no se cuenta. Los agentes de programación vuelven a enviar toda la conversación en cada turno, y esa parte repetida se sirve desde la caché del proveedor, así que de lo contrario consumiría el presupuesto sin reflejar trabajo nuevo.

Claude Code y Codex consumen del mismo presupuesto. Un candidato que usa ambos gasta de un único total. Los presupuestos solo se aplican con las claves de tu organización: con la cuenta propia del candidato, Kendor no cuenta tokens.

Presupuesto por candidato en una prueba

Los editores y los propietarios lo definen en el constructor de pruebas, junto al interruptor que activa los agentes.

  1. Activa Asistentes de IA en la terminal en Opciones, en el panel de configuración.
  2. Introduce un número en Presupuesto de tokens por candidato. La unidad son los millones de tokens, así que 1 significa un millón y 0.5 medio millón.
  3. Deja el campo vacío para no poner límite. El panel te lo recuerda entonces: «Sin límite. El gasto de un candidato solo lo limita tu cuenta con el proveedor.»

El presupuesto es por intento del candidato y se suma entre todos los retos de la prueba, así que una prueba de tres retos con un presupuesto de 2 da al candidato 2 millones de tokens en total, no 2 millones por reto. El uso se conserva cuando se reinicia el sandbox o el candidato vuelve más tarde, así que reiniciar no lo restablece.

Puedes cambiar el presupuesto mientras hay candidatos en plena prueba. Los sandboxes en ejecución recogen el nuevo límite de inmediato.

Qué ve el candidato

Un pequeño anillo en la cabecera del editor se va llenando mientras trabaja el agente. Al pasar el cursor por encima muestra, por ejemplo, «Tokens de IA: 400k de 1M usados». Se vuelve ámbar al 80 % con «Estás cerca del presupuesto de tokens de IA de esta prueba», de modo que quedarse sin presupuesto nunca es la primera señal. Cuando se agota, la información emergente dice «El presupuesto de tokens de IA de esta prueba se ha agotado».

Límite mensual de la organización

Los propietarios lo definen en la página de Claude Code o de Codex, en Integraciones → Asistentes de IA. Ambas páginas muestran el mismo campo, porque los dos agentes comparten un único límite.

  1. Introduce un número en Límite mensual de tokens, en millones de tokens.
  2. Elige Guardar.
  3. Déjalo vacío para Sin límite.

Bajo el campo ves el gasto de este mes, como «6,4M de 20M de tokens usados este mes». El mes sigue los meses naturales en UTC y vuelve a empezar de cero el día 1.

El límite abarca todas las llamadas de agentes facturadas a tus claves: los candidatos en las pruebas, las entrevistas de programación en vivo y los sandboxes de tu propio equipo en el constructor.

Consejo. Si usas la federación de identidad para Claude Code, también puedes poner un límite de gasto al workspace de Anthropic en tu Claude Console. Ese límite lo aplica Anthropic, además de los límites de Kendor.

Entrevistas de programación en vivo

Las entrevistas de programación en vivo no tienen presupuesto por candidato. El uso de agentes en una sesión en vivo cuenta solo para el Límite mensual de tokens de tu organización, así que fija uno si quieres un tope ahí.

Cuando se agota un presupuesto

El gateway de Kendor comprueba el presupuesto antes de reenviar cada llamada, incluidas las que ya se están ejecutando en paralelo. Una vez alcanzado un límite, la siguiente llamada no se envía a Anthropic ni a OpenAI, y el agente muestra uno de estos mensajes en la terminal (en inglés):

Límite alcanzado Mensaje
Presupuesto de tokens por candidato "The AI token budget for this assessment has been used up"
Límite mensual de tokens "The hiring organization's monthly AI token limit has been reached"

El turno que ya estaba en curso termina, así que el último recuento puede quedar ligeramente por encima del límite. El candidato puede seguir trabajando sin el agente: el editor, la terminal, los tests y la vista previa no se ven afectados.

Para que un candidato pueda continuar con el agente, sube el presupuesto de la prueba o el límite mensual. Los sandboxes en ejecución recogen el cambio sin reiniciarse.

Nota. Aparte de los tokens, cada sesión de sandbox tiene un límite fijo en el número de llamadas que pueden hacer los agentes. Cuando se alcanza, el agente muestra "This session has reached its AI usage limit".

Dónde se ve el uso en la revisión

En la página de revisión de una entrega, la cabecera muestra lo que usó el agente del candidato, como «IA 1.4M / 2M tokens» con presupuesto o «IA 1.4M tokens» sin él. Al pasar el cursor por encima se explica que la cifra es lo que el asistente leyó y escribió durante el intento, sin contar el contexto en caché.

El total acumulado del mes de tu organización está en las páginas de Claude Code y Codex, en Integraciones. Para ver el desglose de costes por modelo, usa tu consola de Anthropic o de OpenAI, donde se factura el uso.

¿Te ha resultado útil este artículo?