Claude Code CLI 安裝與設定

前言

在 Windows 平台安裝 Claude Code CLI, 並完成第一次啟動時的設定 (Theme, 身份認證, 安全性提示, 工作區存取). 安裝本身只要一行指令, 但實際走過一遍, 還是有一些地方要注意. 整理如下, 供備忘之用.

一. 安裝

以 PowerShell 執行以下指令, 不需要以系統管理員身份執行.

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

這行指令拆開來看:

• irm: Invoke-RestMethod 這個 cmdlet 的縮寫別名. 它會對指定網址發出網路請求, 並把回傳的內容抓下來. 在這裡是去 https://claude.ai/install.ps1 下載安裝腳本的內容 (一段 PowerShell 程式碼文字).
• |: 管線 (pipe) 符號. 把左邊指令的輸出, 直接當作右邊指令的輸入, 所以 irm 下載到的腳本文字, 會被送給右邊處理.
• iex: Invoke-Expression 的縮寫別名. 它會把收到的文字當成 PowerShell 指令來執行.

合起來的效果就是: 從 claude.ai 下載安裝腳本, 然後立刻執行它. 不需要先存成檔案, 再手動打開執行, 一行就完成.

補充: Git for Windows 為選用. 有安裝的話, Claude Code 會使用 Git Bash 執行 shell 指令; 沒有安裝, 則改用 PowerShell.

二. PATH 警告及處理

安裝完成後, 出現了一段 Setup notes: C:\Users\user01\.local\bin 不在 PATH 中.

以下列指令, 將 .local\bin 加入使用者的 PATH 環境變數. 這裡用 $env:USERPROFILE 取代寫死的使用者路徑, 換了帳號也能直接使用:

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path","User") + ";$env:USERPROFILE\.local\bin", "User")

注意: 執行後, 必須開啟新的終端機視窗, 新的 PATH 才會生效.

幾個常用的環境變數查詢指令:

# 取得 PATH 變數
$env:PATH

# 取得目前登入的使用者名稱
$env:USERNAME

# 取得 Windows 安裝目錄
$env:windir

三. 確認 PATH 並啟動 claude

開啟新的終端機視窗, 確認 PATH 的最後已包含 C:\Users\user01\.local\bin, 再輸入 claude 啟動.

PS C:\Users\user01> $env:PATH
C:\Users\user01\AppData\Local\Microsoft\WindowsApps\Microsoft.PowerShell_8wekyb3d8bbwe;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\WINDOWS\System32\WindowsPowerShell\v1.0\;C:\WINDOWS\System32\OpenSSH\;C:\Program Files\Microsoft SQL Server\170\Tools\Binn\;C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\170\Tools\Binn\;C:\Program Files\dotnet\;C:\Program Files\Git\cmd;C:\Program Files\TortoiseGit\bin;C:\Users\user01\AppData\Local\Microsoft\WindowsApps;C:\Users\user01\.dotnet\tools;C:\Users\user01\AppData\Local\Programs\Microsoft VS Code\bin;C:\Users\user01\.local\bin

PS C:\Users\user01> claude

也可以用 claude --version 確認安裝是否成功, 正常會顯示版本號.

注意: 建議先切換到要作業的專案資料夾, 再執行 claude. 原因見 七. 工作區存取.

四. 設定 Theme

第一次執行時, 會先選擇終端機的文字樣式. 維持預設的 Dark mode 即可, 之後可用 /theme 變更.

五. 身份認證

Claude Code 需要 Pro, Max, Team, Enterprise 或 Console 帳號, 免費方案不包含 Claude Code. 這裡採用訂閱 (Subscription) 的方式登入.

選擇第 1 項 Claude account with subscription:

接著會自動開啟瀏覽器進行授權:

輸入電子郵件:

到信箱收信, 依郵件中的連結或驗證碼繼續:

取得驗證碼:

確認授權範圍後, 按 [Authorize]:

授權完成:

回到 claude cli (在 PowerShell 中), 可以看到登入成功的訊息 Login successful., 按 Enter 繼續.

六. 安全性提示

接著是兩點安全性提示:

1. Claude 可能會出錯. 使用者要為 Claude 的動作負責, 執行程式碼前應自行檢查.
2. 由於有 prompt injection (提示注入) 的風險, 只用在自己信任的程式碼上.

七. 工作區存取

Claude Code 會詢問是否信任「目前的工作資料夾」. 信任之後, Claude Code 就能讀取, 編輯, 執行這個資料夾裡的檔案.

這裡詢問的是執行 claude 時所在的資料夾. 由於 PowerShell 開啟時預設停在使用者的 home (C:\Users\user01), 直接執行 claude, 問到的就是整個 home 資料夾.

重要: 對使用者的 home 資料夾, 千萬不要選 Yes. 請選 No, exit 離開, 先 cd 到專案資料夾, 再重新執行 claude.

結論

Claude Code CLI 的安裝本身只要一行指令, 比較需要留意的有兩點: 一是安裝後 .local\bin 不在 PATH 中, 要自行加入並重開終端機; 二是第一次啟動時的工作區信任, 問的是執行 claude 時所在的資料夾, 記得先切換到專案資料夾, 不要把整個 home 交給它.

參考文件

• [1] (官方文件) Claude Code: Advanced setup
• [2] (官方文件) Claude Code: Quickstart