一、什么是 Claude Code

Claude Code 是 Anthropic 官方推出的終端 AI 編程助手，可以直接在命令行中與 Claude 大模型對話，幫助你寫代碼、改 Bug、分析項目、執(zhí)行文件操作等。

核心特點：

• 直接操作文件：可讀取、創(chuàng)建、修改項目中的代碼文件
• 理解項目上下文：自動分析項目結構
• 執(zhí)行終端命令：可運行構建、測試等 shell 命令
• 集成 IDE：支持 VS Code 擴展，在編輯器中直接使用

Claude Code 現(xiàn)已支持 Windows 原生運行，無需配置 WSL。

二、系統(tǒng)要求與環(huán)境準備

2.1 系統(tǒng)要求

2.2 安裝 Git for Windows（必需）

Claude Code 在 Windows 上依賴 Git Bash 來執(zhí)行 shell 命令，因此必須先安裝 Git for Windows。

安裝步驟：

• 訪問 https://git-scm.com/download/win，下載安裝包
• 雙擊運行安裝程序，一路點 Next 使用默認選項即可
• 安裝完成后驗證：

git --version

看到類似 git version 2.51.0.windows.1 的輸出說明安裝成功。

提示：你也可以使用 winget 命令安裝：winget install Git.Git --source winget

三、安裝 Claude Code（推薦方式）

原生安裝器是官方推薦的方式，不需要 Node.js，安裝后會自動后臺更新。

3.1 方式一：PowerShell 一鍵安裝（推薦）

以普通用戶身份打開 PowerShell（不需要管理員權限），運行：

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

等待安裝完成即可。

3.2 方式二：CMD 安裝

打開 CMD 命令提示符，運行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

3.3 方式三：npm 安裝（備選）

如果原生安裝器因網(wǎng)絡等原因無法使用，可以用 npm 方式安裝。此方式需要先安裝 Node.js（版本 ≥ 18）。

從 https://nodejs.org/ 下載 LTS 版，雙擊安裝

驗證 Node.js 安裝：

node --version
npm --version

全局安裝 Claude Code：

npm install -g @anthropic-ai/claude-code

警告：正確的包名是 @anthropic-ai/claude-code（帶前綴），不要安裝 claude-code 這個仿冒包。

3.4 添加 Claude 到 PATH（如需要）

原生安裝器有時可能無法正確將 Claude 添加到 PATH 環(huán)境變量中。如果安裝后運行 claude 提示命令找不到，按以下步驟修復：

手動添加環(huán)境變量（PowerShell）：

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

關閉并重新打開 PowerShell 使 PATH 生效。

說明：Claude Code 默認安裝到 %USERPROFILE%\.local\bin\claude.exe。

3.5 驗證安裝

安裝完成后，關閉并重新打開終端窗口，輸入：

claude --version

能看到類似 2.1.89 (Claude Code) 的版本號輸出，說明安裝成功。

四、首次啟動與認證

4.1 創(chuàng)建項目文件夾

建議先創(chuàng)建一個專門的項目文件夾，而不是直接在用戶主目錄中啟動 Claude Code：

New-Item -ItemType Directory -Path C:\projects\my-project -Force
cd C:\projects\my-project

這樣做的原因是：Claude Code 啟動時會詢問是否信任當前文件夾中的文件。在空項目文件夾中回答此問題更安全。

4.2 啟動與認證（包含跳過登錄）

由于官方 Claude 賬號存在注冊限制和網(wǎng)絡訪問難題，我們可以通過修改本地配置文件的方式，繞過官方的登錄驗證，直接進入 Claude Code 的交互界面。

1. 手動修改配置文件：

• 用記事本或代碼編輯器打開位于 C:\Users\你的用戶名\ 路徑下的 .claude.json 文件。
• 在文件中添加 "hasCompletedOnboarding": true 這一行配置。請務必注意 JSON 格式，在上一行末尾補上英文逗號。

{
    "otherConfig": "value",
    "hasCompletedOnboarding": true
}

2. 一鍵腳本自動修改（推薦）：

