目录

1. 安装前提

  (1)如何使用 PowerShell?

  (2)安装 Node.js 18+

  (3)Git for WindowsVSCode

2. 安装 Claude Code

3. 配置 DeepSeek 写入 Claude Code 配置文件

4. 使用 Claude Code

5. 配置 Claude Code


1. 安装前提

Windows 下建议先装:
1. Node.js 18+        #官方链接:https://nodejs.org/zh-cn
2. Git for Windows    # 官方链接 https://git-scm.com/
官方要求 Claude Code 安装前需要 Node.js 18 或更新版本,Windows 还需要 Git for Windows
(1)如何使用 PowerShell?
已经会的可以直接跳到对应的步骤,不会的一定要看,后续要用到 PowerShell 执行命令
方法1:开始菜单搜索(小白推荐)
按键盘:Win 键
然后输入:PowerShell 按回车搜索, 会看到以下界面,图片标记了 3 种打开方式,以管理员身份运行需要记一下,下面会用到:
点击:Windows PowerShell ,即可打开。

方法2:cmd方式打开(我个人常用)
按: “ Win + r ” 或 “ Win + R ” ,弹出 “运行” 界面后,输入 “ PowerShell ” 直接回车或按 “确定” 按钮
方法3:快捷菜单
按: “ Win + X ” ,弹出菜单:Windows PowerShell ,或者:“终端”,或者英文 “Terminal” 点击“终端”即可。
(2)安装 Node.js 18+
下载 node.js,打开官网: Node.js — 在任何地方运行 JavaScript 点击 " 获取 Node.js" 按钮或者点击 “下载” 后
点击 " 获取 Node.js" 按钮 或者 点击下载后,弹出如下页面,点击 " Windows 安装程序(.msi)" 按钮,按钮上面可以选择对应的平台,一般默认符合你的平台版本。
下载:
  • LTS(长期支持版)✅
  • 不要下载 Current(当前开发版)
下载完成后,得到安装包 :“ node-v24.16.0-x64.msi ” ,双击打开,点击下一步
同意,下一步:
更改安装目录后,下一步
默认,下一步:
暂不勾选自动安装所需的工具包,下一步
到了安装界面,点击 "Install" 安装 按钮,弹出 “是否允许此应用对你的设备进行更改” 的对话框,点击“是”,如果没有弹出默认开始安装即可,如果一直没有进展,查看接下来的步骤
如果没有弹出这个对话框,一直卡在下面这个页面,查看任务栏是否有 “是否允许此应用对你的设备进行更改” 的对话框,点击“是”
点击“是”,允许更改
安装进行中,等待安装完成
完成安装。
安装完成后验证,打开 PowerShell ,输入命令验证:
node -v
npm -v
输入命令按回车键后,能输出版本信息,例如:
v24.16.x
11.13.x
代表安装成功。如果如下图提示:
请使用 “以管理员身份允许” 的方式打开 PowerShell,按 windows 键后,输入 PowerShell 回车后,显示如下图,选择3 以管理员身份运行:
以管理员身份运行后执行如下命令:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
#这条命令意思是运行跑自己的脚本,但阻止从网上下载的未签名脚本偷偷执行,而且只对你当前用户生效。
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  这条命令意思是运行跑自己的脚本,但阻止从网上下载的未签名脚本偷偷执行,而且只对你当前用户生效。
然后输入:Y 回车确认即可
输入 : npm -v   查看版本,执行完成后关闭 PowerShell,重新使用普通方式打开PowerShell 久可以正常使用了
重新打开,不需要管理员方式打开,再执行: npm -v , 通常就正常了。
或者使用 PowerShell 的方式安装,不再介绍,参考官方文档
# Docker 对每个操作系统都有特定的安装指导。
# 请参考 https://docker.com/get-started/ 给出的官方文档
# 拉取 Node.js Docker 镜像:
docker pull node:24-alpine
# 创建 Node.js 容器并启动一个 Shell 会话:
docker run -it --rm --entrypoint sh node:24-alpine
# 验证 Node.js 版本:
node -v #  打印类似信息: "v24.16.0".
# 验证 npm 版本:
npm -v # 打印类似信息: "11.13.0".
(3)Git for WindowsVSCode
下载 git for windows: 打开官方: Git
点击 "Git for Windows/x64 Setup "
下载完成后,得到安装程序:"Git-2.54.0-64-bit.exe" 双击打开安装,除了修改安装路径外,其他都选择默认安装即可
安装完成后,打开 Powershell 窗口 输入命令: git --version 验证,看到版本号即可 ,类似: git version 2.54.x.windows.1
或者打开 Powershell 窗口 输入命令:
winget install --id Git.Git -e --source winget

2. 安装 Claude Code

在 PowerShell 中执行:
#第一种方式(推荐官网):
# 官网,如果失败失败,或者你感觉速度非常慢,可以使用另外2种方式
npm install -g @anthropic-ai/claude-code
#第二种方式:
# 可使用清华大学开源软件镜像站的npm源进行安装
npm install -g @anthropic-ai/claude-code --registry=https://mirrors.tuna.tsinghua.edu.cn/npm/

#第三种方式:
# 如果希望以后默认都使用清华镜像(一劳永逸),可以执行:
npm config set registry https://mirrors.tuna.tsinghua.edu.cn/npm/
#之后直接用下面命令安装即可
npm install -g @anthropic-ai/claude-code 
检查是否安装成功,打开 Powershell 窗口输入命令: claude --version
看的版本号,即可,例如输出:2.1.158 (Claude Code)

3. 配置 DeepSeek 写入 Claude Code 配置文件

(1)把 DeepSeek配置写到 Claude Code 的配置文件,如果没有 .claude 文件夹,就手动创建,创建方法在下一步。
路径: C:\Users\你的用户名\.claude\settings.json
内容如下:
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "API_TIMEOUT_MS": "3000000"
  },
  "claudeCode.disableLoginPrompt": true,
  "attribution": {
    "commit": "",
    "pr": ""
  }
}

配置好后

DeepSeek 主模型:deepseek-v4-pro[1m]
DeepSeek 轻量模型:deepseek-v4-flash
参数
作用
当前配置的含义
model
Claude Code 启动时的初始模型
写的是 deepseek-v4-pro,但可能被 ANTHROPIC_MODEL 覆盖
env
给 Claude Code 每次会话注入环境变量
里面放 DeepSeek 接入配置
ANTHROPIC_BASE_URL
改变 Claude Code 请求发送到哪里
发到 DeepSeek 的 Anthropic 兼容接口
ANTHROPIC_AUTH_TOKEN
鉴权 Token
你的 DeepSeek API Key
ANTHROPIC_MODEL
主会话使用的模型
当前主模型是
deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_SONNET_MODEL
当 Claude Code 使用 sonnet 别名时映射到哪个模型
映射到 DeepSeek-V4-Pro
ANTHROPIC_DEFAULT_OPUS_MODEL
当 Claude Code 使用 opus 别名时映射到哪个模型
映射到 DeepSeek-V4-Pro
ANTHROPIC_DEFAULT_HAIKU_MODEL
当 Claude Code 使用 haiku 或轻量模型时映射到哪个模型
映射到 DeepSeek-V4-Flash
CLAUDE_CODE_SUBAGENT_MODEL
子 Agent / 后台小任务使用的模型
用 Flash,速度快、成本低
CLAUDE_CODE_EFFORT_LEVEL
推理努力级别
max 表示尽量深入推理,速度会慢一些,消耗也更高
claudeCode.disableLoginPrompt
禁止登录 Claude
想用 DeepSeek,不想登录 Anthropic 时需要开启
attribution.commit
禁止 Git Commit 署名,是否显示
"这段代码是Claude辅助完成的"
git 提交记录关闭 claude 署名
attribution.pr
禁止 PR 署名,是否显示
"这段代码是Claude辅助完成的"
git 提交记录关闭 pr 署名
Claude Code 官方说明,用户级配置文件位置是 ~/.claude/settings.json,Windows 下对应路径: %USERPROFILE%\.claude\
(2)怎么找到 .claude 文件夹:C:\Users\你的用户名\.claude
打开文件夹在路径框里里输入: %USERPROFILE%  然后按回车, 如果没有 .claude 文件夹和 settings.json 文件,就手动创建,右键新建文件夹,重命名为 .claude ,接下来在 .claude 文件夹创建 settings.json 文件
(3)创建 settings.json 文件
右键新建文本文档,把后缀和名字修改为 settings.json ,修改后如果不是JSON文件,则把文件扩展名 选项勾选上
打开文件扩展名:

4. 使用 Claude Code

进入项目目录启动,例如你的项目:E:\code\tool\WorkTimeTool
打开 PowerShell 输入命令切换工作目录:
cd E:\code\tool\WorkTimeTool
启动 Claude Code,输入命令:claude
进入后会看到类似:
选择默认“Dark mode ”即可 ,按回车
按回车,继续
选择默认1即可,按回车,进入下面界面,可以看的 Welcome back! deepseek-v4-pro[1m] 等字样,就代表安装配置成功,可以正常使用
验证,输入 :/status ,可以看到如下内容:
输入内容:“请阅读当前项目代码,并总结:1:项目整体架构”
输入完成后按回车,如下图代表正常执行,如果要输入多条内容,可以空格间隔,不要使用回车,回车代表执行

  除了编程,也可以切换到文档文件夹,让 Claude 帮你总结,输入:按照xxx的要求,帮我总结当前文件夹里的内容等,让 Claude 帮你做表格,统计数据等,让 Claude 下载安装软件、配置软件,可以想一想让 Claude 帮你做更多的事情。

5. 配置 Claude Code

在项目根目录创建:CLAUDE.md 文件
例如:
# 项目规范使用 Qt 5.14.2使用 C++17禁止使用裸指针统一使用 std::shared_ptr写操作使用 unique_lock读操作使用 shared_lock
以后 Claude Code 修改代码时会自动遵守这些规则。
比较好用的配置、skill 关注我,后续会更新
更推荐 VSCode + Claude Code 插件 配置DeepSeek 的方式,可参考 《零基础搭建 VSCode + Claude Code + DeepSeek 教程》

更多推荐