Claude Code Windows 安裝指南（2026 年 3 月最新版）

1

Claude Code Windows 安裝指南（2026 年 3 月最新版）

前置需求

在開始安裝之前，請確認以下條件：

系統需求：

  • Windows 10 (1903+) 或 Windows 11
  • 至少 4GB RAM
  • 穩定的網路連線
  • 不需要 GPU

必備軟體：

  • Git for Windows — 這是強制需求。Claude Code 內部使用 Git Bash 執行指令，即使你從 PowerShell 或 CMD 啟動也一樣。沒有 Git，安裝會失敗或無法正常運作。
    • 下載位址：Redirecting…
    • 安裝時務必勾選 「Add Git to PATH」（預設已勾選）

帳號需求（擇一）：

  • Claude Pro（$20/月）
  • Claude Max（$100–200/月）
  • Claude Teams 或 Enterprise 方案
  • Anthropic Console API 金鑰（按用量付費）

:warning: 免費的 Claude.ai 方案不包含 Claude Code 存取權限。

安裝方式

Claude Code 提供三種安裝方式，以下依推薦順序介紹。

方法一：原生安裝器（官方推薦）:white_check_mark:

這是 Anthropic 官方推薦的方式。不需要 Node.js，安裝快速，且支援背景自動更新。

開啟 PowerShell（不需要以系統管理員身份執行），貼上以下指令：

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

安裝完成。安裝器會自動下載二進位檔、設定 PATH，整個過程約 30 秒。

如果安裝後輸入 claude 出現「不是可辨識的指令」錯誤：

關閉並重新開啟 PowerShell。如果仍然不行，手動將路徑加入 PATH：

[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", [EnvironmentVariableTarget]::User)

然後重新開啟 PowerShell。

方法二：WinGet

如果你偏好用 Windows 套件管理員：

winget install Anthropic.ClaudeCode

:warning: WinGet 安裝不會自動更新，需要手動執行 winget upgrade Anthropic.ClaudeCode。

方法三：WSL（Windows Subsystem for Linux）

如果你已有 WSL 環境或需要 Docker 整合：

# 在 WSL 終端機中執行
curl -fsSL https://claude.ai/install.sh | sh
  • WSL 2 支援沙盒隔離，安全性更高
  • WSL 1 可運行但不支援沙盒
  • 建議將專案放在 Linux 檔案系統（~/projects/）而非掛載的 Windows 磁碟（/mnt/c/...），檔案操作速度明顯更快

npm 安裝（已棄用）:warning:

npm 安裝方式已官方棄用。如果你仍在使用 npm 版本，建議遷移至原生安裝器：

npm uninstall -g @anthropic-ai/claude-code
irm https://claude.ai/install.ps1 | iex

設定檔（~\.claude\）在遷移過程中會保留。

首次啟動與登入

安裝完成後，在終端機輸入：

claude

系統會自動開啟瀏覽器進行認證。按照提示登入你的 Claude 帳號即可完成設定。

更新管理

原生安裝： 背景自動更新，不需手動操作。更新會在下次啟動 Claude Code 時生效。

如果想立即更新：

claude update

更新頻道設定：

  • latest（預設）：新功能發布後立即取得
  • stable：延遲約一週，跳過有重大問題的版本

可透過 /config → Auto-update channel 設定，或在 settings.json 中修改。

桌面應用程式（替代方案）

如果你不習慣使用終端機，也可以下載 Claude Code 桌面應用程式：

  • 桌面版與終端版使用相同核心引擎，功能完全一致
  • 下載位址：前往 Claude 官網下載 Windows 版

Windows 使用注意事項

  1. 剪貼簿圖片貼上：使用 Alt+V（不是 Ctrl+V）。Ctrl+V 只能貼上文字。
  2. 設定檔位置：%USERPROFILE%\.claude\（解除安裝不會刪除此資料夾）
  3. Git Bash 路徑：如果 Claude Code 找不到 Git Bash，可在 settings.json 中手動設定路徑
  4. 不需要以系統管理員身份執行 PowerShell

常見問題排解

「claude 不是可辨識的指令」

  1. 關閉並重新開啟終端機
  2. 如果仍然不行，手動加入 PATH（見上方指令）
  3. 確認 Git for Windows 已安裝且加入 PATH

執行 claude doctor

claude doctor

這會顯示安裝類型（原生/npm/WinGet）、版本、認證狀態、Git 狀態、PATH 問題等診斷資訊。

Process Exited With Code 1

  • 確認 Git for Windows 已正確安裝
  • 確認網路連線正常
  • 嘗試重新安裝

快速參考

項目 指令 / 資訊
安裝（推薦） irm https://claude.ai/install.ps1 | iex
安裝（WinGet） winget install Anthropic.ClaudeCode
啟動 claude
查看版本 claude --version
手動更新 claude update
診斷 claude doctor
圖片貼上 Alt+V
設定檔位置 %USERPROFILE%\.claude\

相關資源