Claude Code 安装指南

从零开始安装工具

难度：●●○中等参考时长：约 10-20min

按照以下步骤在你的 Windows 系统上安装 Claude Code。

三种安装方式（CLI / VS Code 插件 / Desktop 桌面版）的配置文件共用（Windows：<code>C:\Users\你的用户名\.claude\settings.json</code>），配一次多处生效。下方按安装方式分别介绍。

npm 安装已标记弃用（详情）

npm 安装已标记弃用：自 v2.1.15（2026 年 1 月）起，官方不再推荐 npm install -g @anthropic-ai/claude-code，原生安装器成为首选。npm 包仍正常更新（最新版 2.1.177），仍可正常使用，只是存在依赖冲突和权限问题的可能。如已用 npm 安装，运行 claude install 即可一键迁至原生版——无需重装，所有配置完整保留。

时效性说明

⚠️ 以上信息可能已过时，请以各平台官方网站的最新公告和定价页面为准。以上 npm 弃用状态、版本号验证于 2026-06-17。

1安装前置依赖

需要 Git for Windows 和 Node.js 18+：Git 用于 Bash 命令行环境（原生安装脚本依赖 Bash），Node.js 用于方式三（npm 安装）。如已安装可跳过：

powershell

# 安装 Git for Windows

winget install Git.Git

# 安装 Node.js 22.x（LTS）

winget install OpenJS.NodeJS.LTS

如果没有 winget

Git：从 git-scm.com 下载安装包，双击安装。

Node.js：从 npmmirror（淘宝镜像）下载国内加速的 Node.js 安装包（速度快），或从 nodejs.org 官方站下载。选 .msi 版本，双击安装，一路 Next，装完后重启终端。

安装后验证

安装后重启终端，运行 git --version（应输出 git version 2.4x.x）和 node --version（应输出 v22.x.x）。

卡在这一步？查看故障排查 → 安装问题

2CLI 命令行安装

网络要求（详情）

网络要求：方式一（原生安装器）需要访问 claude.ai 下载安装脚本，该域名在国内无法直连，需开启科学上网。如果暂时没有科学上网条件，请使用方式二（WinGet，微软 CDN 国内可直连）或方式三（npm，需 Node.js）。安装完成后，模型的 API 配置还涉及网络问题，详见「配置指南」。

选择以下方式之一（推荐原生安装器，支持自动更新）：

方式一：原生安装器（推荐，需科学上网）

powershell

# 在 PowerShell 中运行（非管理员也可）

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

CMD 用户：请使用 PowerShell 脚本安装（powershell -c "irm https://claude.ai/install.ps1 | iex"），或安装 Git Bash 后使用上方 Bash 命令。

预期输出

执行后应看到：下载进度 → 安装完成提示 → 版本号。整个过程约 10–30 秒。

如遇报错，查看故障排查 → 安装问题

方式二：WinGet（无需科学上网，推荐国内用户）

powershell

# WinGet 安装（手动更新）

winget install Anthropic.ClaudeCode

# 更新：winget upgrade Anthropic.ClaudeCode

执行后应看到：搜索包 → 下载进度条 → "已成功安装"。

如遇报错，查看故障排查 → 安装问题

PowerShell vs CMD 区别

看到 PS C:\> 表示在 PowerShell 中，用 irm 命令；看到 C:\> 表示在 CMD 中，用 curl 命令。在 PowerShell 中用 CMD 语法会报错，反之亦然。不确定的话关闭当前窗口，Win+R 输入 powershell 打开干净的 PowerShell。

方式三：npm 安装（三端通用）

npm 是 Claude Code 最早的安装方式。自 v2.1.15 起，官方已将其标记为弃用，推荐原生安装器代替，但 npm 包仍正常更新（截至 2026-06 最新版 2.1.177），仍在维护。当原生安装器或包管理器不可用时，可通过 npm 安装。

npm 需要 Node.js 18+。如果还没装，回到 §1 前置依赖先装好。

