零门槛安装 Claude Code 保姆级教程 (2026 最新版)

第一步：准备基础环境

Claude Code 是基于 Node.js 开发的，因此我们需要先安装 Node.js 和 Git。

1. 安装 Node.js (核心依赖)
   • 下载地址：Node.js 官方中文网
   • 操作步骤：
     • 进入官网，点击左侧带有 “LTS” 字样的按钮下载（推荐 v18.x, v20.x 或 v22.x）。
     • 运行安装包，务必勾选 “Add to PATH”，然后一路点击 “Next” 完成安装。
   • 验证：打开终端（PowerShell/CMD），输入 node -v 和 npm -v。如果显示版本号（如 v18.18.0），说明安装成功。
2. 安装 Git (必备工具)
   • 下载地址：Git 官方网
   • 操作步骤：
     • 推荐使用 Winget 命令快速安装（无需手动下载）：
     • 打开终端，输入并回车执行：winget install Git.Git

第二步：配置 npm 国内镜像 (关键步骤)

由于官方源服务器在国外，国内直接安装会非常慢或报错。请务必配置淘宝镜像源。

• 设置命令：在终端中执行以下命令：
  npm config set registry https://registry.npmmirror.com
• 验证命令：npm config get registry
• 预期结果：返回 https://registry.npmmirror.com/ 即表示配置成功。这能让你的安装速度飞起。

第三步：一键安装 Claude Code

环境准备好后，只需一条命令即可完成安装。

1. 以管理员身份运行终端：
   • 在任务栏搜索 “PowerShell” 或 “终端”，右键选择 “以管理员身份运行”。
2. 执行安装命令：
   • 复制以下命令并回车执行：
     irm https://claude.ai/install.ps1 | iex
   • 注：如果上述脚本报错，可尝试备选命令：npm install -g @anthropic-ai/claude-code
3. 验证安装：
   • 安装完成后，输入 claude --version。
   • 如果能看到版本号输出，恭喜你，Claude Code 框架已成功安装！

第四步：国内免翻墙配置 (核心)

Claude 官方服务在国内访问受限，我们需要通过配置国内大模型 API 来实现“零门槛”使用。推荐使用 CC Switch 工具，操作最简单。

方案一：使用 CC Switch (推荐)

CC Switch 是一款专为国内用户设计的 API 管理工具，能自动将请求转发到国内大模型（如智谱、DeepSeek 等）。

1. 下载安装：
   • 官方发布页 (夸克网盘)：点击下载 Windows 版
   • GitHub 项目主页：CC Switch GitHub
   • 下载 .msi 安装包并双击运行安装。
2. 配置模型：
   • 打开 CC Switch 软件。
   • 在 Claude 栏下，点击右上角的 “+” 号新增配置。
   • 填入你申请的国内大模型 API Key（如阿里云百炼、智谱 GLM 等）。
   • 请求地址通常会自动填充，保持默认即可。
3. 启用：
   • 点击启用该配置，然后重启终端。此时你在终端中运行 claude "你好"，实际上是在调用国内的大模型服务。

方案二：手动修改配置文件 (进阶)

如果你已有 API Key，可以直接修改配置文件：

1. 找到或新建文件：
   • 路径：C:\Users\<你的用户名>\.claude\settings.json
2. 填入配置：
   • 将以下内容复制进去，替换其中的 YOUR_API_KEY 和 BASE_URL：

1
2
3
4
5
6
7

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "代理地址",
    "ANTHROPIC_MODEL": "模型名称"
  }
}

常见问题与避坑指南

按照以上步骤操作，你现在已经拥有了一个强大的 AI 编程助手。如果有其他问题，欢迎随时问我！