返回博客

Claude Code Windows 安裝指南：透過 WSL 輕鬆設定

手把手教 Windows 用戶安裝 WSL 並設定 Claude Code，讓你在 Windows 上也能享用強大的終端機 AI 助手。

為什麼需要 WSL？

Claude Code 是一個在終端機中運行的命令列工具，原生支援 macOS 和 Linux。Windows 用戶需要透過 WSL（Windows Subsystem for Linux） 來使用它。

WSL 是微軟官方推出的功能，讓你在 Windows 上直接運行 Linux 環境，毋須安裝虛擬機或雙系統。安裝過程非常簡單，只需幾個步驟。

準備工作

在開始之前，請確認你已具備以下條件：

  • Windows 10（2004 版本或以上）或 Windows 11
  • Claude Max 或 Pro 訂閱：Claude Code 需要有效的 Claude 訂閱才能使用。如果你還沒有訂閱，可參考我們的 Apple ID 註冊教程 透過 App Store 訂閱
  • 穩定的網路連線：由於香港及澳門地區無法直接連接 Claude 服務，建議先配置好 OpenHK 代理服務，確保連線暢通
  • 預先登入 Claude 帳戶：連接 OpenHK 網路後，先在瀏覽器中打開 claude.ai 並登入你的帳戶

第一步：安裝 WSL

1. 以管理員身份打開 PowerShell

右鍵點擊 Windows 開始按鈕，選擇「終端機（系統管理員）」或「Windows PowerShell（系統管理員）」。

2. 執行安裝命令

在 PowerShell 中貼上以下命令並按 Enter：

wsl --install

這個命令會自動安裝 WSL 2 和 Ubuntu 發行版。安裝過程可能需要幾分鐘。

3. 重新啟動電腦

安裝完成後，按提示重新啟動電腦。

4. 設定 Ubuntu 用戶

重新啟動後，Ubuntu 會自動打開。首次啟動時，系統會要求你：

  • 設定一個 用戶名稱（全小寫英文，例如 john）
  • 設定一個 密碼（輸入時不會顯示字符，這是正常的）

記住這個密碼，之後執行 sudo 命令時會用到。

第二步：更新系統

在 Ubuntu 終端機中，先更新系統套件：

sudo apt update && sudo apt upgrade -y

輸入你剛才設定的密碼，等待更新完成。

第三步：連接網路（香港／澳門用戶必讀）

由於香港及澳門地區無法直接連接 Claude 服務，你需要使用 OpenHK 代理服務。OpenHK 採用 TUN 模式，毋須任何額外設定，一鍵即可解決網路問題。

連接 OpenHK 後，可以在 WSL 中測試連線：

curl -I https://claude.ai

如果看到 HTTP/2 200 或類似的回應，表示連線正常。

第四步：安裝 Claude Code

在 Ubuntu 終端機中執行安裝命令：

curl -fsSL https://claude.ai/install.sh | sh

安裝完成後，驗證是否成功：

claude --version

如果看到版本號碼，表示安裝成功。

第五步：登入 Claude Code

在終端機中輸入：

claude

首次啟動時，Claude Code 會顯示一個授權 URL。由於 WSL 可能無法自動打開瀏覽器，你需要：

  1. 複製終端機中顯示的 URL
  2. 在 Windows 瀏覽器中打開該 URL
  3. 在瀏覽器中完成授權

授權完成後，回到 WSL 終端機，Claude Code 即可正常使用。

開始使用

切換到工作目錄

WSL 可以存取你的 Windows 檔案。Windows 的 C 槽掛載在 /mnt/c/。例如：

# 進入 Windows 桌面
cd /mnt/c/Users/你的用戶名/Desktop

# 進入 Windows 文件資料夾
cd /mnt/c/Users/你的用戶名/Documents

# 進入 Linux 家目錄
cd ~

啟動 Claude Code

進入目標資料夾後，輸入：

claude

Claude Code 會自動了解當前資料夾內的檔案結構。之後的用法與 macOS/Linux 完全一樣——用自然語言向它提問或下達指令即可。

更多使用方法和技巧，請參閱我們的 Claude Code 入門指南。

WSL 實用貼士

  • 用 Windows Terminal：微軟官方的 Windows Terminal 比傳統的命令提示字元好用得多，支援分頁、自訂主題、多 Shell 切換。可在 Microsoft Store 免費下載
  • VS Code 整合：安裝 VS Code 的「WSL」擴充套件後，可以直接在 VS Code 中編輯 WSL 內的檔案，配合 Claude Code 使用效果極佳
  • 檔案存放建議：如果是程式開發專案，建議將程式碼存放在 Linux 家目錄（~/projects/）而非 Windows 目錄下，讀寫速度會快很多
  • 保持更新：定期執行 sudo apt update && sudo apt upgrade -y 更新 WSL 環境

常見問題

Q：執行 wsl --install 時出現錯誤？ 請確認你的 Windows 版本符合要求（Windows 10 2004+）。另外，需要在 BIOS 中啟用虛擬化技術（VT-x / AMD-V）。大部分新電腦預設已開啟，舊電腦可能需要手動開啟。

Q：WSL 中無法自動打開瀏覽器？ 這是正常的。複製 Claude Code 顯示的 URL，手動貼到 Windows 瀏覽器中完成授權即可。

Q：如何在 WSL 和 Windows 之間複製貼上？ 在 Windows Terminal 中，直接使用 Ctrl+C 複製、Ctrl+V 貼上即可。如果使用傳統的命令提示字元，右鍵點擊即可貼上。

Q：想了解更多 Claude Code 的用法？ 請閱讀我們的 Claude Code 入門指南，涵蓋模型切換、Plan Mode、CLAUDE.md 等進階功能。