国内用户：先切换镜像源再安装

registry.npmjs.org 在国内可能很慢或无法连接。安装前先切换到以下任一国内镜像（推荐淘宝源）：

bash

# 推荐：淘宝源

npm config set registry https://registry.npmmirror.com

# 验证切换成功

npm config get registry

# 应输出：https://registry.npmmirror.com/

其他镜像源（华为云 / 腾讯云）

bash

# 华为云

npm config set registry https://mirrors.huaweicloud.com/repository/npm/

# 腾讯云

npm config set registry https://mirrors.cloud.tencent.com/npm/

# 恢复官方源

npm config set registry https://registry.npmjs.org

bash

# 切换镜像源后执行安装（Windows / macOS / Linux 通用，需 Node.js 18+）

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

# 验证安装

claude --version

# 应输出版本号如 2.1.x

迁移到原生安装

如后续想切换至官方推荐的原生安装，在终端运行 claude install 即可一键迁移。所有配置、会话、记忆完整保留，无需卸载重装。

3VS Code 插件安装

适合习惯在 IDE 中工作的开发者，界面友好、操作直观。支持 Windows 平台。

在线安装

打开 VS Code
扩展商店搜索 "Claude Code"（发布者 Anthropic）
点击安装 → 左侧出现 Claude Code 图标即成功

验证

验证：安装后 VS Code 左侧活动栏会出现一个 Claude Code 图标（对话气泡 + 终端图标组合样式）。点击图标会打开 Claude Code 面板。

离线安装（国内网络不好时）

下载对应平台的离线包（可到 B站或其他网络平台搜索 "Claude Code 离线安装" 查找资源）
VS Code → 扩展 → ... → "从 VSIX 安装" → 选择下载的文件
验证：左侧出现 Claude Code 图标，打开文件时右上角也有图标

注意

VS Code 插件扩展市场在国内可直连，一般不需要离线安装。如果下载速度慢，等一会儿就好（扩展包体积不大）。离线安装包版本可能不是最新的，优先尝试在线安装。

可选设置

可选：VS Code 设置 → 搜索 claudeCode.disableLoginPrompt → 勾选，禁用登录提示。

4Desktop 桌面版安装

适合不需要命令行的 Windows 用户，提供独立的桌面应用体验。

在线安装（需全程科学上网）

官网 claude.ai/download 下载 Claude Setup.exe
双击运行（本质是引导下载器，需联网拉取安装包 Claude.msix）

离线安装（无需科学上网，推荐国内用户）

直接获取 Claude.msix 安装包（可到 B站或其他网络平台搜索 "Claude Desktop 安装包" 查找）
双击安装（注意：无法指定安装位置）
适用于 Windows 桌面版（从 claude.ai/download 下载最新版）

桌面版特别说明

Cowork / Workspace 功能需要沙盒化 Linux 环境，需从 Anthropic 服务器下载约 2.5GB 文件（解压后约 13GB）。国内网络通常连不上，可手动下载文件放入指定目录（见故障排查页）。如果不需要 Cowork 功能，此错误不影响常规对话。

5验证安装

根据你选择的安装方式，验证方法不同：

如果装的是 CLI 命令行

bash

# 检查版本号

claude --version

# 进入项目目录启动

cd 你的项目目录

claude

正常情况

正常情况：claude --version 应输出版本号，格式如 Claude Code v2.x.x。

看到版本号和欢迎界面即安装成功 ✅。

如遇报错，查看故障排查

如果装的是 VS Code 插件

安装后 VS Code 左侧活动栏会出现 Claude Code 图标（对话气泡 + 终端图标组合）。点击图标打开 Claude Code 面板，能看到对话输入框即安装成功 ✅。

如果装的是 Desktop 桌面版

开始菜单或桌面双击 Claude 图标，应用正常启动并显示欢迎页即安装成功 ✅。

6首次运行（CLI 用户）

如果你装的是CLI 命令行版本，第一次运行 claude 时，按以下顺序出现：

