声明:本教程仅供网络安全技术学习与交流,严禁用于非法用途。请在获得合法授权的环境下进行测试,遵守《网络安全法》及相关法律法规。因违规操作产生的一切法律后果由使用者自行承担,与作者无关
注意:ai接入详细步骤请看上一篇Claude CodeLinux部署
本笔记记录了从安装基础环境到配置第三方模型(DeepSeek)接入 Claude Code 的完整流程。
1. 安装 Git
Git 是版本控制工具,也是运行 Claude Code 的基础依赖。
-
下载 :访问
git-scm.com,点击 Windows 下的 Click here to download 下载最新版安装包。Git - Install for Windows
-
安装设置:
-
运行安装包,选择安装路径(建议非系统盘,如
D:\AppDownloads\Git)。
-
组件选择 :保持默认勾选即可(特别是 Windows Explorer integration 和 Git LFS)。

-
后续步骤一路点击 Next。
-
-
完成 :点击 Finish 。打开 CMD 输入
git --version验证是否成功。
2. 安装 Node.js
Node.js 提供了运行环境和 npm 包管理器。
-
下载 :访问
nodejs.org,点击顶部 Download 。Node.js --- Run JavaScript Everywhere
-
选择版本:
-
确认系统为 Windows ,架构为 x64。
-
点击下载 Windows Installer (.msi)。

-
-
安装设置:
-
运行 msi 文件,一路点击 Next。

-
Tools for Native Modules :如果不需要编译复杂的 C++ 模块,可以直接点 Next(若后续报错再回来补装 Python 和 VS Build Tools)。
-
-
完成 :点击 Finish 。打开 CMD 输入
node -v和npm -v验证。
3. 安装 Claude Code
使用 npm 全局安装 Claude Code 命令行工具。为了加速下载,这里使用了国内镜像源。
在 CMD 中执行以下命令:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

-
验证 :安装完成后,输入
claude --version,显示版本号(如2.1.303)即表示安装成功。
4. 配置文件与 API 设置 (关键步骤)
这一步用于将 Claude Code 的请求转发到第三方 API(截图中使用的是 DeepSeek 的接口)。
-
创建配置文件:
-
进入用户主目录:
C:\Users\你的用户名\ -
找到或新建文件夹:
.claude -
在该文件夹内新建文件:
settings.json
-
-
编辑内容 : 用记事本或代码编辑器打开
settings.json,填入以下 JSON 配置(注意替换为你自己的 Key):
{ "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "sk-这里填你的DeepSeek_API_Key", "ANTHROPIC_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat", "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-chat", "CLAUDE_CODE_EFFORT_LEVEL": "max" } }
注意 :截图中的模型名称写的是
deepseek-v4-pro[1m]等,这可能是特定渠道的内部命名。如果你使用的是公开版 DeepSeek API,建议将模型字段改为标准的deepseek-chat或deepseek-reasoner,否则可能会报模型不存在错误。
5. 首次启动与主题选择
-
在终端输入
claude启动。 -
首次运行会询问终端配色风格(Text Style):
- 建议选择 Dark mode(深色模式),看起来更舒适且符合开发者习惯。
-
看到 ASCII 艺术字和
Let's get started提示,说明环境已就绪。
避坑与安全提示
-
关于权限 :启动时如果提示
Accessing workspace,尽量在专门的项目文件夹(如D:\Code\MyProject)里运行,不要在用户根目录直接运行,以免误删文件。 -
关于跳过权限 :尽量不要使用
--dangerously-skip-permissions参数,除非你完全清楚自己在做什么。让 Claude 每次执行敏感操作前询问你,是更安全的选择。 -
API 费用:配置了 Key 后,每次对话都会消耗余额,请注意监控用量。