Windows 10/11 安装 Claude Code 完全指南（2026 年4月最新版）

晨曦蜗牛

1287人浏览 · 2026-04-01 11:50:50

晨曦蜗牛 · 2026-04-01 11:50:50 发布

文章目录

Windows 10/11 安装 Claude Code 完全指南（2026 年4月最新版）

Windows 10/11 安装 Claude Code 完全指南（2026 年4月最新版）

本文面向零基础用户，手把手教你在 Windows 上安装、配置并跑通 Claude Code。全文基于实际操作经验编写，包含常见踩坑点和解决方案。

一、Claude Code 是什么？

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

与 Claude 网页版相比，Claude Code 有以下优势：

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

二、安装前准备

你只需要确认两件事：

检查项	要求
操作系统	Windows 10（Build 19041+）或 Windows 11
Git for Windows	必须安装（Claude Code 内部依赖 Git Bash 执行命令）

2.1 安装 Git for Windows

如果你已经装过 Git，在终端输入 git --version 能显示版本号就跳过这步。

安装步骤：

打开 https://git-scm.com/download/win ，下载安装包；
双击运行安装程序，一路点 Next 使用默认选项即可；
安装完成后，打开 PowerShell 或 CMD，输入：

git --version

看到类似 git version 2.51.0.windows.1 的输出，说明安装成功。

三、安装 Claude Code（推荐方式：原生安装器）

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

方式一：PowerShell 一键安装（推荐）

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

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

等待安装完成即可。

方式二：CMD 安装

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

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

方式三：WSL 安装（Linux）

如果你使用 WSL（Windows Subsystem for Linux），可以在 WSL 终端中运行：

curl -fsSL https://claude.ai/install.sh | bash

安装完成验证

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

claude --version

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

注意：Claude Code 不支持 winget install 安装，请勿尝试 winget install ClaudeCode。

四、备选方式：npm 安装

如果原生安装器因网络等原因无法使用，可以用 npm 方式安装。此方式需要先安装 Node.js。

4.1 安装 Node.js

打开 https://nodejs.org/ ，下载 LTS（长期支持版），版本号 ≥ 18；
双击运行安装程序，一路 Next 使用默认选项；
安装完成后，重新打开 PowerShell 或 CMD，验证：

node --version
// 应输出 v18.x.x 或更高版本

npm --version
// 应输出 9.x.x 或更高版本

4.2 通过 npm 全局安装

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

警告：npm 上存在一个名为 claude-code 的非官方仿冒包，安装后运行会提示 “Wrong package!”。正确的包名是 @anthropic-ai/claude-code（带 @anthropic-ai/ 前缀）。如果你已经误装，先卸载再重装：
npm uninstall -g claude-code
npm install -g @anthropic-ai/claude-code

安装完成后验证（命令是 claude，不是 claude-code）：

claude --version

注意：不要使用 sudo，也不要以管理员身份运行，否则可能导致权限问题。

五、登录认证

Claude Code 需要有效的账户才能使用。有两种认证方式：

方式一：使用 Anthropic API Key（推荐）

如果你有 API Key（格式为 sk-ant-...），直接启动 Claude Code 后会提示输入，或者提前设置环境变量：

PowerShell 中临时设置（当前会话有效）：

$env:ANTHROPIC_API_KEY = "sk-ant-你的密钥"

永久设置环境变量：

按 Win + S 搜索"环境变量"，点击"编辑系统环境变量"；
点击"环境变量"按钮；
在"用户变量"中点击"新建"；
变量名填 ANTHROPIC_API_KEY，变量值填你的 API Key；
一路确定保存，重新打开终端生效。

方式二：使用 Claude.ai 账户登录

claude login

浏览器会自动打开 Anthropic 登录页面，登录后自动完成认证。

注意：免费版 Claude.ai 账户不支持 Claude Code，需要 Claude Pro（$20/月）或更高级别的订阅。

六、第一次运行

6.1 启动 Claude Code

打开终端（PowerShell、CMD 或 Git Bash 均可），输入：

claude

你会看到一个交互式界面，可以直接输入问题或指令。

6.2 试一试

输入以下内容测试：

你好，请用 Python 写一个计算斐波那契数列的函数

Claude 会直接生成代码并可以帮你保存到文件。

6.3 在项目目录中使用

Claude Code 的最佳用法是在你的项目根目录下启动：

cd 你的项目路径
claude

这样它可以读取项目文件、理解代码结构、直接修改文件。

七、配置详解

7.1 配置文件位置

Claude Code 采用多层配置机制，优先级从低到高：

层级	路径	说明
全局配置（用户级）	`%USERPROFILE%\.claude\settings.json`	所有项目通用
项目配置	`项目根目录\.claude\settings.json`	仅当前项目生效，覆盖全局配置
全局 MCP 配置	`%USERPROFILE%\.claude\mcp.json`	全局 MCP 服务器配置
项目 MCP 配置	`项目根目录\.claude\mcp.json`	项目级 MCP 服务器配置

全局配置文件的完整路径为 C:\Users\你的用户名\.claude\settings.json。

7.2 settings.json 完整配置项

{
  // 默认模型：opus / sonnet / haiku
  "model": "opus",

  // 响应语言
  "language": "简体中文",

  // 环境变量（Claude Code 启动时自动加载）
  "env": {
    // API 密钥
    "ANTHROPIC_API_KEY": "sk-ant-你的密钥",
    // 自定义 API 地址（用于代理/中转）
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    // 指定使用的模型 ID
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    // 请求超时时间（毫秒）
    "API_TIMEOUT_MS": "300000",
    // 禁用非必要的遥测流量
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    // 日志级别
    "CLAUDE_CODE_LOG_LEVEL": "info"
  },
  // 工具权限规则：控制哪些工具允许/禁止自动执行
  "permissions": {},
  // 钩子配置：在特定事件（如工具调用前后）执行自定义 shell 命令
  "hooks": {}
}

