> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code Desktop in WSL

> WSL 2 ディストリビューション内で Code セッションを実行する

Windows では、Code タブは Windows 自体ではなく WSL 2 ディストリビューション内でセッションを実行できます。セッションの Claude Code プロセス、そのツール、および git はすべてディストリビューション内で実行され、その Linux ツールチェーンとネイティブ Linux パスを使用します。これはプロジェクトが対象とする環境と同じです。

リポジトリがディストリビューションのファイルシステム内に存在する場合は、WSL セッションを使用してください。Windows からこれらのファイルで作業すると、ネットワークファイルシステムを経由するため遅く、ファイル監視が機能しません。セッションをディストリビューション内で実行すると、両方の問題を回避できます。

<h2 id="requirements">
  要件
</h2>

* [WSL 2](https://learn.microsoft.com/windows/wsl/install) がインストールされた Windows 10 または 11。WSL 1 はサポートされていません。
* インストール済みのディストリビューション（例：Ubuntu）が少なくとも 1 つ。
* ディストリビューション内にインストールされた `git`。

<h2 id="start-a-wsl-session">
  WSL セッションを開始する
</h2>

<Steps>
  <Step title="ディストリビューションを選択する">
    Code タブで新しいセッションを開始し、環境ピッカーを開きます。インストール済みの WSL 2 ディストリビューションが **WSL** セクションに表示されます。1 つを選択してください。
  </Step>

  <Step title="フォルダを選択する">
    セッションはディストリビューションのホームディレクトリで開始します。フォルダピッカーを使用してプロジェクトフォルダを選択してください。ブラウジングはディストリビューション内で行われ、`/home/you/project` のような Linux パスが使用されます。
  </Step>

  <Step title="フォルダを信頼する">
    フォルダ内の最初のセッションはワークスペース信頼ダイアログを表示します。信頼はディストリビューションとフォルダごとに付与されます。1 つのディストリビューション内のフォルダを信頼しても、別のディストリビューションまたは Windows 上の同じパスには適用されません。
  </Step>
</Steps>

ディストリビューション内の最初のセッションは、Claude がその内部をセットアップする間、少し時間がかかります。通常のフォルダピッカーから `\\wsl.localhost\...` フォルダを開くこともでき、そのディストリビューション内で再度開きます。

最近使用したフォルダはディストリビューションごとにピッカーに表示されるため、プロジェクトに再接続するのは 1 クリックです。

<h2 id="what-works-in-a-wsl-session">
  WSL セッションで機能するもの
</h2>

並列セッション、サイドチャット、ビジュアル diff レビュー、ブランチとプルリクエストのステータス、および worktrees はすべて機能し、ディストリビューション内の git とツールチェーンによってサポートされます。「エディタで開く」は [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl) を通じてディストリビューションに接続された VS Code を開きます。

WSL セッションではまだ利用できない機能がいくつかあります。統合ターミナル、コネクタとプラグイン、セッションフォーク、ファイルブラウザペイン、およびコンポーザーで `@` を入力するときのファイル提案です。

<h2 id="managed-devices">
  管理対象デバイス
</h2>

組織によって管理されているデバイスでは、WSL セッションが利用できない場合があります。セッション開始がデバイスが管理されているというメッセージで失敗する場合、それは管理者によって制御されます。管理者の方は、デプロイメントガイドの [設定がデバイスに到達する方法を決定する](/ja/admin-setup#decide-how-settings-reach-devices) を参照してください。
