跳轉到主要內容
在 Windows 上，Code 標籤可以在 WSL 2 發行版內執行工作階段，而不是在 Windows 本身上執行。工作階段的 Claude Code 程序、其工具和 git 都在發行版內執行，使用其 Linux 工具鏈和原生 Linux 路徑，與您的專案所針對的環境相同。 當您的儲存庫位於發行版的檔案系統內時，請使用 WSL 工作階段。從 Windows 處理這些檔案會通過網路檔案系統，這很慢且會破壞檔案監視；在發行版內執行工作階段可以避免兩者。

​
需求

  • Windows 10 或 11，搭配 WSL 2。不支援 WSL 1。
  • 至少一個已安裝的發行版（例如 Ubuntu）。
  • 在發行版內安裝的 git。

​
啟動 WSL 工作階段

1

選擇發行版

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

選擇資料夾

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

信任資料夾

資料夾中的第一個工作階段會顯示工作區信任對話框。信任是按發行版和資料夾授予的；信任一個發行版中的資料夾不適用於另一個發行版或 Windows 上的相同路徑。
發行版中的第一個工作階段需要花費一些時間，而 Claude 在其中進行設定。您也可以從一般資料夾選擇器開啟 \\wsl.localhost\... 資料夾，它會在該發行版內重新開啟。 您最近使用過的資料夾會在每個發行版的選擇器中出現，因此重新連接到專案只需一次點擊。

​
WSL 工作階段中的運作方式

平行工作階段、側邊聊天、視覺差異檢閱、分支和提取請求狀態，以及 worktrees 都可以運作，由發行版內的 git 和工具鏈支援。「在編輯器中開啟」會開啟透過 Remote - WSL 連接到發行版的 VS Code。 WSL 工作階段中還有一些功能尚未提供：整合終端、連接器和外掛程式、工作階段分叉、檔案瀏覽器窗格，以及當您在編輯器中輸入 @ 時的檔案建議。

​
受管理的裝置

在由組織管理的裝置上，WSL 工作階段可能無法使用。如果工作階段啟動失敗，並顯示裝置受管理的訊息，這由您的管理員控制。管理員：請參閱部署指南中的設定如何到達裝置。