セットアップ — 初心者のコンピュータを準備する
この学生は初心者です。学生の言葉で、短い文で、1ステップずつ説明してください。 確認作業は自分で行い、インストール前には毎回許可を求めてください。パスワードを代わりに入力しないでください。
0. 正しいフォルダですか?
このコマンドはスタジオフォルダ内で実行する必要があります(スタジオフォルダには CLAUDE.md と video-projects/_library/ があります)。
別の場所にいる場合は、フォルダを見つけるか、学生にクローンした場所を尋ねて、cd で移動してください。
1. 何がインストールされているか確認する
OS(Windows / macOS / Linux)を確認し、以下のコマンドを実行してください。生の出力は表示せず、短いリストで示してください。
| 確認項目 | コマンド | 必要? | 一言で説明 |
|---|---|---|---|
| Git | git --version | はい | このスタジオとそのアップデートをダウンロードするために必要 |
| Node.js 22 以上 | node --version | はい | HyperFrames を実行するために必要 |
| npm | npm --version | はい | Node.js に付属 |
| FFmpeg + FFprobe | ffmpeg -version, ffprobe -version | はい | フレームと音声を結合してMP4にするために必要 |
| 空きディスク容量 | (doctor が表示します) | 約3GB | ツールと動画のために必要 |
次のように表示してください:
✓ Git
✗ Node.js — インストールされていません(必要:HyperFrames を実行するため)
✓ FFmpeg
すべて ✓ の場合はその旨を伝え、ステップ3に進んでください。
2. 不足しているものをインストールする — 1つずつ、先に許可を取る
各 ✗ について:それが何か(1行)、無料であること、おすすめすること、そして「インストールしますか?」と尋ねてください。はいの返事を待ってください。
Windows(winget は Windows 10/11 に組み込まれています):
- Node.js:
winget install -e --id OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements - FFmpeg:
winget install -e --id Gyan.FFmpeg --accept-package-agreements --accept-source-agreements - Git:
winget install -e --id Git.Git --accept-package-agreements --accept-source-agreements - Windows が「このアプリがデバイスに変更を加えることを許可しますか?」と表示した場合は、「はい」 をクリックするよう伝えてください。
winget自体がない場合:https://nodejs.org(LTSボタン)、https://git-scm.com に誘導し、FFmpeg については「Microsoft Store から App Installer をインストールしてから、もう一度試します」と伝えてください。
macOS(Homebrew を使用):
brew --versionを確認してください。ない場合は、学生自身がインストーラを実行する必要があります(Macのパスワードが必要なため)。次のように伝えてください:「ターミナルアプリを開き、https://brew.sh のコマンドをコピーして貼り付け、Enterを押し、Macのパスワードを入力してください(入力中は画面に表示されませんが、正常です)。完了したら教えてください。」- その後:
brew install node ffmpeg git
Linux: パスワードが必要なため、学生が自分のターミナルで実行します:
sudo apt install -y git ffmpeg。Node.js 22+ については、https://nodejs.org のLTSインストーラをおすすめしてください。
何かをインストールした後: 新しいプログラムはこのClaudeウィンドウからはまだ見えません。次のように伝えてください:「Claude Code を完全に閉じて、同じフォルダでもう一度開き、/setup と入力してください。ここから続けます。」その後、停止して待機してください。(学生が戻ってきたら、ステップ1で新しい ✓ が表示されます。)
3. スタジオ独自のパーツをインストールする
それぞれの機能とおおよそのサイズを説明し、順番に実行してください:
npm install— HyperFrames をこのフォルダにダウンロードします(約120MB、約1分)。npx hyperframes skills— Claude に公式の HyperFrames ルールを教えます(小さい)。先に許可を取ってください:この操作により、このコンピュータに Claude 用のスキルがインストールされます。npx hyperframes browser ensure— 動画作成専用のプライベートなChromeのコピーをダウンロードします(約150MB)。通常のブラウザには影響しません。npx hyperframes doctor— 最終確認です。重要な赤色の項目だけ説明してください:Node.js、FFmpeg、FFprobe、Chrome が ✓ である必要があります。以下は オプションのため無視してください:新しいバージョンが利用可能、whisper-cpp(自動キャプション)、MusicGen(AI音楽)、Docker。
npx hyperframes skills の後:新しいスキルは新しいセッションで読み込まれます。次のように伝えてください:「Claude Code を閉じて、このフォルダでもう一度開き、/setup と入力してください。テスト動画から続けます。」
4. 動作確認:3秒のテスト動画
インターネット接続が必要です(アニメーションライブラリがWebから読み込まれます)。次のコマンドを1行ずつ実行してください(PowerShellでは && は使えません):
mkdir my-videos
cd my-videos
npx hyperframes init hello-test --example blank --resolution portrait --non-interactive
cd hello-test
blank サンプルは10秒で「Title」と表示されます。index.html 内で:テキストを学生の名前または「Hello」に変更し、両方の data-duration="10" を 3 に設定し、フェードインを追加します(tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);)。さらに window.__timelines の行の前に tl.set({}, {}, 3); を追加します。その後:
npx hyperframes lint
npx hyperframes render --quality draft
my-videos/hello-test/renders/ にあるMP4ファイルを見つけ、場所を伝え、開くことを提案してください。
失敗した場合は、エラーを読み、修正し、再試行してください。壊れた状態のまま渡さないでください。
5. 完了
簡潔に伝えてください:
- 「セットアップは完了しました。動画は
my-videosフォルダに保存されます。」 - 「動画を作成するには、
/new-videoと入力してください。」 - 「次回は、同じフォルダで Claude Code を開いてください。」使用したフォルダのフルパスを伝え、以下の方法も説明してください:
- Claude デスクトップアプリ: コードタブ → フォルダを選択/開く → そのフォルダを選択。
- ターミナル:
cd "<フルパス>"してからclaude。
- Windows の場合、「ドキュメント」は実際には OneDrive 内にある場合があります(
OneDrive\Documents)。実際にクローンされた場所を確認し、正確なパスを伝えてください。