Claude Code 安装配置教程：从零开始完整搭建指南

前言

Claude Code 作为当前备受关注的 AI 编程工具，凭借出色的代码生成和理解能力，吸引了大量开发者的目光。它是 Anthropic 公司推出的 AI 编程助手，基于其自研的 Claude 大语言模型。Anthropic 由前 OpenAI 研究副总裁 Dario Amodei 等人于 2021 年创立，专注于 AI 安全研究。与 GitHub Copilot（基于 OpenAI Codex）、Cursor（集成多模型的 AI IDE）等竞品不同，Claude Code 的核心优势在于其超长上下文窗口（最高支持 200K token）和出色的代码推理能力，尤其擅长理解复杂代码库的整体架构并进行跨文件修改。

不过，对于许多初学者来说，命令行工具的安装配置往往是上手的第一道门槛。本文将详细梳理 Claude Code 从零开始的完整安装配置流程，涵盖命令行版本和 VS Code 可视化版本两种配置方式，帮助你快速搭建好开发环境。

环境准备：安装 Claude Code 必需的基础工具

在正式安装 Claude Code 之前，需要先准备好以下基础环境工具。

Git 版本管理工具

Git 是版本管理和代码协作的基础工具。前往 Git 官网，点击下载按钮，选择对应的 Windows 版本进行下载安装即可。

Node.js 运行环境

Node.js 是 Claude Code 运行的必要环境。它是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，使得 JavaScript 能够脱离浏览器在服务器端运行。访问 Node.js 官网，选择 Windows 版本下载。建议选择 LTS（长期支持）版本，LTS 版本通常提供 30 个月的维护周期，稳定性更有保障，适合作为开发工具的运行基础。

安装 Node.js 时会自动附带 npm（Node Package Manager），它是全球最大的开源软件注册中心，托管了超过 200 万个代码包。Claude Code 正是通过 npm 进行分发和安装的。

CC Switch 模型管理工具

CC Switch 是一个模型配置管理工具，主要用于管理 API Key 和切换不同的模型服务。其核心功能是将 Claude Code 的请求转发到不同的大模型 API 服务，采用典型的 API 网关模式——Claude Code 客户端只需对接统一的本地端口，而实际的模型调用由 CC Switch 代理完成。这意味着用户可以灵活切换底层模型（如 DeepSeek、OpenAI、Claude 原生 API 等），而无需修改 Claude Code 本身的配置，这种解耦设计类似于 Nginx 反向代理的工作方式。

前往其官网下载 Windows 版本。下载时浏览器可能弹出安全提示，直接选择保留即可。

VS Code 代码编辑器

VS Code 是微软推出的轻量级代码编辑器，后续我们会在其中安装 Claude 插件来获得可视化的交互体验。直接从 VS Code 官网 下载安装即可。

获取 API Key：配置模型服务的前提

在等待工具下载的同时，可以先去获取 API Key。API Key 本质上是一种身份认证令牌，用于在客户端与模型服务端之间建立可信的通信连接。当你向 AI 模型发送请求时，API Key 会附加在 HTTP 请求头中，服务端据此验证请求者身份并进行计费。

以 DeepSeek 的 API 服务为例（通过 CC Switch 进行中转配置），操作步骤如下：

1. 打开 DeepSeek 官网
2. 点击进入 API 平台
3. 扫码登录账号
4. 创建一个新的 API Key
5. 务必注意： 创建后立即复制并保存到安全的地方，关闭页面后将无法再次查看该 Key

API Key 是后续模型配置的核心凭证，请妥善保管，避免泄露。业界推荐的安全实践包括：不将 Key 硬编码在代码中、使用环境变量存储、定期轮换 Key、以及为不同项目创建独立的 Key 以实现权限隔离。一旦 Key 泄露，他人可能会盗用你的额度甚至访问敏感数据。

安装 Claude Code 并验证环境

基础工具安装

所有工具下载完成后，逐一进行安装。安装过程比较简单，基本一路点击「下一步」即可完成。安装结束后，桌面上会出现 CC Switch 和 VS Code 的快捷图标。

验证安装是否成功