工作目录确认：Claude Code 会问你 "是否信任当前目录？"——选 Yes / Trust。这个提示只在当前目录第一次出现。
Claude Code 需要访问项目文件才能工作，不信任的话 AI 看不到你的代码。
API Key 验证：如果还没配置 API Key（settings.json），Claude Code 会提示你配置。按照「配置指南」操作即可。
欢迎界面：配置成功后出现 Claude Code 的欢迎界面和输入提示符，可以直接输入指令了。

第一次使用建议

启动后先输入 你好，介绍一下你自己 测试连通性。如果 AI 正常回复，说明安装和配置都成功了。如果发送后长时间无响应或报错，参考「故障排查」标签页。

VS Code / Desktop 用户提示

VS Code 插件和 Desktop 桌面版用户可跳过本节——验证已在第 6 步完成。

更多参考：Claude Code 中文站

Claude Code 中文站是社区维护的 Claude Code 中文教程，涵盖安装指引、命令参考、高级配置等内容。安装方式侧重于镜像加速和一行命令快速跑通，作为本指南的补充参考。

有疑问？来这里找答案

如果对本站内容有疑问，推荐到视频或其他知识性平台寻求解决方法，也可直接向 AI 提问获得参考性回答（注意分辨 AI 回答的正确性）

视频教程

B站搜索教程

视频演示 + 疑难解答

Claude Code 安装指南

从零开始安装工具

难度：●●○中等参考时长：约 10-20min

按照以下步骤在你的 Windows 系统上安装 Claude Code。

npm 安装已标记弃用（详情）

时效性说明

⚠️ 以上信息可能已过时，请以各平台官方网站的最新公告和定价页面为准。以上 npm 弃用状态、版本号验证于 2026-06-17。

1安装前置依赖

需要 Git for Windows 和 Node.js 18+：Git 用于 Bash 命令行环境（原生安装脚本依赖 Bash），Node.js 用于方式三（npm 安装）。如已安装可跳过：

powershell

# 安装 Git for Windows

winget install Git.Git

# 安装 Node.js 22.x（LTS）

winget install OpenJS.NodeJS.LTS

如果没有 winget

Git：从 git-scm.com 下载安装包，双击安装。

安装后验证

安装后重启终端，运行 git --version（应输出 git version 2.4x.x）和 node --version（应输出 v22.x.x）。

卡在这一步？查看故障排查 → 安装问题

2CLI 命令行安装

网络要求（详情）

选择以下方式之一（推荐原生安装器，支持自动更新）：

方式一：原生安装器（推荐，需科学上网）

powershell

# 在 PowerShell 中运行（非管理员也可）

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

CMD 用户：请使用 PowerShell 脚本安装（powershell -c "irm https://claude.ai/install.ps1 | iex"），或安装 Git Bash 后使用上方 Bash 命令。

预期输出

执行后应看到：下载进度 → 安装完成提示 → 版本号。整个过程约 10–30 秒。

如遇报错，查看故障排查 → 安装问题

方式二：WinGet（无需科学上网，推荐国内用户）

powershell

# WinGet 安装（手动更新）

winget install Anthropic.ClaudeCode

# 更新：winget upgrade Anthropic.ClaudeCode

执行后应看到：搜索包 → 下载进度条 → "已成功安装"。

如遇报错，查看故障排查 → 安装问题

PowerShell vs CMD 区别

方式三：npm 安装（三端通用）

npm 需要 Node.js 18+。如果还没装，回到 §1 前置依赖先装好。

国内用户：先切换镜像源再安装

registry.npmjs.org 在国内可能很慢或无法连接。安装前先切换到以下任一国内镜像（推荐淘宝源）：

bash

# 推荐：淘宝源

npm config set registry https://registry.npmmirror.com

# 验证切换成功

npm config get registry

# 应输出：https://registry.npmmirror.com/

其他镜像源（华为云 / 腾讯云）

bash

# 华为云

