Claude Code 配置指南

Anthropic 推出的 AI 编程助手，能直接在你的电脑上读写文件、运行命令、管理项目

难度：●●○中等参考时长：约 10-20min支持：windows · macos · linux

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

npm 已废弃：自 v2.1.15（2026 年 1 月）起，npm install -g @anthropic-ai/claude-code 已官方废弃，存在恶意包风险、Node.js 依赖冲突和权限问题。如已用 npm 安装，请先执行 npm uninstall -g @anthropic-ai/claude-code，再使用下方原生安装方式。

1安装方式选择

Claude Code 提供三种安装方式，三者的配置文件共用（Windows：<code>C:\Users\你的用户名\.claude\settings.json</code>），配置一次多处生效：

方式	界面	适合人群	需命令行
CLI 命令行	终端	开发者	✅ 需要
VS Code 插件	IDE 图形界面	用 VS Code 的开发者	可选少量命令
Desktop 桌面版	桌面应用	非开发者 / 轻度使用	❌ 不需要

💡 三者可同时安装，配置文件共享。比如你可以用 CLI 在终端操作、用 VS Code 插件在编辑器里看、用 Desktop 偶尔快速聊天——三处的 API 配置和对话历史完全同步。

2安装前置依赖

需要 Git for Windows：提供 Bash 命令行环境，Claude Code 的原生安装脚本依赖 Bash 执行。同时也用于 Git 版本管理：

powershell

# 安装 Git for Windows

winget install Git.Git

执行后应看到：下载进度条 → "已成功安装"。安装后需重启终端使 Git 生效。重启后运行 git --version，应输出 git version 2.4x.x。

如果 winget 提示找不到 Git：说明你的系统没有 winget（Windows 10 早期版本或 LTSC 版），去 git-scm.com 下载安装包，选择 "64-bit Git for Windows Setup"，双击安装，一路点 Next 就行。

3CLI 命令行安装

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

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

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

powershell

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

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

CMD 用户：curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

常见报错及含义：
① 无法解析域名 / DNS 解析失败 → 没开科学上网或代理未生效，claude.ai 在国内被墙。检查梯子是否开启、终端是否走了代理；
② 连接超时 / Connection timed out → 网络不通，同上；
③ irm : 无法找到命令 → 你在 CMD 里用了 PowerShell 命令，换 PowerShell 再试；
④ 脚本执行被阻止 → PowerShell 执行策略限制，以管理员身份运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 后再试。如仍报错到 B站搜索 "PowerShell 执行策略解除"。

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

powershell

# WinGet 安装（手动更新）

winget install Anthropic.ClaudeCode

# 更新：winget upgrade Anthropic.ClaudeCode

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

如果提示找不到包：① 确保已安装 Git for Windows（winGet 的一些功能依赖 Git）；② 如果仍找不到，WinGet 的包索引可能需要更新——运行 winget update刷新源列表；③ 如果系统没有 winget，到 Microsoft Store 搜索 “应用安装程序” 安装；④ 仍不行到 B站搜索 "Claude Code 国内安装" 查找替代方案。

⚠️ npm 方式已废弃，不推荐使用。如需从 npm 迁移：先备份配置 cp -r ~/.claude ~/.claude.backup，再卸载并运行原生安装命令。

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

4VS 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 → 勾选，禁用登录提示。

5Desktop 桌面版安装

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

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

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

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

直接获取 Claude.msix 安装包（可到 B站或其他网络平台搜索 "Claude Desktop 安装包" 查找）
双击安装（注意：无法指定安装位置）
适用于 Windows 版本 1.8555.2

如果 .msix 双击没反应：以管理员身份运行安装包（右键 → 以管理员身份运行）。如果仍无反应，可能是系统缺少 .msix 运行环境——到 Microsoft Store 搜索 “应用安装程序” 安装后重试。

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

6验证安装

bash

# 检查版本号

claude --version

# 进入项目目录启动

cd 你的项目目录

claude

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

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

如果提示 command not found：Windows 用户检查 Git Bash 是否在 PATH 中；macOS 用户检查 /opt/homebrew/bin 是否在 PATH 中（运行 echo $PATH 查看）；所有平台：关闭终端重新打开后再试，安装后 PATH 环境变量不会立即生效。

7首次运行：你会看到什么

第一次运行 claude 时，按以下顺序出现：

工作目录确认：Claude Code 会问你 "是否信任当前目录？"——选 Yes / Trust。这个提示只在当前目录第一次出现。
Claude Code 需要访问项目文件才能工作，不信任的话 AI 看不到你的代码。
API Key 验证：如果还没配置 API Key（settings.json），Claude Code 会提示你配置。按照「配置指南」操作即可。先用 DeepSeek（国内直连，¥2 起/百万 token），不要直接配 Claude 官方 API（需要科学上网 + 海外支付方式）。
欢迎界面：配置成功后出现 Claude Code 的欢迎界面和输入提示符，可以直接输入指令了。

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

8费用提醒（重要）

Claude Code 本身免费，但 AI 模型按量收费。如果你配的是 DeepSeek API：输入 ¥2/百万 token，输出 ¥8/百万 token，个人日常开发一个月大概 ¥10–50。如果配的是 Claude 官方 API：价格高出 10–30 倍，且需要海外信用卡。建议从 DeepSeek 开始，够用且便宜。充值最低 ¥10 起。价格详见「配置指南」。

💡 如果上述步骤遇到问题，建议到 B站或其他网络平台搜索 "Claude Code + 你的报错信息"，视频教程通常有更详细的演示和最新解决方案。安装完成后，请立即查看「配置指南」配置 API Key——没有配置的话 Claude Code 无法工作。

有疑问？来这里找答案

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

视频教程

B站搜索教程

视频演示 + 疑难解答