平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code Windows 安装与使用完全指南”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

一、什么是 Claude Code

实际处理时，Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，可以直接在命令行中与 Claude 大模型对话，帮助你写代码、改 Bug、分析项目、执行文件操作等。

核心特点：

• 直接操作文件：可读取、新建、修改项目中的代码文件
• 理解项目上下文：自动分析项目结构
• 执行终端命令：可运行构建、测试等 shell 命令
• 集成 IDE：兼容 VS Code 扩展，在编辑器中直接采用

在这个场景下，Claude Code 现已兼容 Windows 原生运行，无需设置 WSL。

二、系统要求与环境准备

2.1 系统要求

2.2 安装 Git for Windows（必需）

在这个场景下，Claude Code 在 Windows 上依赖 Git Bash 来执行 shell 命令，所以必须先安装 Git for Windows。

安装步骤：

• 访问 （链接已移除），下载安装包
• 双击运行安装程序，一路点 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 安装（备选）

在这个场景下，若原生安装器因网络等原因无法采用，可以用 npm 方式安装。此方式需先安装 Node.js（版本 ≥ 18）。

从 （链接已移除） 下载 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 环境变量中。如果安装后运行 claude 提示命令找不到，按以下步骤修复：

手动添加环境变量（PowerShell）：

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

关闭同时重新打开 PowerShell 使 PATH 生效。

说明：Claude Code 默认安装到 %USERPROFILE%.localbinclaude.exe。

3.5 验证安装

安装完成后，关闭并重新打开终端窗口，输入：

claude --version

能看到类似 2.1.89 (Claude Code) 的版本号输出，说明安装成功。

四、首次启动与认证

4.1 新建项目文件夹

在这个场景下，建议先新建一个专门的项目文件夹，而不是直接在用户主目录中启动 Claude Code：

New-Item -ItemType Directory -Path C:projectsmy-project -Force
cd C:projectsmy-project

这样做的原因是：Claude Code 启动时会询问是否信任当前文件夹中的文件。在空项目文件夹中回答此问题更安全。

4.2 启动与认证（包含跳过登录）

落到代码里，由于官方 Claude 账号存在注册限制和网络访问难题，我们能够借助修改本地设置文件的方式，绕过官方的登录验证，直接进入 Claude Code 的交互界面。

1. 手动修改设置文件：

• 实际处理时，用记事本或代码编辑器打开位于 C:Users你的用户名 路径下的 .claude.json 文件。
• 在文件中添加 "hasCompletedOnboarding": true 这一行设置。请务必注意 JSON 格式，在上一行末尾补上英文逗号。

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

2. 一键脚本自动修改（建议）：

打开 PowerShell，直接复制并执行以下脚本，即可自动完成上述修改

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）

实际处理时，要采用第三方模型，核心是设置两个环境变量：ANTHROPIC_BASE_URL（API接口地址）和 ANTHROPIC_AUTH_TOKEN（你的API密钥）。这里提供两种设置方式：

方式一：采用图形化工具 CC-Switch（建议新手）

在这个场景下，CC-Switch 是一个可视化工具，能帮你轻松管理和切换模型，省去手动设置的繁琐。

1. 拿到 API Key：前往你选择的模型平台注册并新建 API Key。
   • DeepSeek：DeepSeek 开放平台
   • Kimi（月之暗面）：Kimi API 平台
   • 更多兼容模型：也可以选择 GLM、Qwen 等。
2. 安装并采用 CC-Switch：
   • 下载并安装 CC-Switch 工具。
   • 打开软件，点击“+”号，选择模型并粘贴你的 API Key，保存设置。
3. 启动 Claude Code：
   • 在后台保持 CC-Switch 运行。
   • 在终端输入 claude 启动，然后输入 /model 命令，即可看到同时切换为你设置的第三方模型。

方式二：手动设置环境变量（建议进阶用户）

若你更倾向于直接控制，可以手动设置环境变量。

方法 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 的接口地址是 （链接已移除）。

2. 接入 Kimi：

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

注意：Kimi 的接口地址是 （链接已移除）。

