Claude Code Desktop in WSL
WSL 2 ディストリビューション内で Code セッションを実行する
Windows では、Code タブは Windows 自体ではなく WSL 2 ディストリビューション内でセッションを実行できます。セッションの Claude Code プロセス、そのツール、および git はすべてディストリビューション内で実行され、その Linux ツールチェーンとネイティブ Linux パスを使用します。これはプロジェクトが対象とする環境と同じです。
リポジトリがディストリビューションのファイルシステム内に存在する場合は、WSL セッションを使用してください。Windows からこれらのファイルで作業すると、ネットワークファイルシステムを経由するため遅く、ファイル監視が機能しません。セッションをディストリビューション内で実行すると、両方の問題を回避できます。
要件
- WSL 2 がインストールされた Windows 10 または 11。WSL 1 はサポートされていません。
- インストール済みのディストリビューション（例：Ubuntu）が少なくとも 1 つ。
- ディストリビューション内にインストールされた
git。
WSL セッションを開始する
ディストリビューションを選択する
Code タブで新しいセッションを開始し、環境ピッカーを開きます。インストール済みの WSL 2 ディストリビューションが WSL セクションに表示されます。1 つを選択してください。
フォルダを選択する
セッションはディストリビューションのホームディレクトリで開始します。フォルダピッカーを使用してプロジェクトフォルダを選択してください。ブラウジングはディストリビューション内で行われ、/home/you/project のような Linux パスが使用されます。
フォルダを信頼する
フォルダ内の最初のセッションはワークスペース信頼ダイアログを表示します。信頼はディストリビューションとフォルダごとに付与されます。1 つのディストリビューション内のフォルダを信頼しても、別のディストリビューションまたは Windows 上の同じパスには適用されません。
ディストリビューション内の最初のセッションは、Claude がその内部をセットアップする間、少し時間がかかります。通常のフォルダピッカーから \\wsl.localhost\... フォルダを開くこともでき、そのディストリビューション内で再度開きます。
最近使用したフォルダはディストリビューションごとにピッカーに表示されるため、プロジェクトに再接続するのは 1 クリックです。
WSL セッションで機能するもの
並列セッション、サイドチャット、ビジュアル diff レビュー、ブランチとプルリクエストのステータス、および worktrees はすべて機能し、ディストリビューション内の git とツールチェーンによってサポートされます。「エディタで開く」は Remote - WSL を通じてディストリビューションに接続された VS Code を開きます。
WSL セッションではまだ利用できない機能がいくつかあります。統合ターミナル、コネクタとプラグイン、セッションフォーク、ファイルブラウザペイン、およびコンポーザーで @ を入力するときのファイル提案です。
管理対象デバイス
組織によって管理されているデバイスでは、WSL セッションが利用できない場合があります。セッション開始がデバイスが管理されているというメッセージで失敗する場合、それは管理者によって制御されます。管理者の方は、デプロイメントガイドの 設定がデバイスに到達する方法を決定する を参照してください。