Claude Code｜Windows CLI 安裝教學

這篇會帶你在 Windows 的 PowerShell 安裝 Claude Code，確認終端機找得到指令，再進入練習專案完成第一次只讀任務。安裝工具、登入帳號與啟動網站是三件不同的事；做到哪一步，就用那一步的結果確認，不必一開始把所有環境都裝齊。

適用於官方支援的 Windows 版本與具備 Claude Code 使用資格的帳號。請先閱讀帳號與使用資格。本篇選原生 Windows；若你的專案需要 Linux 工具鏈，改讀Linux 與 WSL，不要在兩種環境反覆貼同一串指令。

先確認正在使用 PowerShell

閱讀完整文字說明

Windows CLI 安裝教學，以流程和文件圖形呈現教學重點。

從開始功能表搜尋 PowerShell，開啟一般使用者視窗。提示字元常以 PS 開頭；Windows Terminal 只是容納分頁的視窗，分頁內仍可能是 PowerShell、CMD 或 Ubuntu。指令前的語言標籤是輸入位置，複製時只複製區塊內文字，不包含提示字元。

Get-Location
$PSVersionTable.PSVersion

第一行顯示目前所在資料夾；第二行顯示 PowerShell 版本。這不會安裝或修改任何東西。若你看見「不是內部或外部命令」，先檢查分頁是不是 CMD。遇到語法錯誤時，先確認輸入位置，比直接更改系統設定更容易找出問題。

使用官方安裝方式

下列指令會從官方網址取得安裝程式並執行。先對照本篇來源的官方安裝頁，確認網域與指令一致，再於 PowerShell 貼上。原生安裝一般不需要系統管理員權限，也不需要先安裝 Node.js；練習網站會另用 Node.js，那是網站本身的需求。

irm https://claude.ai/install.ps1 | iex

等待安裝程式結束，閱讀最後顯示的成功或失敗訊息。如果公司網路阻擋下載，記錄錯誤碼與網域，依組織的網路規則處理。不要把陌生網站提供的替代下載位址當成同一份安裝程式，也不要因為一次連線失敗就關閉所有安全設定。

另一個官方選項是 WinGet。兩種方式擇一即可；本篇後續以原生安裝為準。若你已用 WinGet 管理工具，可以保留原有方式，並依該方式更新，避免同時有多份程式而分不清實際啟動的是哪個。

winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode

重新開啟終端機並檢查路徑

安裝完成後關閉原本的 PowerShell，開新視窗再檢查。PATH 是系統尋找可執行檔的一組資料夾清單；新安裝的路徑可能還沒進入舊視窗，所以重新開啟是必要的基本排查，並不代表安裝失敗。

Get-Command claude
claude --version
claude doctor

預期第一個結果能指出指令所在位置，第二個輸出 Claude Code 版本，第三個提供安裝與設定診斷。版本數字會更新，不必與教學截圖完全相同。若找到多個位置，可用 Get-Command claude -All 列出來，先判斷每一份是如何安裝，再決定保留方式。

進入專案並登入

先依練習專案準備解壓縮起始版。用檔案總管複製實際資料夾路徑，再把下例的路徑換成自己的位置；引號可以保留路徑中的空白。確認列出的檔案包含 package.json、index.html 和 model.js，才啟動 Claude。

Set-Location -LiteralPath "C:\Projects\claude-todo"
Get-ChildItem
claude

依畫面選擇登入方式，在瀏覽器確認帳號後返回終端機。若工作階段提示使用 API 金鑰，先確認那是不是你原本要用的計費來源。登入成功後閱讀專案信任提示，只對自己認識的練習資料夾繼續；不要為了測試而選整個使用者目錄。

請確認目前專案的實際路徑，閱讀 package.json、README.md 與 model.js。
用繁體中文說明網站如何啟動、有哪些功能，以及測試指令。
這次只讀取並解釋，不修改檔案，也不安裝套件。

成功判準是回覆能對上這個待辦專案的檔案與指令，而不只是通用的程式介紹。退出對話後再查看檔案，應沒有這次任務造成的修改。之後要跑網站，另開一個 PowerShell 執行 npm start，讓對話與開發伺服器各有自己的分頁。

Git 與更新的常見誤會

目前官方文件將 Git for Windows 列為原生 Windows 的建議工具；安裝它可提供 Git Bash，未安裝時 Claude Code 可使用 PowerShell 工具。不要把舊教學的「一定要先裝 Git Bash」當成所有版本的固定前提。不過本系列的版本管理練習仍需要 Git，請在開始 Git 章節前備妥。

最後練習重新開機後進入同一資料夾，執行版本檢查並啟動只讀任務。完成時，你應能自己說出「哪個 PowerShell 分頁、哪個資料夾、哪種登入來源」，也能區分找不到指令和帳號登入失敗。需要進一步排查時，帶著這三項資訊前往診斷教學。

回 Claude Code 教學總目錄

• AI 工具
• 教學
• Claude Code