DocsプラットフォームセットアップWindowsセットアップ
ドキュメントに戻る
プラットフォームセットアップ

Windowsセットアップ

DPAPIクレデンシャルストレージでWindows上にYeePilotをインストール・設定

最終更新: 2026年2月28日

概要

YeePilotはWindows 10およびWindows 11上でx86_64とARM64の両方のネイティブバイナリで動作します。このガイドでは、インストール、PATH設定、クレデンシャルストレージ、WSL2を通じた完全なサンドボックス機能の取得方法を説明します。

システム要件

要件詳細
WindowsバージョンWindows 10（1903以降）またはWindows 11
アーキテクチャamd64（x86_64）またはarm64
ターミナルWindows Terminal（推奨）、PowerShell、またはコマンドプロンプト

インストール

バイナリのダウンロード

Windowsには自動インストールスクリプトはまだありません。リリースページ (opens in new tab)からバイナリを手動でダウンロードしてください：

  • yeepilot-windows-amd64.tar.gz -- 標準的なx86_64システム用
  • yeepilot-windows-arm64.tar.gz -- ARM64デバイス用（例：Surface Pro X、Snapdragonラップトップ）

展開とインストール

  1. ダウンロードしたアーカイブを展開します。PowerShellの組み込みWindows tar コマンドを使用できます：
powershell
tar xzf yeepilot-windows-amd64.tar.gz
  1. バイナリを恒久的な場所に移動します。一般的な選択肢は C:\Program Files\YeePilot\ です：
powershell
New-Item -ItemType Directory -Force -Path "C:\Program Files\YeePilot"
Move-Item yeepilot.exe "C:\Program Files\YeePilot\yeepilot.exe"
  1. どこからでも yeepilot を実行できるよう、ディレクトリをシステムのPATHに追加します。

PATHへの追加

システム設定から（永続的）

  1. Win + S を押して「環境変数」を検索します。
  2. システム環境変数の編集 をクリックします。
  3. 環境変数 をクリックします。
  4. ユーザー変数（またはすべてのユーザーの場合は システム変数）で Path を選択し 編集 をクリックします。
  5. 新規 をクリックし C:\Program Files\YeePilot を追加します。
  6. すべてのダイアログで OK をクリックします。
  7. 変更を有効にするために新しいターミナルウィンドウを開きます。

PowerShellから（現在のユーザー、永続的）

powershell
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$currentPath;C:\Program Files\YeePilot", "User")

このコマンドの実行後、新しいターミナルウィンドウを開いてください。

インストールの確認

powershell
yeepilot version

初期セットアップ

インタラクティブセットアップを実行してAIプロバイダーを設定します：

powershell
yeepilot setup

%USERPROFILE%\.yeepilot\config.yaml に設定ファイルが作成されます（通常は C:\Users\YourName\.yeepilot\config.yaml）。

クレデンシャルストレージ

YeePilotは Windows Data Protection API（DPAPI） を使用してAPIキーと認証トークンを安全に保存します。DPAPIはWindowsユーザーアカウントを使用してクレデンシャルを暗号化するため、ログインしている場合のみアクセスできます。

  • 追加ソフトウェアは不要です。
  • クレデンシャルはYeePilot設定ディレクトリ内の暗号化ファイルに保存されます。
  • 暗号化はWindowsユーザーアカウントに紐づけられています。同じマシンの他のユーザーは復号できません。

ターミナルの推奨事項

YeePilotのTUIには、良好なUnicodeとカラーサポートを備えた最新のターミナルが必要です。

ターミナル推奨度
Windows Terminal強く推奨。優れた色、Unicode、リサイズサポート。Microsoft Storeから入手可能。
PowerShell 7+Windows Terminal内で実行する場合は良好に動作。
コマンドプロンプト基本的なサポート。一部のTUI要素が正しくレンダリングされない場合があります。
レガシーPowerShell（5.x）動作しますが色のレンダリングに問題がある場合があります。PowerShell 7+へのアップグレードを推奨。

Windows Terminalのインストール

Windows Terminalが未インストールの場合：

powershell
winget install Microsoft.WindowsTerminal

または Microsoft Store (opens in new tab) からダウンロードしてください。

サンドボックスの制限

ネイティブWindowsはLinuxカーネル名前空間をサポートしていません。YeePilotはWindows上でプロセスレベルのリソース制限を使用し、基本的な保護を提供します：

  • CPU時間制限 -- 設定されたCPU時間を超えるとコマンドが終了。
  • メモリ制限 -- プロセスメモリが制限。
  • ファイルサイズ制限 -- 個々のファイル作成が制限。
yaml
# %USERPROFILE%\.yeepilot\config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # Windowsでは利用不可
  max_cpu_seconds: 300
  max_memory_mb: 512

完全な名前空間サンドボックス分離には、WSL2を使用してください（以下参照）。

完全なサンドボックス機能のためのWSL2

Windows Subsystem for Linux 2（WSL2） はWindows上で実際のLinuxカーネルを提供し、user、PID、mount、network分離を含むYeePilotの完全な名前空間サンドボックスを有効にします。

WSL2のインストール

WSL2が未インストールの場合：

powershell
wsl --install

デフォルトでUbuntuのWSL2がインストールされます。プロンプトが表示されたらコンピューターを再起動してください。

WSL2内でのYeePilotのインストール

WSL2ターミナルを開き、Linuxインストールスクリプトを使用してYeePilotをインストールします：

bash
curl -fsSL https://yee.to/install.sh | bash

WSL2内では、YeePilotは完全なLinux機能セットにアクセスできます：

  • 完全な名前空間サンドボックス分離
  • GNOME Keyringクレデンシャルストレージ（設定された場合）
  • ハッシュチェーン付きの改ざん検知可能な監査ログ

WSL2からWindowsファイルへのアクセス

WSL2ではWindowsドライブが /mnt/ にマウントされています：

bash
# Windowsのホームディレクトリにアクセス
ls /mnt/c/Users/YourName/
 
# Windowsでホストされているファイルに対してYeePilotを実行
yeepilot run

WSL2とネイティブWindowsの使い分け

ユースケース推奨
Linuxサーバーの管理WSL2（完全なサンドボックス、ネイティブSSH）
Windows固有の管理ネイティブWindows
最大のセキュリティWSL2（名前空間分離）
クイックタスクネイティブWindows（WSL起動時間なし）

サービスとしてのYeePilot実行

YeePilotの自動アップデートチェックをバックグラウンドで実行したい場合は、Windowsタスクスケジューラを使用できます。ただし、ほとんどのユーザーにとっては起動時の自動アップデートチェックで十分です。

アップデート

アップデートの確認とインストール：

powershell
yeepilot update

またはインストールせずに確認のみ：

powershell
yeepilot update --check

手動でアップデートするには、リリースページから新しいバイナリをダウンロードし、既存の yeepilot.exe ファイルを置き換えます。

アンインストール

YeePilotとすべてのデータを削除：

powershell
yeepilot uninstall --all

またはバイナリのみ削除：

powershell
yeepilot uninstall --binary-only

手動での削除：

  1. バイナリを削除：C:\Program Files\YeePilot\yeepilot.exe
  2. 設定ディレクトリを削除：%USERPROFILE%\.yeepilot\
  3. PATHから C:\Program Files\YeePilot を削除。

WSL2にもインストールした場合は、WSL2ターミナル内から別途アンインストールしてください：

bash
yeepilot uninstall --all
前へ

macOSセットアップ

Platform Setup

次へ

ベストプラクティス

Guides