npm config set registry https://mirrors.huaweicloud.com/repository/npm/

# 腾讯云

npm config set registry https://mirrors.cloud.tencent.com/npm/

# 恢复官方源

npm config set registry https://registry.npmjs.org

bash

# 切换镜像源后执行安装（Windows / macOS / Linux 通用，需 Node.js 18+）

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

# 验证安装

claude --version

# 应输出版本号如 2.1.x

迁移到原生安装

如后续想切换至官方推荐的原生安装，在终端运行 claude install 即可一键迁移。所有配置、会话、记忆完整保留，无需卸载重装。

3VS Code 插件安装

适合习惯在 IDE 中工作的开发者，界面友好、操作直观。支持 Windows 平台。

在线安装

打开 VS Code
扩展商店搜索 "Claude Code"（发布者 Anthropic）
点击安装 → 左侧出现 Claude Code 图标即成功

验证

验证：安装后 VS Code 左侧活动栏会出现一个 Claude Code 图标（对话气泡 + 终端图标组合样式）。点击图标会打开 Claude Code 面板。

离线安装（国内网络不好时）

下载对应平台的离线包（可到 B站或其他网络平台搜索 "Claude Code 离线安装" 查找资源）
VS Code → 扩展 → ... → "从 VSIX 安装" → 选择下载的文件
验证：左侧出现 Claude Code 图标，打开文件时右上角也有图标

注意

可选设置

可选：VS Code 设置 → 搜索 claudeCode.disableLoginPrompt → 勾选，禁用登录提示。

4Desktop 桌面版安装

适合不需要命令行的 Windows 用户，提供独立的桌面应用体验。

在线安装（需全程科学上网）

官网 claude.ai/download 下载 Claude Setup.exe
双击运行（本质是引导下载器，需联网拉取安装包 Claude.msix）

离线安装（无需科学上网，推荐国内用户）

直接获取 Claude.msix 安装包（可到 B站或其他网络平台搜索 "Claude Desktop 安装包" 查找）
双击安装（注意：无法指定安装位置）
适用于 Windows 桌面版（从 claude.ai/download 下载最新版）

桌面版特别说明

5验证安装

根据你选择的安装方式，验证方法不同：

如果装的是 CLI 命令行

bash

# 检查版本号

claude --version

# 进入项目目录启动

cd 你的项目目录

claude

正常情况

正常情况：claude --version 应输出版本号，格式如 Claude Code v2.x.x。

看到版本号和欢迎界面即安装成功 ✅。

如遇报错，查看故障排查

如果装的是 VS Code 插件

安装后 VS Code 左侧活动栏会出现 Claude Code 图标（对话气泡 + 终端图标组合）。点击图标打开 Claude Code 面板，能看到对话输入框即安装成功 ✅。

如果装的是 Desktop 桌面版

开始菜单或桌面双击 Claude 图标，应用正常启动并显示欢迎页即安装成功 ✅。

6首次运行（CLI 用户）

如果你装的是CLI 命令行版本，第一次运行 claude 时，按以下顺序出现：

工作目录确认：Claude Code 会问你 "是否信任当前目录？"——选 Yes / Trust。这个提示只在当前目录第一次出现。
Claude Code 需要访问项目文件才能工作，不信任的话 AI 看不到你的代码。
API Key 验证：如果还没配置 API Key（settings.json），Claude Code 会提示你配置。按照「配置指南」操作即可。
欢迎界面：配置成功后出现 Claude Code 的欢迎界面和输入提示符，可以直接输入指令了。

第一次使用建议

VS Code / Desktop 用户提示

VS Code 插件和 Desktop 桌面版用户可跳过本节——验证已在第 6 步完成。

更多参考：Claude Code 中文站

有疑问？来这里找答案

如果对本站内容有疑问，推荐到视频或其他知识性平台寻求解决方法，也可直接向 AI 提问获得参考性回答（注意分辨 AI 回答的正确性）

视频教程

B站搜索教程

视频演示 + 疑难解答