方法 B：永久设置（建议）

在用户目录下的 %USERPROFILE%.claudesettings.json 文件中写入设置。

1. 新建或打开文件：在终端中运行 notepad $env:USERPROFILE.claudesettings.json。
2. 根据你选择的模型，填入以下设置之一，保存文件即可。

示例：为 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 区域看到 API Key 和 API Base 信息，确认设置无误。请注意，API 调用会产生费用，请确保账户有足够余额。

4.4 首次设置

首次启动时会提示你：

1. 选择主题（默认即可）
2. 确认安全须知
3. 采用默认终端设置
4. 信任当前工作目录

完成以上步骤后，即可开始采用。

五、基础采用指南

5.1 启动方式

5.2 交互模式常用命令

实际处理时，在 Claude Code 交互界面里，输入以 / 开头的斜杠命令：

5.3 实战示例

理解代码库

> 简要介绍一下这个项目的整体结构和核心功能
> 项目的入口文件在哪里？
> 它是如何处理用户身份验证的？

执行代码修改

> 在 main.js 中添加一个处理异常的中间件
> 优化目前的登录逻辑，增加输入校验

一次性任务

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

5.4 自动 Git 提交

claude commit

实际处理时，Claude Code 会分析代码变更，自动生成合适的提交信息同时新建提交。

六、高级设置与实用技巧

6.1 环境变量设置

如需采用 API Key 方式连接 Claude（或采用第三方 API 网关）：

# 临时设置（仅当前终端会话有效）
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxx"
$env:ANTHROPIC_BASE_URL = "https://your-api-gateway.com"

或者借助系统环境变量永久设置：

1. Win + R → 输入 sysdm.cpl → 高级 → 环境变量
2. 在用户变量中添加：
   • 变量名：ANTHROPIC_AUTH_TOKEN，值：你的 API Key
   • 变量名：ANTHROPIC_BASE_URL，值：API 地址（如需）

6.2 Git Bash 路径设置

落到代码里，若 Claude Code 提示找不到 git-bash，手动设置环境变量：

$env:CLAUDE_CODE_GIT_BASH_PATH = "C:Program FilesGitbinbash.exe"

6.3 禁用自动更新

在这个场景下，Claude Code 默认会自动更新。如需禁用，在 settings.json 中设置：

export DISABLE_AUTOUPDATER=1

手动更新命令：claude update

6.4 在 VS Code 中采用

在这个场景下，Claude Code 兼容 VS Code 扩展，可以在编辑器中直接采用。安装 VS Code 扩展后，点击编辑区域 Logo 即可打开对话面板。

七、常用问题排查

7.1 执行安装命令得到语法错误

现象：PowerShell 中运行 irm （链接已移除） | iex 报语法错误，提示不兼容 var 关键字。

原因：网络问题导致 irm 没有拿到正确的 PS1 脚本，拿到的是 HTML 页面。

解决：确保网络能正常访问 claude.ai，或设置代理：

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

7.2 提示不兼容 32 位 Windows

现象：系统明明是 64 位，但安装脚本报 “Claude Code does not support 32-bit Windows”。

原因：当前 PowerShell 进程是 32 位的。

解决：强制启动 64 位 PowerShell：

Start-Process "$env:SystemRootSysNativeWindowsPowerShellv1.0powershell.exe"

在新窗口中验证 [Environment]::Is64BitProcess 为 True 后再安装。

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

现象：安装成功，但运行 claude 报错 “无法将 claude 项识别为 ……”。

解决：

1. 关闭当前终端，重新打开一个（这是最常用的原因，PATH 只在新终端会话中生效）
2. 实际处理时，如仍无效，手动添加 PATH：Win + R → sysdm.cpl → 环境变量 → 用户变量 → PATH → 新建 C:Users你的用户名.localbin

7.4 运行 claude 提示缺少 git-bash

现象：安装日志中出现 “Claude Code on Windows requires git-bash”。

解决：

1. 确认已安装 Git for Windows
2. 设置环境变量：CLAUDE_CODE_GIT_BASH_PATH=C:Program FilesGitbinbash.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这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。