Windows (WSL)

CodeTutor は Windows で直接実行できますが、より快適に使うには Windows Subsystem for Linux (WSL) の利用をおすすめします。WSL は CodeTutor の機能とスムーズに連携する Linux 環境を提供します。

セットアップ

WSL をインストールする

まだの場合は、Microsoft 公式ガイドを使って WSL をインストールします。
WSL で CodeTutor をインストールする

WSL の準備ができたら WSL のターミナルを開き、インストール方法のいずれかで CodeTutor をインストールします。
Terminal window
```
curl -fsSL https://codetutor-docs.vercel.app/install | bash
```
WSL から CodeTutor を使う

プロジェクトディレクトリに移動し（Windows ファイルは /mnt/c/ や /mnt/d/ などからアクセス）、CodeTutor を実行します。
Terminal window
```
cd /mnt/c/Users/YourName/project
opencode
```

CodeTutor デスクトップアプリを使いつつ、サーバーは WSL で動かしたい場合は次の手順です。

WSL でサーバーを起動する

外部接続を許可するため、--hostname 0.0.0.0 を付けて起動します。
Terminal window
```
codetutor serve --hostname 0.0.0.0 --port 4096
```
デスクトップアプリを接続する

http://localhost:4096 に接続します。

--hostname 0.0.0.0 を使う場合は、CODETUTOR_SERVER_PASSWORD を設定してサーバーを保護してください。

CODETUTOR_SERVER_PASSWORD=your-password codetutor serve --hostname 0.0.0.0

Windows で Web 利用を快適にするには:

PowerShell ではなく WSL ターミナルで codetutor web を実行する
Terminal window
```
codetutor web --hostname 0.0.0.0
```
Windows のブラウザからアクセスする

http://localhost:<port> にアクセスします（URL は CodeTutor が表示します）。

WSL から codetutor web を実行すると、適切なファイルシステムアクセスとターミナル統合を維持したまま、Windows ブラウザから利用できます。

WSL からは /mnt/ ディレクトリ経由で Windows ファイルにアクセスできます。

例:

cd /mnt/c/Users/YourName/Documents/project
opencode