打開 PowerShell，直接復制并執(zhí)行以下腳本，即可自動完成上述修改

node --eval "
const fs = require('fs');
const path = require('path');
const os = require('os');
const homeDir = os.homedir();
const filePath = path.join(homeDir, '.claude.json');
if (fs.existsSync(filePath)) {
    const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
    fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8');
} else {
    fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }), 'utf-8');
}
"

完成上述修改后，再次運行 claude 命令，即可直接進入交互界面，無需再處理官方登錄流程。

4.3 配置第三方大模型（DeepSeek / Kimi）

要使用第三方模型，核心是配置兩個環(huán)境變量：ANTHROPIC_BASE_URL（API接口地址）和 ANTHROPIC_AUTH_TOKEN（你的API密鑰）。這里提供兩種配置方式：

方式一：使用圖形化工具 CC-Switch（推薦新手）

CC-Switch 是一個可視化工具，能幫你輕松管理和切換模型，省去手動配置的繁瑣。

1. 獲取 API Key：前往你選擇的模型平臺注冊并創(chuàng)建 API Key。
   • DeepSeek：DeepSeek 開放平臺
   • Kimi（月之暗面）：Kimi API 平臺
   • 更多兼容模型：也可以選擇 GLM、Qwen 等。
2. 安裝并使用 CC-Switch：
   • 下載并安裝 CC-Switch 工具。
   • 打開軟件，點擊“+”號，選擇模型并粘貼你的 API Key，保存配置。
3. 啟動 Claude Code：
   • 在后臺保持 CC-Switch 運行。
   • 在終端輸入 claude 啟動，然后輸入 /model 命令，即可看到并切換為你配置的第三方模型。

方式二：手動配置環(huán)境變量（推薦進階用戶）

如果你更傾向于直接控制，可以手動設置環(huán)境變量。

方法 A：臨時配置（僅當前終端會話有效）

在終端（PowerShell或CMD）中，用你的API Key替換 "你的API密鑰"，然后運行以下命令：

1. 接入 DeepSeek：

# PowerShell
$env:ANTHROPIC_AUTH_TOKEN = "你的DeepSeek_API_Key"
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic/"

注意：DeepSeek 的接口地址是 https://api.deepseek.com/anthropic/。

2. 接入 Kimi：

# PowerShell
$env:ANTHROPIC_AUTH_TOKEN = "你的Kimi_API_Key"
$env:ANTHROPIC_BASE_URL = "https://api.moonshot.cn/anthropic/"

注意：Kimi 的接口地址是 https://api.moonshot.cn/anthropic/。

方法 B：永久配置（推薦）

在用戶目錄下的 %USERPROFILE%\.claude\settings.json 文件中寫入配置。

1. 創(chuàng)建或打開文件：在終端中運行 notepad $env:USERPROFILE\.claude\settings.json。
2. 根據(jù)你選擇的模型，填入以下配置之一，保存文件即可。

示例：為 DeepSeek 配置

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek_API_Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic/"
  }
}

示例：為 Kimi 配置

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的Kimi_API_Key",
    "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic/"
  }
}

配置完成后，重新打開終端并運行 claude 即可生效。

提示：配置后啟動 Claude Code，可以在歡迎界面的 Overrides 區(qū)域看到 API Key 和 API Base 信息，確認配置無誤。請注意，API 調(diào)用會產(chǎn)生費用，請確保賬戶有足夠余額。

4.4 首次配置

首次啟動時會提示你：

1. 選擇主題（默認即可）
2. 確認安全須知
3. 使用默認終端配置
4. 信任當前工作目錄

完成以上步驟后，即可開始使用。

五、基礎使用指南

5.1 啟動方式

5.2 交互模式常用命令

在 Claude Code 交互界面中，輸入以 / 開頭的斜杠命令：

5.3 實戰(zhàn)示例

理解代碼庫

> 簡要介紹一下這個項目的整體結構和核心功能
> 項目的入口文件在哪里？
> 它是如何處理用戶身份驗證的？

執(zhí)行代碼修改

