# Quickstart: ゼロからダッシュボードまで

> GitHub でサインインし、組織に GitHub App をインストールし、リポジトリを選択して、最初の CI 分析を確認します。約 5 分で完了します。

Source: https://latchkey.dev/ja/documentation/quickstart

## Summary

- GitHub でサインインし、組織にアプリをインストールし、リポジトリを選択: 約 5 分で、30 日間トライアルは自動的に始まります。
- バックフィルは直近 30 日間の完了済み実行をインポートするため、ダッシュボードは数分で埋まります。AI Insight の検出結果は毎晩の分析で追加されます。
- 任意の最初のランナージョブ: 1 行を `runs-on: latchkey-small` に変更するだけです。

これは、何もない状態から動作する Latchkey ダッシュボードまでの最速の道のりです。この過程でリポジトリやワークフローに触れるものは何もありません。このページで唯一のコード変更は、終盤にある任意の 1 行の `runs-on:` の切り替えだけです。

**始める前に**
- [ ] GitHub の **組織** がある (個人アカウントはサポートされていません)
- [ ] その組織に対する owner または admin 権限がある
- [ ] デスクトップブラウザを使用している (ダッシュボードはデスクトップ専用です)

1. **GitHub でサインイン** [latchkey.dev/sign-in](https://latchkey.dev/sign-in) にアクセスし、GitHub アカウントでサインインします。監視したい組織にアクセスできる GitHub アカウントを使用してください。次のステップのアプリのインストールはこのアイデンティティで行われ、アプリをインストールした人がワークスペースの owner になります。サインインするとダッシュボードの **Get started** カード (「Welcome to Latchkey」) に到着し、30 日間トライアルはすでに開始されています。クレジットカードは不要です。途中で中断された場合は、もう一度サインインするだけで、セットアップは中断したところから再開します。
2. **GitHub を接続** Get started カードのステップ 1 は **Connect GitHub** です。クリックすると、Latchkey はアプリをインストールするために GitHub へ移動させます (その前に、何が起こるかを説明する短い中間画面が表示されます)。GitHub がインストール先を尋ねたら、**組織** を選択してください (個人アカウントではありません)。組織に対する owner または admin 権限が必要です。どちらもない場合は、組織の owner にアプリのインストールを依頼するか、admin 権限を付与してもらってください。アプリがアクセスできるものとできないものについては [GitHub App をインストールする](/documentation/install-the-github-app) で説明しています。
3. **監視するリポジトリを選択** Get started カードのステップ 2 **Select repositories** はリポジトリピッカーを開きます。ここには検索と可視性フィルターとともに組織のリポジトリが一覧表示されます。Latchkey に監視させたいものを選択してください。カウンターにはプランで許可される数が表示されます (すべての新規ワークスペースが開始する Launch は 10。後でプランを変更した場合、Developer は 1、Scale は 40)。選ぶ際に知っておくとよいことが 2 つあります。マネージドランナーは監視対象のリポジトリのみを扱うため、`latchkey-*` ラベルを向ける予定のリポジトリは含めてください。また、「Skip for now, explore the dashboard first」リンクでこの選択を後回しにし、後でダッシュボードからリポジトリを追加することもできます。プラン上限内で選ぶ際のガイダンスは [リポジトリの管理](/documentation/managing-repositories) にあります。
4. **ダッシュボードが埋まるのを見る** セットアップ後、ダッシュボードの短いガイド付きツアーが提示されます。いつでもスキップできます。有効にした各リポジトリについて、Latchkey は直近 30 日間の完了済みワークフロー実行をバックフィルするため、ほとんどのチームは数分でデータを確認できます。バックフィルの実行中は進捗バナーが表示されます。ページが空に見える場合は、まず上部のフィルターバーを確認してください。分析ページは選択したリポジトリのデータを表示し、何も選択されていない場合は 1 つ選ぶよう促します。
5. **任意: Latchkey ランナーでジョブを実行** 任意のワークフローの 1 行を変更して、マネージドな自己修復ランナーを試します。push すると、ランナーがピックアップするまでジョブは GitHub 上でキュー待機と表示されます。ウォームなランナーがある場合は数秒、新しいランナーがコールドスタートする場合は約 10 秒です。ジョブがどこで実行されたかを確認する方法を含む完全な手順は [最初のジョブを実行する](/documentation/run-your-first-job) にあります。
6. **任意: チームを招待** Developer を除くすべてのプランでは、ダッシュボードのサイドバーで **Team** を開き、メールまたは共有リンクでチームメイトを招待します (Developer プランは個人利用向けのため、そこでは招待は利用できません)。招待では Admin または Member ロールが付与されます。[チームとロール](/documentation/team-and-roles) をご覧ください。

## 最初の 1 時間に予想されること

オンボーディング完了後の典型的な流れは次のとおりです。何が正常で、何を再確認する価値があるかがわかります。

> **何も表示されない？**
> ダッシュボード上部のフィルターバーでリポジトリが選択されていること、有効にしたリポジトリが直近 30 日間に実際にワークフローを実行したこと、そして日付範囲フィルターがそのアクティビティと重なっていることを確認してください。詳細は [トラブルシューティング](/documentation/troubleshooting) にあります。

## ここからどこへ進むか

- **ダッシュボードを学ぶ** レイアウト、サイドバーのすべての行き先、フィルターバー、そして Latchkey が何をしているかを示すバナー。
- **ジョブをランナーへ移す** 1 行の変更、ピックアップの仕組み、そしてジョブがどこで実行されたかを確認する方法。
- **通知を設定する** パイプラインの破損、コストの急増、トライアルの警告をメール、Slack、またはブラウザへ振り分けます。
- **AI エージェントを接続する** Claude Code、Cursor、または任意の MCP クライアントに、CI の失敗へのアクセスと、オプトインのワークフロー再実行、新しいランナーでの単発ジョブ実行を与えます。

### Latchkey のセットアップにはどれくらいかかりますか?

約 5 分です。GitHub でサインインし、Organization にアプリをインストールして、リポジトリを選択します。30 日間のトライアルは別途の手続きなく自動的に開始します。

### ダッシュボードにデータが表示されるまでどれくらいかかりますか?

数分です。リポジトリを選択すると直近 30 日分の完了済みワークフロー実行がインポートされるため、新しいビルドを待たずにコストとパフォーマンスのダッシュボードが埋まります。AI Insight の分析結果は次回の夜間処理で届きます。

### Latchkey ランナーで最初のジョブを実行するには?

ワークフローの 1 行を変更します。`runs-on` の値を `latchkey-small` に置き換えてください。steps、actions、secrets、services、matrix はそのままで、GitHub ホスト型のラベルも同じワークフロー内で引き続き動作するため、ジョブ単位で段階的に移行できます。

---

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