# Uso de runner e minutos gratuitos

> Como os minutos de runner gerenciado são medidos, o que o nível gratuito cobre, onde o uso aparece e o que acontece quando os minutos gratuitos acabam.

Source: https://latchkey.dev/pt/documentation/runner-usage-and-free-minutes

## Summary

- Cobrado por minuto, arredondado para cima por job: small $0.0025 a xlarge $0.0200; runners personalizados na taxa do xlarge.
- Os minutos gratuitos reiniciam no dia 1 de cada mês (2.000/4.000/6.000 por plano); só o excedente é cobrado.
- Jobs avulsos do Latchkey CLI ou de um agente são medidos de forma idêntica, do mesmo pool de minutos gratuitos; o gasto deles aparece como uma linha **CLI Jobs** no Cost Analysis.
- Workspaces sem cartão recebem avisos em 80% e 100% e bloqueiam novos jobs quando esgotados; assinaturas medem o excedente.

## Como funciona a medição

- O uso é cobrado **por minuto, arredondado para cima por job**. Um job de 90 segundos no `latchkey-small` são 2 minutos.
- Cada tamanho tem sua própria taxa: small $0.0025, medium $0.0050, large $0.0100, xlarge $0.0200 por minuto. Runners de configuração personalizada são cobrados na taxa do xlarge.
- Somente o tempo em que seu job realmente ocupa o runner é cobrado; os jobs são limitados pela vida útil de 4 horas do runner.
- O self-healing não tem taxa separada: o tempo de execução extra durante um heal é cobrado na taxa padrão por minuto do runner.
- Jobs avulsos do [Latchkey CLI](/documentation/latchkey-cli) ou da ferramenta MCP `run_job` são medidos da mesma forma: mesmas taxas por minuto, mesmo pool de minutos gratuitos, arredondado para cima por job. Eles têm por padrão um timeout de 30 minutos, extensível a 2 horas, e o tempo de fila nunca é cobrado.
- O excedente aparece como itens de linha medidos na mesma fatura mensal do Stripe do seu plano.

O arredondamento acontece por job, não por mês, o que importa quando os jobs são curtos: um job de 61 segundos é cobrado como 2 minutos, então um workflow que se divide em muitos jobs de um minuto consome minutos visivelmente mais rápido do que seu tempo total de relógio sugere. Se isso alguma vez ficar visível no seu medidor, consolidar jobs muito curtos é a alavanca.

## O nível gratuito

| Plano | Minutos gratuitos de runner por mês |
| --- | --- |
| Developer | 2.000 |
| Launch | 4.000 |
| Scale | 6.000 |
| Enterprise | Personalizado |

Os minutos gratuitos reiniciam no primeiro dia de cada mês do calendário. Os minutos dentro do nível gratuito não custam nada; só o uso além dele é cobrado nas taxas por minuto.

## Um exemplo prático

Os números abaixo são ilustrativos; as taxas e franquias são as reais. Digamos que uma equipe no **Launch** (4.000 minutos gratuitos) execute 6.000 minutos de `latchkey-small` em um mês:

| Linha | Valor |
| --- | --- |
| Minutos medidos no `latchkey-small` | 6.000 |
| Nível gratuito do Launch | Os primeiros 4.000 minutos sem custo |
| Minutos cobráveis | 6.000 - 4.000 = 2.000 |
| Excedente a $0.0025/min | 2.000 x $0.0025 = $5.00, como itens de linha medidos na fatura mensal |

O tamanho escala isso linearmente: os mesmos 6.000 minutos no `latchkey-medium` ($0.0050/min) dariam $10.00 de excedente, e no `latchkey-large` ($0.0100/min) $20.00. A calculadora abaixo faz a mesma aritmética com seus próprios números.

## Estime seu custo

## Onde ver o uso

- O **modal de cobrança** mostra uma barra de progresso do nível gratuito, o total e os minutos cobráveis deste período, e o custo estimado de runner até agora.
- A página **Latchkey Runners** mostra o custo em nível de frota, a economia estimada versus os hospedados no GitHub e o consumo do nível gratuito.
- A página **Cost Analysis** acompanha o gasto com runners Latchkey junto com seu gasto no GitHub, incluindo medidores do nível gratuito para ambos.
- Jobs iniciados a partir do [Latchkey CLI](/documentation/latchkey-cli) ou de um agente aparecem no [Cost Analysis](/documentation/cost-analysis) como sua própria linha **CLI Jobs**; acompanhe jobs individuais a partir do próprio CLI (`latchkey status`, `latchkey logs`).

## Ficando sem minutos gratuitos

- Workspaces sem cartão registrado são avisados em **80%** e novamente em **100%** dos minutos incluídos, no máximo uma vez por dia.
- **Com uma assinatura registrada:** os jobs continuam rodando e o excedente é medido na sua fatura. Não há limite rígido de gasto.
- **Em um teste sem cartão:** uma vez esgotados os minutos gratuitos, novos jobs de runner gerenciado são bloqueados até você assinar. Jobs bloqueados permanecem na fila do GitHub (sem erro na interface do GitHub) e uma notificação "Managed runner blocked" é enviada.

### A linha do tempo em resumo

Trate o aviso de 80% como o ponto de decisão, e não o de 100%: ainda resta um quinto do nível, o que dá espaço para reduzir o uso (a página [Cost Analysis](/documentation/cost-analysis) mostra de onde vem o gasto) ou aceitar o excedente conscientemente. Com uma assinatura registrada não há limite rígido de gasto, então aceitar é uma resposta perfeitamente válida; só precisa ser uma escolha deliberada.

### Se os lançamentos estiverem bloqueados

1. **Confirme que é a barreira de minutos gratuitos** Jobs bloqueados ficam na fila do GitHub sem erro, e uma notificação "Managed runner blocked" é enviada. O medidor do nível gratuito (no modal de cobrança ou na página Runners) confirma o estado: 100% usado em um teste sem cartão.
2. **Assine para remover o bloqueio** Novos jobs de runner gerenciado são bloqueados até você assinar, então adicionar uma assinatura é a correção direta; com uma registrada, o uso além do nível gratuito simplesmente é medido na sua fatura em vez de bloquear.
3. **Ou faça uma ponte até o reinício mensal** Os minutos gratuitos reiniciam no primeiro dia do mês do calendário. Até lá, workflows urgentes podem apontar de volta para labels hospedados no GitHub, que continuam funcionando lado a lado com labels `latchkey-*` o tempo todo.

> ****
> Se um job inesperadamente ficar na fila e seu workspace estiver em teste, verifique o medidor do nível gratuito primeiro; é o motivo mais comum de um lançamento de runner ser bloqueado.

### Como os minutos de runner são medidos?

Por minuto, arredondados para cima por job, de US$ 0,0025 no small a US$ 0,0200 no xlarge; runners personalizados são medidos pela tarifa xlarge. O arredondamento é por job, então muitos jobs muito curtos custam mais do que os minutos brutos sugerem.

### Quando os minutos gratuitos são renovados?

No dia primeiro de cada mês, em 2.000, 4.000 ou 6.000 minutos conforme o plano. Só o uso acima da cota é cobrado, então um mês que fique dentro da cota não custa nada em minutos de runner.

### Jobs da CLI e de agentes usam os mesmos minutos gratuitos?

Sim. Jobs avulsos iniciados pela CLI do Latchkey ou por um agente de IA são medidos da mesma forma e consomem o mesmo pool mensal. O gasto deles aparece separado como uma linha CLI Jobs na Cost Analysis, para você enxergá-lo sem que fique escondido nos custos de workflow.

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt