Claude Code 安装教程

从环境配置到 VS Code 插件使用

分类：技术文章 标签：Claude Code / AI 工具 / 环境配置 / 开发工具

这篇教程记录一次完整的 Claude Code 安装流程，适合第一次配置 AI 编程助手的同学。流程会从 DeepSeek API Key 准备开始，再依次安装 Node.js、Git、Claude Code、cc-switch，最后在命令行和 VS Code 中验证是否可用。

开始前准备：本文默认你的电脑已经安装 VS Code，并且手边有本文提到的 Node.js、Git、cc-switch 安装包。版本号可以按你实际拿到的安装包为准。

一、准备 DeepSeek API Key

先进入 DeepSeek 官网，打开 https://www.deepseek.com，点击页面中的控制台或 API 入口。

进入 DeepSeek 官网并打开控制台入口

进入控制台后，在左侧栏找到 API Keys 页面，点击创建 API Key。

在 DeepSeek 控制台创建 API Key

创建时可以随意填写一个便于识别的名称。API Key 只会完整显示一次，出现后一定要立刻复制并保存到安全位置。

复制并保存 DeepSeek API Key

如果账号里还没有余额，进入充值页面，按需充值。原教程使用的是最低档位 10 元。

DeepSeek 充值页面

安全提醒：API Key 相当于你的接口密码，不要发给别人，也不要截图公开。后续配置时只粘贴到 cc-switch 里。

二、安装 Node.js

双击 Node.js 安装包，例如 node-v24.16.0-x64.msi。安装过程保持默认选项，一路点击下一步，等待安装完成。

安装完成后，按 Win + R，输入 cmd 并回车，打开命令行。

依次执行下面两条命令，检查 Node.js 和 npm 是否安装成功。

node -v
npm -v

如果命令行显示版本号，就说明 Node.js 和 npm 已经安装成功。确认后可以关闭命令行。

Node.js 与 npm 版本检查成功

三、安装 Git

双击 Git 安装包，例如 Git-2.54.0-64-bit.exe。安装过程同样保持默认选项，一路下一步，直到安装完成。

安装完成后，按 Win + R，输入 cmd 打开命令行。

执行下面的命令检查 Git 是否可用。

git -v

如果出现 Git 版本号，就说明 Git 安装成功。确认后可以关闭命令行。

Git 版本检查成功

四、安装 Claude Code

点击键盘 Win 键，在搜索栏搜索 Windows PowerShell。建议右键选择“以管理员身份运行”。有些电脑不用管理员权限也可以，但管理员权限更稳。

以管理员身份打开 Windows PowerShell

如果你在国内网络环境下下载较慢，可以先把 npm 源切换到国内镜像。如果你已经能稳定访问 npm 官方源，这一步可以跳过。

在 PowerShell 中执行下面的命令。

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

执行完成后，关闭 PowerShell，再重新以管理员身份打开 PowerShell。

接着执行 Claude Code 的全局安装命令。

winget install -e --id Anthropic.ClaudeCode

等待进度条结束。如果没有报错，就说明 Claude Code 已经安装完成。

接下来按 Win + R，输入 cmd 打开命令行，执行下面的命令检查版本。

claude --version

如果命令行显示 Claude Code 的版本号，就说明安装成功。

版本说明：这里的 2.1.150 来自原安装教程。后续如果安装包或教程更新，版本号可以替换成你当前要使用的版本。

五、配置 cc-switch

双击 CC-Switch-v3.16.0-Windows.msi 安装包开始安装。安装路径可以改到其他磁盘，不一定要放在系统盘。

安装完成后打开 cc-switch。

打开 cc-switch

确认左侧选择的是第一个配置项，然后点击加号新增配置。

进入配置页面后，选择 DeepSeek，并把前面保存的 API Key 粘贴进去。

在 cc-switch 中选择 DeepSeek 并填写 API Key

继续向下滚动，勾选教程截图中的三个选项，然后点击保存。

勾选 cc-switch 配置选项并保存

保存后，按截图顺序依次点击红框中的按钮，让配置生效并运行检测。

启用 cc-switch 配置

如果页面显示运行正常，就说明 cc-switch 配置成功。

cc-switch 显示运行正常

六、首次运行 Claude Code

按 Win + R，输入 cmd 打开命令行。

输入下面的命令并回车。第一次运行时，命令行会出现一些初始化提示，按提示继续回车即可。

claude

当命令行出现 Claude Code 的交互页面时，说明它已经可以启动。

Claude Code 首次启动页面

可以先问一个简单问题，测试它是否能正常回复。

向 Claude Code 提问并获得回复

七、安装 VS Code 插件

关闭命令行，打开 VS Code。

在扩展市场中搜索 Claude Code for VS Code，下载并安装。

安装 Claude Code for VS Code 插件

继续搜索 Code Runner，并安装这个插件。

安装 Code Runner 插件

到这里，Claude Code 的基础环境、模型接口配置、命令行启动和 VS Code 插件都已经配置完成。