Windows 11 安裝 Claude Code

VS Code → Claude Code → 第一次啟動。全程免管理員權限。

需要：一組 Claude.ai 訂閱帳號(Pro / Max / Team / Enterprise),首次啟動會引導瀏覽器登入。

1.1下載

到 code.visualstudio.com/Download,點下圖紅圈處的 User Installer x64(不是 System Installer,免 Admin)。

1.2執行安裝

全程「下一步」即可。最後一頁「Select Additional Tasks」務必勾「Add to PATH」。

1.3驗證

開新的 PowerShell,打:

PS> code --version
1.97.x   # 看到版本號就成功

2.1跑安裝指令

開 PowerShell,貼這行:

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

約 1-2 分鐘下載完成。

2.2確認裝好了

PS> claude --version
2.x.x   # 看到版本號就成功

沒裝也能跑 Claude Code(會自動用 PowerShell),只是 git commit / diff / branch 不能用。要做版本控制就裝,不然可以跳到 Step 4。

3.1下載並安裝

到 git-scm.com/download/win,下載 64-bit Setup,全程「下一步」即可。

3.2驗證

PS> git --version
git version 2.5x.x.windows.x

4.1在 VS Code 打開 Terminal

1. 打開 VS Code
2. 按 Ctrl + `(數字 1 左邊的反引號鍵)叫出 Terminal
3. 確認 Terminal 是 PowerShell(右上角下拉選單),不是 Command Prompt 或 Git Bash

4.2啟動 Claude Code

在 Terminal 輸入 claude 按 Enter,依序回答 3 個問題:

1. 主題(Dark / Light)
2. 認證方式 — 選 Claude account with subscription,瀏覽器會跳出來引導你用 Claude 帳號登入
3. Trust this folder — 選 1. Yes, I trust this folder,按 Enter 確認(信任目前資料夾,讓 Claude Code 能讀寫該目錄)

4.3試一句

> 你好,告訴我現在的工作目錄

Claude 用 PowerShell 工具回答你 cwd — 整套裝好了。

剛裝好 Claude Code,按 Enter 會直接送出訊息 — 想換行你得打 \(反斜線)再按 Enter,很反直覺。修法只要一行斜線指令。

5.1跑斜線指令

在 Claude Code 對話介面(剛剛跑起來那個)直接打:

> /terminal-setup

Claude 會修改你 IDE 的 keybindings 設定,把 Shift+Enter 綁定為「插入換行」。之後寫多行 prompt 就跟寫 email 一樣自然。

跑完永久生效。

以下都是進階使用者才會碰的設定,新手可跳過。設定檔位置:

C:\Users\<你>\.claude\settings.json

A預設使用 Opus 模型

{
  "model": "opus"
}

Opus 4.x 是最強模型,但較慢、成本較高。預設是 Sonnet(快、夠用)。

B啟用 Extended Thinking

{
  "alwaysThinkingEnabled": true
}

每次回答前先「思考」一段,複雜問題答得更好,代價是回應變慢。

C跳過權限確認 危險

{
  "permissions": { "defaultMode": "bypassPermissions" },
  "skipDangerousModePermissionPrompt": true
}

Claude 執行任何工具都不會跳確認視窗。只在你完全信任的個人專案使用,共用環境或 production 千萬不要開。

D啟用 frontend-design 官方外掛

{
  "enabledPlugins": {
    "frontend-design@claude-plugins-official": true
  }
}

專為前端設計優化的 prompt 套件,寫 React / UI 元件時派得上用場。

E自訂 statusline 需要 bash

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline_wrapper.sh"
  }
}

在 Terminal 底部顯示自訂狀態列(model、token 用量、git branch 等)。前提是系統能找到 bash.exe — 把 C:\Program Files\Git\bin\ 加入 PATH,或安裝 WSL。如果不想搞,直接拿掉這段即可。

F參考組合 — 作者目前的 settings.json

{
  "permissions": {
    "allow": [
      "Edit", "Write", "Read", "Glob", "Grep",
      "Bash", "PowerShell", "WebFetch", "WebSearch",
      "Agent", "TaskCreate", "TaskUpdate"
    ],
    "defaultMode": "bypassPermissions"
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline_wrapper.sh"
  },
  "enabledPlugins": {
    "frontend-design@claude-plugins-official": true
  },
  "alwaysThinkingEnabled": true,
  "skipDangerousModePermissionPrompt": true,
  "model": "opus"
}

Q1打 claude 顯示「無法識別」

PATH 沒生效。關掉所有 PowerShell 視窗,重開新的再試。仍不行就打開 sysdm.cpl → 環境變數,確認使用者 Path 內有 %USERPROFILE%\.local\bin。

Q2install.ps1 下載卡住 / 跑到一半中斷

三件事:檢查右下角 Defender 通知有沒有攔截、確認網路、刪暫存重跑。

PS> Remove-Item "$env:USERPROFILE\.claude\downloads" -Recurse -Force -ErrorAction SilentlyContinue
PS> irm https://claude.ai/install.ps1 | iex

Q3公司網路裝不起來(proxy)

設環境變數,重開 PowerShell 再裝:

PS> [Environment]::SetEnvironmentVariable('HTTPS_PROXY', 'http://公司proxy:port', 'User')
PS> [Environment]::SetEnvironmentVariable('HTTP_PROXY', 'http://公司proxy:port', 'User')

還是不行,請 IT 放行 claude.ai / downloads.claude.ai / code.visualstudio.com。

Q4裝完怎麼確認真的能用?

1. claude --version 看到版本號
2. claude 進入對話介面
3. 登入後問「你好,告訴我現在的工作目錄」,Claude 回答 cwd

Q5Claude Code 一啟動就閃退

重裝最快(設定跟對話歷史不會被刪):

PS> Remove-Item "$env:USERPROFILE\.local\bin\claude.exe" -Force -ErrorAction SilentlyContinue
PS> Remove-Item "$env:USERPROFILE\.local\share\claude" -Recurse -Force -ErrorAction SilentlyContinue
PS> irm https://claude.ai/install.ps1 | iex

Q6登入後一直要求重新登入

PS> Remove-Item "$env:USERPROFILE\.claude\.credentials.json" -ErrorAction SilentlyContinue
PS> claude

Q7VS Code Terminal 中文字消失 / 吃字 / 變符號

這 不是編碼問題,是 VS Code 終端的 glyph cache 渲染 bug。Claude Code 跑久了之後,VS Code 偶爾會把某些中文字形 cache 成空白或亂碼,字實際上有送出來,只是畫不出來。實際長這樣:

為什麼有效

VS Code 偵測到 terminal.integrated.fontSize 變更時,會 銷毀並重建 整個 terminal 的 renderer。重建會清掉舊的 glyph cache,所有字形重新從字型檔讀取繪製 — 那些被 cache 成空白的中文字當然就回來了。改字級只是「最便宜的觸發方式」,改 fontFamily 或 fontWeight 也行,但改字級不會真的動到外觀。

前置條件:字型有 CJK fallback

你的 settings.json 必須有支援中文的字型在 fallback 鏈裡,不然 cache 重建再多次也畫不出來。建議設定:

{
  "terminal.integrated.fontFamily": "Consolas, 'Microsoft JhengHei'",
  "terminal.integrated.fontSize": 16
}

VS Code 會按序嘗試:先用 Consolas 畫(Consolas 沒有中文字形),畫不出來的字 fallback 到 Microsoft JhengHei(微軟正黑體,Windows 內建)。簡體環境可以改成 Microsoft YaHei。

軟體 · 必裝 vs 可選

環境變數 · 必設 vs 選用