> ## 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

> 在 Windows 上的 WSL 2 發行版內執行 Code 工作階段

在 Windows 上，Code 標籤可以在 WSL 2 發行版內執行工作階段，而不是在 Windows 本身上執行。工作階段的 Claude Code 程序、其工具和 git 都在發行版內執行，使用其 Linux 工具鏈和原生 Linux 路徑，與您的專案所針對的環境相同。

當您的儲存庫位於發行版的檔案系統內時，請使用 WSL 工作階段。從 Windows 處理這些檔案會通過網路檔案系統，這很慢且會破壞檔案監視；在發行版內執行工作階段可以避免兩者。

<h2 id="requirements">
  需求
</h2>

* Windows 10 或 11，搭配 [WSL 2](https://learn.microsoft.com/windows/wsl/install)。不支援 WSL 1。
* 至少一個已安裝的發行版（例如 Ubuntu）。
* 在發行版內安裝的 `git`。

<h2 id="start-a-wsl-session">
  啟動 WSL 工作階段
</h2>

<Steps>
  <Step title="選擇發行版">
    在 Code 標籤中啟動新工作階段並開啟環境選擇器。您已安裝的 WSL 2 發行版會出現在 **WSL** 區段中。選擇一個。
  </Step>

  <Step title="選擇資料夾">
    工作階段在發行版的主目錄中啟動。使用資料夾選擇器選擇專案資料夾。瀏覽在發行版內進行，使用 Linux 路徑，例如 `/home/you/project`。
  </Step>

  <Step title="信任資料夾">
    資料夾中的第一個工作階段會顯示工作區信任對話框。信任是按發行版和資料夾授予的；信任一個發行版中的資料夾不適用於另一個發行版或 Windows 上的相同路徑。
  </Step>
</Steps>

發行版中的第一個工作階段需要花費一些時間，而 Claude 在其中進行設定。您也可以從一般資料夾選擇器開啟 `\\wsl.localhost\...` 資料夾，它會在該發行版內重新開啟。

您最近使用過的資料夾會在每個發行版的選擇器中出現，因此重新連接到專案只需一次點擊。

<h2 id="what-works-in-a-wsl-session">
  WSL 工作階段中的運作方式
</h2>

平行工作階段、側邊聊天、視覺差異檢閱、分支和提取請求狀態，以及 worktrees 都可以運作，由發行版內的 git 和工具鏈支援。「在編輯器中開啟」會開啟透過 [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl) 連接到發行版的 VS Code。

WSL 工作階段中還有一些功能尚未提供：整合終端、連接器和外掛程式、工作階段分叉、檔案瀏覽器窗格，以及當您在編輯器中輸入 `@` 時的檔案建議。

<h2 id="managed-devices">
  受管理的裝置
</h2>

在由組織管理的裝置上，WSL 工作階段可能無法使用。如果工作階段啟動失敗，並顯示裝置受管理的訊息，這由您的管理員控制。管理員：請參閱部署指南中的[設定如何到達裝置](/zh-TW/admin-setup#decide-how-settings-reach-devices)。