7.3 各字段说明

下表为各字段详细说明：

字段	类型	说明
`model`	string	默认模型，可选值：`opus` / `sonnet` / `haiku`
`language`	string	响应语言，如 `"简体中文"`、`"English"`
`env`	object	环境变量键值对，Claude Code 启动时自动加载
`permissions`	object	工具权限规则，控制哪些工具允许/禁止自动执行
`hooks`	object	钩子配置，在特定事件（如工具调用前后）执行自定义 shell 命令

7.4 环境变量详解

变量名	作用	示例值
`ANTHROPIC_API_KEY`	API 密钥	`sk-ant-xxx`
`ANTHROPIC_BASE_URL`	自定义 API 地址（用于代理/中转）	`https://api.example.com`
`ANTHROPIC_MODEL`	指定使用的模型 ID	`claude-sonnet-4-6`
`API_TIMEOUT_MS`	请求超时时间（毫秒）	`300000`（5 分钟）
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	禁用非必要的遥测流量	`1`
`CLAUDE_CODE_LOG_LEVEL`	日志级别	`debug` / `info` / `warn` / `error`

7.5 配置示例

日常开发推荐配置：

{
  "model": "sonnet",
  "language": "简体中文",
  "env": {
    "ANTHROPIC_BASE_URL": "你的中转地址",
    "ANTHROPIC_API_KEY": "sk-ant-你的密钥",
    "API_TIMEOUT_MS": "300000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

使用第三方 API 代理：

{
  "env": {
    "ANTHROPIC_API_KEY": "你的中转平台密钥",
    "ANTHROPIC_BASE_URL": "https://你的中转地址"
  }
}

八、在 VS Code 中使用

Claude Code 也提供了 VS Code 扩展，可以在编辑器中直接使用：

打开 VS Code；
进入扩展商店（Ctrl + Shift + X）；
搜索 “Claude Code” 并安装；

VS Code 扩展底层依赖 Claude Code CLI，所以需要先完成上面的安装步骤，否则扩展无法正常工作。

九、常见问题排查

Q1：运行 `claude` 提示"不是内部或外部命令"

原因：安装路径未加入系统 PATH。

解决：

原生安装方式：关闭所有终端窗口，重新打开再试；
npm 安装方式：运行 npm config get prefix，确认输出路径在系统 PATH 中。

Q2：`winget install ClaudeCode` 找不到包

原因：Claude Code 目前不在 winget 仓库中，无法通过 winget 安装。

解决：使用原生安装器或 npm 方式安装（见第三、四章）。

Q3：npm 装了 `claude-code` 但提示 “Wrong package!”

原因：npm 上存在一个非官方的 claude-code 包，它不是 Anthropic 官方发布的。

解决：先卸载错误的包，再安装正确的：

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

正确的包名是 @anthropic-ai/claude-code，安装后的命令是 claude（不是 claude-code）。

Q4：提示 “Claude Code requires Node.js version 18 or higher”

原因：Node.js 版本太低或未安装。

解决：

如果用原生安装器，不需要 Node.js，检查是否有残留的旧版 npm 安装；
如果用 npm 安装，升级 Node.js 到 18+。

Q5：提示 “There’s an issue with the selected model”

原因：API Key 对应的账户没有所选模型的访问权限，或网络不稳定导致模型请求失败。

解决：

在交互模式中运行 /model 切换到其他可用模型；
确认你的 API Key 或订阅计划支持所选模型（如 Opus 需要更高权限）；
如果偶尔出现，可能是临时网络问题，重试即可。

Q6：网络连接失败 / API 超时

解决：

检查网络是否能访问 api.anthropic.com；
如果有代理，配置 ANTHROPIC_BASE_URL 指向可用的中转地址；
增大超时时间：在 settings.json 中设置 "API_TIMEOUT_MS": "300000"。

Q7：安装时下载速度很慢

解决：

npm 用户可以换源：npm config set registry https://registry.npmmirror.com；
原生安装器可以尝试使用 VPN 或代理。

Q8：如何检查安装是否正常？

运行内置诊断工具：

claude doctor

它会自动检查环境配置并报告潜在问题，输出示例：

Diagnostics
└ Currently running: npm-global (2.1.89)
└ Path: D:\Runtime\Nodejs\node.exe
└ Search: OK (vendor)
Updates
└ Auto-updates: disabled (CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC set)
└ Update permissions: Yes
└ Auto-update channel: latest
└ Stable version: 2.1.81
└ Latest version: 2.1.89
Press Enter to continue…

如无报错即为正常，说明安装和配置没有问题。

十、常用命令速查

CLI 命令

命令	作用
`claude`	启动交互模式
`claude "你的问题"`	单次提问（非交互）
`claude --version`	查看版本
`claude doctor`	诊断安装问题
`claude login`	登录认证
`claude logout`	退出登录
`claude config`	查看/修改配置
`claude update`	更新到最新版本
`claude --help`	查看帮助

交互模式内命令

命令	作用
`/help`	查看帮助
`/model`	切换模型
`/config`	打开配置界面
`/clear`	清除对话历史
`/compact`	压缩对话上下文
`/cost`	查看当前会话花费
`/fast`	切换快速输出模式
`Ctrl + C`	中断当前操作
`Ctrl + D`	退出 Claude Code