🖥️ Windows 環境 再構築 Runbook¶
📁 docs/ops/runbook/windows.md
[!IMPORTANT] 最終検証日: 2026-07-13 環境変更時（OS再インストール・ドライバ更新・ツール追加）は必ずこの日付を更新すること。
対象環境¶
| 項目 | 仕様 |
|---|---|
| OS | Windows 11 |
| CPU | （デスクトップ PC） |
| GPU | RTX 5070 Ti (16GB VRAM) |
| RAM | 64GB |
| 主な用途 | LoRA学習・画像生成・GPU依存処理 |
⚡ クイックスタート（全ステップ一覧）¶
Phase 1: OS・基本設定
Phase 2: GPU ドライバ・CUDA
Phase 3: 開発ツール（Git・Python・Node.js）
Phase 4: AI ツール（Claude Code・1Password）
Phase 5: MyLab セットアップ
Phase 6: GPU 依存ツール（SD WebUI Forge・twscrape WSL2）
Phase 7: タスクスケジューラ設定
Phase 1: OS・基本設定¶
1-1. Windows Update¶
1-2. 基本ツール¶
# winget でまとめてインストール
winget install Microsoft.WindowsTerminal
winget install Microsoft.PowerShell
winget install 7zip.7zip
winget install Google.Chrome
1-3. 開発者モード有効化¶
「設定」→「プライバシーとセキュリティ」→「開発者向け」→「開発者モード: ON」
Phase 2: GPU ドライバ・CUDA¶
2-1. NVIDIA ドライバ¶
- NVIDIA ドライバダウンロード から最新版をダウンロード
- RTX 5070 Ti を選択してダウンロード・インストール
- 再起動後に
nvidia-smiで確認
2-2. CUDA Toolkit（オプション）¶
SD WebUI Forge 等の一部ツールは PyTorch 経由で CUDA を使用するため、個別インストール不要な場合が多い。
Phase 3: 開発ツール¶
3-1. Git¶
winget install Git.Git
# インストール後、新しいターミナルを開く
git --version
git config --global user.name "KZ55230"
git config --global user.email "73998660+KZ55230@users.noreply.github.com"
3-2. Python（pyenv-win）¶
# pyenv-win インストール
winget install pyenv-win.pyenv-win
# 新しいターミナルを開く
pyenv install 3.12.9
pyenv global 3.12.9
python --version # 3.12.9 を確認
3-3. Node.js¶
Phase 4: AI ツール・認証¶
4-1. 1Password¶
4-2. 1Password CLI（op）¶
winget install AgileBits.1Password.CLI
# サービスアカウントトークンの設定
$env:OP_SERVICE_ACCOUNT_TOKEN = "（1Password から取得）"
# ~/.config/op/ に保存
New-Item -Path "$HOME\.config\op" -ItemType Directory -Force
"（トークン）" | Set-Content "$HOME\.config\op\service_account_token"
4-3. Claude Code¶
4-4. GitHub CLI¶
Phase 5: MyLab セットアップ¶
5-1. リポジトリのクローン¶
5-2. Python 仮想環境¶
5-3. Credentials ディレクトリ（1Password から復元）¶
# 1Password から各認証情報を取得して Credentials/ に配置
# または op CLI で自動取得スクリプトを実行
python scripts/setup_credentials.py # （存在する場合）
5-4. 環境変数設定¶
# GH_TOKEN の設定
$ghToken = op read "op://MyLab/MyLab - Github Pat/token"
[System.Environment]::SetEnvironmentVariable("GH_TOKEN", $ghToken, "User")
Phase 6: GPU 依存ツール¶
6-1. SD WebUI Forge¶
[!NOTE] SD WebUI Forge は Python 仮想環境と CUDA ドライバを必要とする。
# リポジトリのクローン
git clone https://github.com/lllyasviel/stable-diffusion-webui-forge.git
cd stable-diffusion-webui-forge
# 起動（初回は依存関係をインストール）
.\webui-user.bat
6-2. WSL2（twscrape 用）¶
# WSL2 を有効化
wsl --install -d Ubuntu-22.04
# 再起動が必要
# WSL2 内でのセットアップは wsl2.md を参照
wsl -d Ubuntu-22.04
Phase 7: タスクスケジューラ設定¶
7-1. 現在のスケジュール一覧¶
| タスク名 | スクリプト | 実行タイミング |
|---|---|---|
| （未設定） | — | — |
[!TIP] タスクスケジューラに新しいタスクを追加するときは、上記の表を更新すること。
7-2. スケジュールの登録方法¶
# PowerShell でタスクを登録する例
$action = New-ScheduledTaskAction -Execute "python" `
-Argument "C:\Users\kazuma\MyLab\scripts\example.py"
$trigger = New-ScheduledTaskTrigger -Daily -At "07:00"
Register-ScheduledTask -TaskName "MyLab Example" -Action $action -Trigger $trigger
🔧 トラブルシューティング¶
GPU が認識されない¶
# デバイスマネージャーで確認
devmgmt.msc
# ドライバを再インストール
# Device Manager → Display adapters → NVIDIA GeForce RTX 5070 Ti → Update driver
pyenv が動かない¶
# PATH を確認
$env:PATH
# pyenv-win の PATH を手動追加（PowerShell プロファイル）
$profile に以下を追加:
$env:PATH = "$HOME\.pyenv\pyenv-win\bin;$HOME\.pyenv\pyenv-win\shims;" + $env:PATH