Windows 安装 Claude Code 完全指南 本文由 Anthropic Claude Opus 4.6 模型自动生成。Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具（CLI），可在终端中以自然语言驱动代码编写、调试与重构。本文将详细介绍如何在 Windows 系统上完成安装与配置，并涵盖 VS Code 集成使用。1. 环境要求项目最低要求操作系统Windows 10 / 11GitGit for Windows（详见第 2 节）Node.js（仅 npm 方式需要）≥ 18.0VS Code（如需扩展）≥ 1.98.0内存≥ 4 GB（推荐 8 GB）订阅计划Claude Pro / Max / Teams / Enterprise，或 API Key（按量付费）网络需要稳定的互联网连接2. 前置准备：安装 GitClaude Code 依赖 Git，所有安装方式均需要预先安装 Git for Windows。访问 Git 官网：https://git-scm.com/downloads/win下载并安装 Git for Windows，安装过程中建议勾选 "Git Bash Here" 上下文菜单选项。验证安装：git --version3. 安装 Claude Code CLI提供三种安装方式，推荐程度由高到低排列。方式一：PowerShell 一键安装（推荐）这是官方推荐的 Windows 原生安装方式，无需预装 Node.js，且支持后台自动更新。安装脚本会将 Claude Code 独立二进制文件下载至 C:\Users\<用户名>\.local\bin 目录，并自动将其添加到用户 PATH。打开 PowerShell（无需管理员权限）。执行以下命令：irm https://claude.ai/install.ps1 | iex安装完成后，关闭并重新打开终端（PATH 更新需要新会话生效），然后验证安装：claude --version方式二：WinGet 安装如果你的系统已内置 WinGet（Windows 10 1709+ / Windows 11 默认包含），可执行：winget install Anthropic.ClaudeCode与 PowerShell 一键安装类似，此方式同样无需 Node.js，支持自动更新。方式三：npm 全局安装适合已有 Node.js 开发环境、或需要精确锁定特定版本的用户。前置步骤：安装 Node.js访问 Node.js 官网：https://nodejs.org/下载 LTS（长期支持版） 安装包（≥ 18.0）。运行安装程序，保持默认选项即可（建议勾选 "Add to PATH"）。验证安装：node -v # 应输出 v18.x.x 或更高版本 npm -v # 应输出 npm 版本号安装 Claude Code打开 Git Bash 或 PowerShell，执行：npm install -g @anthropic-ai/claude-code注意：请勿使用 sudo。如遇权限错误（EACCES），应修复 npm 全局目录权限，而非提权安装。npm 方式不支持自动更新，需手动执行 npm update -g @anthropic-ai/claude-code 升级。验证安装成功：claude --version三种安装方式对比对比项PowerShell 一键安装WinGetnpm 全局安装是否需要 Node.js否否是（≥ 18）自动更新支持支持不支持（需手动）安装位置~\.local\bin系统管理npm 全局目录版本锁定支持支持支持需要管理员权限否否否4. 身份认证安装完成后，需要进行身份认证才能使用。方式一：OAuth 浏览器登录（推荐）适用于 Claude Pro / Max / Teams / Enterprise 订阅用户。在终端中启动 Claude Code：claude首次运行时会自动打开默认浏览器，跳转至 Anthropic 授权页面。使用你的 Claude 账号登录并授权即可。方式二：API Key 认证适用于按量付费用户。前往 Anthropic Console 获取 API Key：https://console.anthropic.com/在「API Keys」页面创建新的密钥并妥善保存。设置环境变量（PowerShell）：# 临时设置（仅当前会话有效） $env:ANTHROPIC_API_KEY = "sk-ant-xxxxx" # 永久设置（写入用户环境变量） [System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxx", "User")启动 Claude Code：claude安全提示： 建议通过系统环境变量或密钥管理器存储 API Key，避免将其明文写入脚本或配置文件中。方式三：通过 settings.json 配置文件适用于使用第三方 API 中转服务或需要持久化配置的用户。找到用户级全局配置文件，路径为：%USERPROFILE%\.claude\settings.json即 C:\Users\<你的用户名>\.claude\settings.json。如果文件不存在，手动创建即可。在文件中通过 env 字段设置认证信息：{ "env": { "ANTHROPIC_API_KEY": "sk-ant-xxxxx" } }如需指向自定义 API 端点（例如第三方中转服务），可同时配置 ANTHROPIC_BASE_URL：{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-xxxxx", "ANTHROPIC_BASE_URL": "https://your-proxy-endpoint.example.com" } }说明：settings.json 中的 env 字段会在 Claude Code 启动时自动注入为环境变量，无需手动执行 export 或 $env: 设置。该文件为用户级全局配置，对所有项目生效。如需项目级配置，可在项目根目录下创建 .claude/settings.local.json，结构相同。此方式的优先级高于系统环境变量。5. 在 VS Code 中使用 Claude CodeClaude Code 提供了官方 VS Code 扩展，可在编辑器内直接与 Claude 交互。5.1 安装扩展打开 VS Code（要求版本 ≥ 1.98.0）。按 Ctrl + Shift + X 打开 扩展（Extensions） 面板。在搜索框中输入 "Claude Code"。找到由 Anthropic 发布的官方扩展，点击 Install 安装。也可通过 VS Code Marketplace 页面直接安装：https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code5.2 登录认证安装完成后：VS Code 侧边栏（Activity Bar）会出现 Claude Code 图标。点击图标打开 Claude Code 面板。首次使用时，按提示完成 OAuth 登录或输入 API Key。5.3 基本使用操作说明打开 Claude 面板点击侧边栏 Claude 图标，或使用快捷键 Ctrl + L提问 / 下达指令在输入框中用自然语言描述需求，如 "重构这个函数"引用选中代码在编辑器中选中代码后打开 Claude 面板，选中内容会自动作为上下文传入应用代码建议Claude 生成的代码修改可直接 Diff 预览并一键应用到文件终端集成Claude 可直接在 VS Code 集成终端中执行命令5.4 常用工作流示例用户：解释一下这段代码的作用 用户：给 calculateTotal 函数添加单元测试 用户：把这个组件从 Class 组件重构为函数组件 用户：查找项目中所有未处理的 Promise 异常6. Windows 常见问题与注意事项Q1：出现 "MSVCP140.dll was not found" 错误原因： 缺少 Microsoft Visual C++ 运行时库。解决方案： 下载并安装最新的 Visual C++ Redistributable：https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redistQ2：MCP Server 在 Windows 上配置异常在 Windows 下配置 MCP（Model Context Protocol）服务器时，需使用 cmd /c 包裹 npx 命令。在项目根目录的 .mcp.json 中：{ "mcpServers": { "example": { "command": "cmd", "args": ["/c", "npx", "your-mcp-server"] } } }Q3：npm 安装后 claude 命令无法识别排查步骤：确认 npm 全局目录在系统 PATH 中：npm config get prefix将输出路径添加到系统环境变量 PATH。重新打开终端后重试。Q4：代理/网络问题导致安装失败如在公司网络或代理环境下安装失败，尝试配置 npm 代理：npm config set proxy http://your-proxy:port npm config set https-proxy http://your-proxy:port7. 相关资源资源链接Claude Code 官方文档https://docs.anthropic.com/en/docs/claude-codeClaude Code GitHub 仓库https://github.com/anthropics/claude-codenpm 包页面https://www.npmjs.com/package/@anthropic-ai/claude-codeVS Code 扩展页面https://marketplace.visualstudio.com/items?itemName=anthropic.claude-codeNode.js 下载https://nodejs.org/Git for Windows 下载https://git-scm.com/downloads/winAnthropic Console（API Key 管理）https://console.anthropic.com/本文档最后更新时间：2026 年 3 月