WSL2でVS Codeを直接WSLモードで起動する方法
問題の背景
WSL2環境でVS Codeを使用する際、Windowsのショートカットから以下のようなパスでワークスペースを開くと：
\\wsl.localhost\Ubuntu\home\username\project\workspace.code-workspace
VS Codeは一度Windows側で開かれ、その後「WSLモードで再オープン」のリンクをクリックする必要があります。
この記事では、最初からWSLモードでVS Codeを起動する方法を解説します。
前提条件
- WSL2がインストール済み
- VS Codeがインストール済み
- VS Code WSL拡張がインストール済み
- Ubuntuディストリビューションが設定済み
解決方法
方法1: VS Code WSL拡張を使ったコマンド（推奨）
Windowsショートカットのターゲットを以下のように設定：
code --remote wsl+Ubuntu /home/username/project/workspace.code-workspace
具体例：
code --remote wsl+Ubuntu /home/sanomine/tools_meowassist/tools.meowassist/tools.meowassist.code-workspace
方法2: WSL内からVS Codeを起動
ショートカットでWSLを起動してからcodeコマンドを実行：
wsl -d Ubuntu -e bash -c "cd /home/username/project && code workspace.code-workspace"
具体例：
wsl -d Ubuntu -e bash -c "cd /home/sanomine/tools_meowassist/tools.meowassist && code tools.meowassist.code-workspace"
方法3: より確実な方法
ワークスペースファイルを指定せず、プロジェクトディレクトリを直接開く：
wsl -d Ubuntu -e bash -l -c "cd /home/username/project && code ."
具体例：
wsl -d Ubuntu -e bash -l -c "cd /home/sanomine/tools_meowassist/tools.meowassist && code ."
ショートカットの作成手順
1. デスクトップに新しいショートカットを作成
- デスクトップで右クリック
- 「新規作成」→「ショートカット」を選択
- 上記のいずれかのコマンドを「項目の場所」に入力
- ショートカット名を設定（例：「VSCode WSL Project」）
2. ショートカットのプロパティ設定
- ターゲット: 上記のコマンド
-
作業フォルダー: 空白または
C:\ - 実行時の大きさ: 通常のウィンドウ
各方法の特徴
| 方法 | メリット | デメリット |
|---|---|---|
| 方法1 | 最もシンプル、ワークスペース設定を維持 | WSL拡張が必要 |
| 方法2 | 確実に動作、ワークスペースファイルを使用可能 | 少し複雑 |
| 方法3 | 最も安定、プロジェクト全体を開く | ワークスペース設定が使えない |
トラブルシューティング
ショートカットが動作しない場合
-
WSL拡張の確認
code --list-extensions | grep ms-vscode-remote.remote-wsl -
パスの確認
WSL内でパスが正しいか確認：ls -la /home/username/project/ -
権限の確認
WSLディストリビューションが正常に動作するか確認：wsl -l -v
VS Codeが起動しない場合
WSL内でcodeコマンドが使用可能か確認：
# WSL内で実行
which code
# 出力例: /mnt/c/Users/Username/AppData/Local/Programs/Microsoft VS Code/bin/code
codeコマンドが見つからない場合は、VS Codeを再インストールするか、PATHを設定してください。
Claude Codeとの連携
この方法でVS Codeを起動すると、最初からWSLモードになるため：
- Claude Codeが直接使用可能
- WSL内のツール（PHP、Node.js、Pythonなど）にフルアクセス
- パフォーマンスの向上
- ファイルシステムの統一
応用例
プロジェクト別ショートカット
複数のプロジェクトがある場合、それぞれにショートカットを作成：
# プロジェクトA
code --remote wsl+Ubuntu /home/username/projectA/workspace.code-workspace
# プロジェクトB
code --remote wsl+Ubuntu /home/username/projectB/workspace.code-workspace
バッチファイルでの起動
より複雑な設定が必要な場合は、バッチファイル（.bat）を作成：
@echo off
wsl -d Ubuntu -e bash -l -c "cd /home/username/project && code . && echo 'VS Code started in WSL mode'"
pause
まとめ
WSL2環境でVS Codeを直接WSLモードで起動することで：
- 「再オープン」の手間が不要
- より高速な動作
- WSLツールとの完全な統合
- Claude Codeなどの開発ツールの即座な利用
最も推奨される方法は方法1（code --remote wsl+Ubuntu）ですが、環境によって最適な方法を選択してください。
これで効率的なWSL2開発環境が構築できます！