按 Win + R 键，输入 CMD 回车，打开命令行界面。依次输入以下命令验证安装结果：

node -v
git --version
npm -v

如果每条命令都能正确输出版本号，说明基础环境已经配置成功。

通过 npm 全局安装 Claude Code

在命令行中输入以下命令进行安装：

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

这里的 -g 参数表示全局安装，使得 claude 命令可以在系统任意目录下调用，而不仅限于某个特定项目文件夹。@anthropic-ai/claude-code 是 Anthropic 在 npm 注册中心发布的官方包名。

等待安装完成后，输入以下命令验证：

claude --version

成功输出版本号，说明 Claude Code 已安装完毕。

CC Switch 模型配置与启动测试

配置 CC Switch 连接模型

1. 在命令行中输入 claude 先启动一次（会出现初始界面）
2. 打开桌面上的 CC Switch 应用
3. 点击加号按钮添加模型
4. 选择 DeepSeek 作为模型服务
5. 将之前保存的 API Key 粘贴到对应输入框
6. 点击添加，确认状态显示为「使用中」

启动 Claude Code 进行测试

再次按 Win + R 输入 CMD，在命令行中输入 claude，一路按 Enter 确认。出现对话界面后，就可以直接与 AI 进行交互了。

常见问题与解决方案

终端无法启动 Claude Code

部分用户可能遇到在 PowerShell 终端中无法启动 Claude 的情况——CMD 命令行可以正常使用，但终端不行。这通常是环境变量或 PowerShell 执行策略导致的问题。PowerShell 默认的执行策略（Restricted）会阻止运行未签名的脚本，而 npm 全局安装的命令通常通过 .ps1 脚本文件调用。

解决方法是在 PowerShell 中执行特定的策略调整命令，确保在终端和命令行中都能正常启动 Claude Code。

安装过程中 npm 报错

如果 npm 安装过程中出现网络超时或权限错误，可以尝试以下方法：

• 使用管理员权限运行命令行
• 切换 npm 镜像源以提升下载速度
• 检查 Node.js 版本是否满足最低要求

VS Code 可视化配置：图形化交互体验

对于不习惯命令行操作的用户，VS Code 插件版本提供了更友好的图形化交互界面。VS Code 的插件系统基于 Extension API 构建，采用进程隔离的架构设计——每个插件运行在独立的 Extension Host 进程中，即使插件崩溃也不会影响编辑器主进程的稳定性。Claude 官方插件通过 Language Server Protocol（LSP）和 VS Code 的 Webview API 实现与编辑器的深度集成，既能直接访问工作区文件系统，又能提供图形化的对话界面。

安装中文语言包

1. 打开 VS Code
2. 点击左侧插件图标（快捷键 Ctrl + Shift + X）
3. 搜索并安装中文语言包
4. 重启 VS Code 完成汉化

安装 Claude 官方插件

1. 在桌面创建一个工作文件夹
2. 在 VS Code 中打开该文件夹，点击「信任」
3. 进入插件市场，搜索 Claude
4. 选择 Anthropic 官方发布的插件进行安装
5. 安装完成后，右上角会出现一个对话按钮

实际使用演示

点击右上角的对话按钮即可开启与 Claude 的交互。例如，可以输入以下指令：

"写一个 Claude Code 基础使用教程的 HTML 文件，放在当前目录"

等待运行完成后，文件会自动生成在工作目录中，可以直接在浏览器中预览查看效果。

总结：Claude Code 安装配置核心步骤回顾

整个 Claude Code 的安装配置流程并不复杂，核心步骤可以归纳为以下四步：

1. 安装基础环境 — Git 和 Node.js
2. npm 全局安装 — 通过 npm install -g @anthropic-ai/claude-code 完成安装
3. 配置模型服务 — 使用 CC Switch 配置 API Key 和模型
4. 可选图形化体验 — 安装 VS Code 插件获得可视化交互界面

对于开发者而言，命令行版本更加高效灵活；而对于初学者或偏好可视化操作的用户，VS Code 插件版本提供了更低的上手门槛。无论选择哪种方式，Claude Code 都能有效提升编码效率和开发体验。