# ランナーの使用量と無料分数

> マネージドランナーの分数がどのように計測されるか、無料枠が何をカバーするか、使用量がどこに表示されるか、そして無料分数が尽きると何が起こるかを説明します。

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

## Summary

- ジョブごとに切り上げて分単位で課金: small $0.0025 から xlarge $0.0200 まで。カスタムランナーは xlarge のレート。
- 無料分数は毎月1日にリセットされます（プランごとに 2,000/4,000/6,000）。超過分のみ課金されます。
- Latchkey CLI やエージェントからのワンオフジョブもまったく同じように計測され、同じ無料分数プールを使用します。その支出は Cost Analysis 上に **CLI Jobs** の項目として表示されます。
- カード未登録のワークスペースは 80% と 100% で警告され、使い切ると新しいジョブがブロックされます。サブスクリプションは超過分を計測します。

## 計測の仕組み

- 使用量は**ジョブごとに切り上げて分単位で**課金されます。`latchkey-small` での90秒のジョブは2分です。
- 各サイズには独自のレートがあります: 1分あたり small $0.0025、medium $0.0050、large $0.0100、xlarge $0.0200。カスタム構成のランナーは xlarge のレートで課金されます。
- ジョブが実際にランナーを占有している時間のみが課金されます。ジョブは4時間のランナー寿命によって上限が設けられています。
- self-healing に別途料金はかかりません。heal 中の追加ランタイムはランナーの標準の分単位レートで課金されます。
- [Latchkey CLI](/documentation/latchkey-cli) や MCP の `run_job` ツールからのワンオフジョブも同じように計測されます: 同じ分単位レート、同じ無料分数プール、ジョブごとの切り上げです。デフォルトのタイムアウトは30分で、2時間まで延長でき、キュー待ち時間は決して課金されません。
- 超過分はプランと同じ月次 Stripe 請求書に従量制の項目として計上されます。

切り上げは月ごとではなくジョブごとに行われます。これはジョブが短い場合に重要です。61秒のジョブは2分として課金されるため、多数の1分ジョブに分散する workflow は、合計の実時間が示唆するよりも目に見えて速く分数を消費します。これがゲージ上で見えるようになったら、非常に短いジョブをまとめることが対策になります。

## 無料枠

| プラン | 月あたりの無料ランナー分数 |
| --- | --- |
| Developer | 2,000 |
| Launch | 4,000 |
| Scale | 6,000 |
| Enterprise | カスタム |

無料分数は暦月の初日にリセットされます。無料枠内の分数は無料です。それを超える使用量のみが分単位のレートで課金されます。

## 計算例

以下の数字は例示であり、レートと枠は実際のものです。**Launch**（無料分数4,000）のチームが、1か月に `latchkey-small` を6,000分実行したとします:

| 項目 | 金額 |
| --- | --- |
| `latchkey-small` で計測された分数 | 6,000 |
| Launch の無料枠 | 最初の4,000分は無料 |
| 課金対象の分数 | 6,000 - 4,000 = 2,000 |
| $0.0025/min での超過分 | 2,000 x $0.0025 = $5.00、月次請求書の従量制項目として |

サイズはこれを線形にスケールします。同じ6,000分でも `latchkey-medium`（$0.0050/min）なら超過分は $10.00、`latchkey-large`（$0.0100/min）なら $20.00 になります。下の計算ツールで、あなた自身の数字で同じ計算を実行できます。

## コストを見積もる

## 使用量を確認する場所

- **請求モーダル**には、無料枠の進捗バー、今期の合計分数と課金対象分数、そしてこれまでの推定ランナーコストが表示されます。
- **Latchkey Runners** ページには、フリート全体のコスト、GitHub ホスト型と比較した推定節約額、無料枠の消費量が表示されます。
- **Cost Analysis** ページは、Latchkey ランナーの支出を GitHub の支出と並べて追跡し、両方の無料枠ゲージを含みます。
- [Latchkey CLI](/documentation/latchkey-cli) やエージェントから開始されたジョブは、[Cost Analysis](/documentation/cost-analysis) に独自の **CLI Jobs** 項目として表示されます。個々のジョブは CLI 自体から追跡してください（`latchkey status`、`latchkey logs`）。

## 無料分数を使い切る

- カード未登録のワークスペースは、含まれる分数の **80%** と、再び **100%** の時点で警告されます。警告は 1 日に最大 1 回です。
- **サブスクリプションが登録されている場合:** ジョブは動作し続け、超過分が請求書に計測されます。厳格な支出上限はありません。
- **カードなしトライアルの場合:** 無料分数を使い切ると、購読するまで新しいマネージドランナージョブがブロックされます。ブロックされたジョブは GitHub 上でキューに残り（GitHub UI にエラーは出ません）、「Managed runner blocked」通知が送られます。

### タイムラインの概要

100% ではなく 80% の警告を判断のポイントとして扱ってください。枠の5分の1がまだ残っており、使用量を切り詰める（[Cost Analysis](/documentation/cost-analysis) ページで支出の出どころがわかります）か、超過を承知の上で受け入れる余地があります。サブスクリプションが登録されていれば厳格な支出上限はないため、受け入れることも完全に有効な選択です。ただし、それは選ばれたものであるべきです。

### 起動がブロックされている場合

1. **無料分数のゲートであることを確認する** ブロックされたジョブはエラーなしで GitHub 上のキューに残り、「Managed runner blocked」通知が送られます。無料枠ゲージ（請求モーダルまたは Runners ページ）が状態を確認します: カードなしトライアルで 100% 使用。
2. **購読してブロックを解除する** 購読するまで新しいマネージドランナージョブはブロックされるため、サブスクリプションを追加することが直接の解決策です。登録されていれば、無料枠を超える使用量はブロックせず、単に請求書に計測されるだけになります。
3. **または月次リセットまでつなぐ** 無料分数は暦月の初日にリセットされます。それまでは、緊急の workflow を GitHub ホスト型のラベルに戻して指すことができます。これらは `latchkey-*` ラベルと並んでずっと動作し続けます。

> ****
> ジョブが予期せずキューに残り、ワークスペースがトライアル中の場合は、まず無料枠ゲージを確認してください。ランナーの起動がブロックされる最も一般的な理由です。

### ランナーの利用時間はどのように計測されますか?

分単位で、ジョブごとに切り上げられます。small の 1 分 $0.0025 から xlarge の $0.0200 までで、カスタムランナーは xlarge の料金で計測されます。切り上げはジョブ単位のため、非常に短いジョブが多いと実際の合計分数より高くなります。

### 無料枠の分数はいつリセットされますか?

毎月 1 日にリセットされ、プランに応じて 2,000 分、4,000 分、6,000 分です。課金対象は無料枠を超えた分のみなので、枠内に収まった月はランナー時間の費用はかかりません。

### CLI やエージェントのジョブも同じ無料枠を使いますか?

はい。Latchkey CLI や AI エージェントから起動した単発ジョブも同じ方法で計測され、同一の月間プールを消費します。その支出は Cost Analysis 上に CLI Jobs の行として別途表示されるため、ワークフローのコストに埋もれずに確認できます。

---

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