推奨セットアップ:LaunchRepoで最良の結果を得るには、ClaudeやCodexのデスクトップアプリではなく、ターミナルでClaude Code CLIまたはCodex CLIを使うことを強くおすすめします。これは推奨するワークフローであり、異なる権限や中断のない実行を保証するものではありません。
キット自体のスタートページは1画面に収まります。クローンして、プロンプトを1つ貼り付け、リンクを開くだけです。このガイドでは同じ3つのステップを、それぞれの裏で何が起きているのかを少し補足しながら説明します。エージェントが何をしているのか、そして終わったときに何を確認すればよいのかがわかるはずです。先に全体像を知りたい場合は、仕組みのページで、これらのステップがプロダクト → エージェント → ディレクトリ → トラッカーという全体の流れのどこに位置するかを確認できます。
始める前に必要なもの
初期セットアップには、次のものが必要です。
- Git:リポジトリのクローンに使います。
- Python 3.10以降:Windows、macOS、Linuxのいずれでも構いません。ワークスペースのスクリプト、トラッカー、ローカルダッシュボードは標準ライブラリだけで書かれたPythonなので、
pip installするものも、ビルドの手順もありません。 - ファイルを読み、コマンドを実行できるコーディングエージェント:Claude Code、Codex、Cursor、またはそれに相当するツールです。このサイトには、それぞれのセットアップページがあります。たとえばClaude Code、Codex、Cursorです。ブラウザの操作は後の段階で必要になるもので、最初の3ステップでは不要です。
リポジトリそのものは、購入時に指定したアカウント宛てのGitHubの招待として届きます。以下の手順は、その招待を承諾済みであることを前提としています。
ステップ1:クローンして開く
Windowsでは、以下のコマンドのpython3の代わりにpy -3を使ってください(Python 3.10以降のコマンドがpythonの場合はそちらを使います)。ワークスペースは、OneDriveなどの同期フォルダの外にある、プライベートなローカルフォルダに置いてください。
git clone <your LaunchRepo invite URL> LaunchRepo
cd LaunchRepo
普段プロジェクトを開くのと同じ方法で、そのフォルダをエージェントで開きます。この時点では、まだ何も実行されません。いまクローンしたのは配布用リポジトリで、プレイブック、テンプレート、スクリプト、ドキュメントが入っています。あなたのプロダクト、認証情報、申請記録はここには置きません。それこそがステップ2の目的です。
ステップ2:スタート用プロンプトを貼り付ける
次のテキストを、そのままエージェントに貼り付けてください。
Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.
Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.
AGENTS.mdは、すべてのAIコーディングエージェントが最初に読むファイルです。正確な開始手順と、エージェントが行うべきチェックが書かれています。これに従って、エージェントは次のことを行います。
scripts/init-workspace.pyを使って、チェックアウトの隣にプライベートワークスペース(デフォルトでは同じ階層のフォルダ)を作成します。これにより、プロダクトのデータが共有の配布用リポジトリに置かれることはありません。- そのワークスペースの中からローカルダッシュボードを起動します。
127.0.0.1のリンクを返します。- そのあと、既定ではブラウザワーカー1つで、オンボーディングをフェーズごとに1つずつ案内します。
エージェントがリンクを返してきたら、ステップ2は成功です。何をするつもりかの説明が返ってきた場合は、実際に手順を実行するよう依頼してください。キットのルールでは、チェックは手順が存在した時点ではなく、実際に確認できた時点で初めて完了とみなされます。
ステップ3:リンクを開く
最初のセッションの残りは、ダッシュボードのタブで進めます。そこから最初のプロダクトを追加し、オンボーディング用のプロンプトをエージェントに渡し、どの掲載が公開中、審査待ち、予約済み、あなたの対応待ちなのかを確認し、今後のラン用のプロンプトをコピーします。ダッシュボードは127.0.0.1にのみバインドし、ディレクトリには一切接続しません。各画面についてはローカルダッシュボードのガイドで説明しています。
作業が終わったら、エージェントにダッシュボードの停止を頼んでください。自分でターミナルから起動した場合は、そこでCtrl+Cを押します。ワークスペースと、そこに記録されたものはすべてディスクに残ります。
手作業で進める
セットアップ自体には、エージェントは必要ありません。プロンプトによって実行されるのと同じ3つのコマンドは、次のとおりです。
python3 scripts/init-workspace.py --destination ../my-launch-workspace
cd ../my-launch-workspace
python3 scripts/dashboard.py
ワークスペースを作る前に、まず様子を見てみたいですか? python3 scripts/dashboard.py --demoを実行すると、架空のプロダクトがいくつか入った使い捨てのサンプルワークスペースが起動します。自分のデータに触れることなく、概要画面、プロダクトページ、カタログをクリックして見て回れます。
次のステップ
本格的な最初のセッション(プロダクトブリーフ、ブラウザの接続、権限、保存されたランの目標)はエージェントが主導します。詳しくは最初のセッションのオンボーディングガイドを参照してください。エージェントがフォームに入力できるようにするには、エージェントをChromeに接続する必要もあります。先に読み物として流れをつかみたい場合は、Claude Codeのウォークスルーで1つのローンチを最初から最後まで追えます。オンボーディングが終わったら、ローンチランを最初から最後までで、権限の確認から残りのプラットフォームの再開まで、以降のランがどのように進むかを確認できます。