Claude Code Windows 安装与使用完全指南

目录

• 一、什么是 Claude Code
• 二、系统要求与环境准备
• 2.1 系统要求
• 2.2 安装 Git for Windows（必需）
• 三、安装 Claude Code（推荐方式）
• 3.1 方式一：PowerShell 一键安装（推荐）
• 3.2 方式二：CMD 安装
• 3.3 方式三：npm 安装（备选）
• 3.4 添加 Claude 到 PATH（如需要）
• 3.5 验证安装
• 四、首次启动与认证
• 4.1 创建项目文件夹
• 4.2 启动与认证（包含跳过登录）
• 1. 手动修改配置文件：
• 2. 一键脚本自动修改（推荐）：
• 4.3 配置第三方大模型（DeepSeek / Kimi）
• 方式一：使用图形化工具 CC-Switch（推荐新手）
• 方式二：手动配置环境变量（推荐进阶用户）
• 4.4 首次配置
• 五、基础使用指南
• 5.1 启动方式
• 5.2 交互模式常用命令
• 5.3 实战示例
• 5.4 自动 Git 提交
• 六、高级配置与实用技巧
• 6.1 环境变量配置
• 6.2 Git Bash 路径配置
• 6.3 禁用自动更新
• 6.4 在 VS Code 中使用
• 七、常见问题排查
• 7.1 执行安装命令返回语法错误
• 7.2 提示不支持 32 位 Windows
• 7.3 安装成功但找不到 claude 命令
• 7.4 运行 claude 提示缺少 git-bash
• 7.5 使用/doctor命令自诊断
• 7.6 npm 安装时误装仿冒包
• 八、参考资源

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

核心特点：

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

Claude Code 现已支持 Windows 原生运行，无需配置 WSL。

检查项	要求
操作系统	Windows 10（Build 19041+）或 Windows 11
内存	4GB 最低，8GB 推荐
终端	PowerShell 或 CMD
账号	Claude Pro / Max / Teams / Enterprise（免费版不支持）

Claude Code 在 Windows 上依赖 Git Bash 来执行 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

原生安装器是官方推荐的方式，不需要 Node.js，安装后会自动后台更新。

以普通用户身份打开 PowerShell（不需要管理员权限），运行：

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

等待安装完成即可。

打开 CMD 命令提示符，运行：

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

如果原生安装器因网络等原因无法使用，可以用 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 这个仿冒包。

原生安装器有时可能无法正确将 Claude 添加到 PATH 环境变量中。如果安装后运行 claude 提示命令找不到，按以下步骤修复：

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

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

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

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

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

claude --version

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

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

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

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

由于官方 Claude 账号存在注册限制和网络访问难题，我们可以通过修改本地配置文件的方式，绕过官方的登录验证，直接进入 Claude Code 的交互界面。

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

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

打开 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 命令，即可直接进入交互界面，无需再处理官方登录流程。

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

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 的接口地址是 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%.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 调用会产生费用，请确保账户有足够余额。

首次启动时会提示你：

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

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

命令	说明
claude	启动交互模式，开始对话
claude "task"	运行一次性任务后退出
claude -p "query"	运行查询后退出（不进入交互模式）
claude -c	继续最近的对话
claude commit	自动创建 Git 提交

在 Claude Code 交互界面中，输入以 / 开头的斜杠命令：

命令	说明
/help	显示可用命令
/clear	清除对话历史记录
/doctor	检查安装健康状况
/cost	显示令牌使用统计
/model	选择或更改 AI 模型
/init	使用 CLAUDE.md 初始化项目
/status	查看账户和系统状态
/login	切换 Anthropic 账户
/logout	登出账户
/review	请求代码审查
/bug	报告错误

理解代码库

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

执行代码修改

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

一次性任务

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

claude commit

Claude Code 会分析代码变更，自动生成合适的提交信息并创建提交。

如需使用 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 地址（如需要）

如果 Claude Code 提示找不到 git-bash，手动设置环境变量：

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

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

export DISABLE_AUTOUPDATER=1

手动更新命令：claude update

Claude Code 支持 VS Code 扩展，可以在编辑器中直接使用。安装 VS Code 扩展后，点击编辑区域 Logo 即可打开对话面板。

现象：PowerShell 中运行 irm https://claude.ai/install.ps1 | iex 报语法错误，提示不支持 var 关键字。

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

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

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

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

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

解决：强制启动 64 位 PowerShell：

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

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

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

解决：

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

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

解决：

1. 确认已安装 Git for Windows
2. 设置环境变量：CLAUDE_CODE_GIT_BASH_PATH=C:Program FilesGitbinbash.exe

遇到问题时，先运行 /doctor 自诊断，再按错误信息对症处理，是最高效的排查路径。

如果误装了 claude-code（非官方包），先卸载再重装：

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

资源	链接
Claude Code 官方文档	https://code.claude.com/docs/zh-CN/quickstart
Anthropic 官网	https://www.anthropic.com
Git for Windows	https://git-scm.com/download/win
Node.js 下载	https://nodejs.org

提示：本指南基于 2026 年 4 月的最新信息编写。如遇版本更新导致的差异，请以官方文档为准。

到此这篇关于Claude Code Windows 安装与使用完全指南的文章就介绍到这了,更多相关Claude Code Windows 安装与使用内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！