> 在 main.js 中添加一個處理異常的中間件
> 優(yōu)化目前的登錄邏輯，增加輸入校驗

一次性任務

claude "fix the build error"
claude -p "review this code for potential bugs"

5.4 自動 Git 提交

claude commit

Claude Code 會分析代碼變更，自動生成合適的提交信息并創(chuàng)建提交。

六、高級配置與實用技巧

6.1 環(huán)境變量配置

如需使用 API Key 方式連接 Claude（或使用第三方 API 網(wǎng)關）：

# 臨時設置（僅當前終端會話有效）
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxx"
$env:ANTHROPIC_BASE_URL = "https://your-api-gateway.com"

或者通過系統(tǒng)環(huán)境變量永久設置：

1. Win + R → 輸入 sysdm.cpl → 高級 → 環(huán)境變量
2. 在用戶變量中添加：
   • 變量名：ANTHROPIC_AUTH_TOKEN，值：你的 API Key
   • 變量名：ANTHROPIC_BASE_URL，值：API 地址（如需要）

6.2 Git Bash 路徑配置

如果 Claude Code 提示找不到 git-bash，手動設置環(huán)境變量：

$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

6.3 禁用自動更新

Claude Code 默認會自動更新。如需禁用，在 settings.json 中設置：

export DISABLE_AUTOUPDATER=1

手動更新命令：claude update

6.4 在 VS Code 中使用

Claude Code 支持 VS Code 擴展，可以在編輯器中直接使用。安裝 VS Code 擴展后，點擊編輯區(qū)域 Logo 即可打開對話面板。

七、常見問題排查

7.1 執(zhí)行安裝命令返回語法錯誤

現(xiàn)象：PowerShell 中運行 irm https://claude.ai/install.ps1 | iex 報語法錯誤，提示不支持 var 關鍵字。

原因：網(wǎng)絡問題導致 irm 沒有拿到正確的 PS1 腳本，拿到的是 HTML 頁面。

解決：確保網(wǎng)絡能正常訪問 claude.ai，或配置代理：

$Env:HTTPS_PROXY = "http://127.0.0.1:7890"  # 替換成你的代理端口
irm https://claude.ai/install.ps1 | iex

7.2 提示不支持 32 位 Windows

現(xiàn)象：系統(tǒng)明明是 64 位，但安裝腳本報 “Claude Code does not support 32-bit Windows”。

原因：當前 PowerShell 進程是 32 位的。

解決：強制啟動 64 位 PowerShell：

Start-Process "$env:SystemRoot\SysNative\WindowsPowerShell\v1.0\powershell.exe"

在新窗口中驗證 [Environment]::Is64BitProcess 為 True 后再安裝。

7.3 安裝成功但找不到 claude 命令

現(xiàn)象：安裝成功，但運行 claude 報錯 “無法將 claude 項識別為 …”。

解決：

1. 關閉當前終端，重新打開一個（這是最常見的原因，PATH 只在新終端會話中生效）
2. 如仍無效，手動添加 PATH：Win + R → sysdm.cpl → 環(huán)境變量 → 用戶變量 → PATH → 新建 C:\Users\你的用戶名\.local\bin

7.4 運行 claude 提示缺少 git-bash

現(xiàn)象：安裝日志中出現(xiàn) “Claude Code on Windows requires git-bash”。

解決：

1. 確認已安裝 Git for Windows
2. 設置環(huán)境變量：CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

7.5 使用/doctor命令自診斷

遇到問題時，先運行 /doctor 自診斷，再按錯誤信息對癥處理，是最高效的排查路徑。

7.6 npm 安裝時誤裝仿冒包

如果誤裝了 claude-code（非官方包），先卸載再重裝：

npm uninstall -g claude-code
npm install -g @anthropic-ai/claude-code

八、參考資源

提示：本指南基于 2026 年 4 月的最新信息編寫。如遇版本更新導致的差異，請以官方文檔為準。

到此這篇關于Claude Code Windows 安裝與使用完全指南的文章就介紹到這了,更多相關Claude Code Windows 安裝與使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！

最新評論