一、Claude Code 功能概述

Claude Code 是一款基于命令行的 AI 编程辅助工具，内置了丰富的 Skills 插件体系。通过不同插件的灵活组合，它能够自主完成代码编写、文件操作、依赖安装、测试执行等复杂任务链，大幅提升开发和运维效率。

典型应用场景包括：

• 自动化整理学习笔记，构建个人知识库，支持增删改查

• 按预设模板定时搜集行业资讯，自动生成文稿

• 批量处理代码重构和格式化

• 将内容自动发布到各大社交媒体平台

二、运行环境准备

2.1 安装 Node.js

访问 Node.js 官方网站，下载 Windows 安装程序（.msi 格式）。双击运行，按默认选项一路“下一步”完成安装。

安装完成后，按 Win 键搜索 cmd，右键选择“以管理员身份运行”，依次执行以下命令验证：

cmd

node -v
npm -v

如显示版本号，说明安装成功。

2.2 配置国内镜像源

为避免后续依赖包下载缓慢，将 npm 设置为国内镜像源：

cmd

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

2.3 安装 Git

访问 Git 官网，在 Windows 下载区域选择 64 位安装包（windows x64），下载后双击运行，一路“下一步”完成安装。

验证安装：

cmd

git --version

显示版本号即表示成功。

2.4 安装 cc-switch

cc-switch 是模型切换工具，用于将第三方模型（如 DeepSeek）接入 Claude Code。

在 GitHub 搜索 cc-switch，进入仓库后点击右侧 Releases，下载对应系统版本（Windows 用户选择 .msi 文件）。双击安装包，按默认选项完成安装。

三、Claude Code 安装与配置

3.1 安装 Claude Code

在 CMD 中执行：

cmd

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

安装完成后关闭 CMD 重新打开，验证版本：

cmd

claude --version

输出版本号即安装成功。

3.2 跳过登录直接使用

Claude Code 默认需要登录 Anthropic 账号。通过修改配置文件可跳过此步骤。

在 CMD 中输入 claude 启动控制台，此时会提示登录。关闭控制台，打开资源管理器，在地址栏输入 C:\Users\你的用户名，回车进入用户目录。

如看不到 .claude.json 文件，点击工具栏“查看”→“显示”→“隐藏的项目”。右键该文件，选择“用记事本打开”，在最后一个字段末尾添加英文逗号后，另起一行插入：

json

"hasCompletedOnboarding": true

注意：必须使用英文标点，且前一个字段末尾要加英文逗号，否则配置不生效。保存退出。

重新在 CMD 中输入 claude，会提示是否信任当前文件夹，选择“信任”即可直接进入控制台。

四、接入 DeepSeek V4 模型

4.1 获取 API Key

登录 DeepSeek 官网，进入“API 开放平台”。若未注册，使用手机号完成注册。请注意：API 调用按量计费，账户内需预留一定余额。

在左侧菜单找到“API Keys”，点击“创建 API Key”，输入名称后提交。立即复制密钥并妥善保存——关闭页面后密钥将不再显示，只能重新创建。同时切勿将密钥泄露给他人，否则他人可使用你的额度。

4.2 在 cc-switch 中配置模型

打开 cc-switch 软件，点击右上角“+”号。在“模型预设”下拉框中选择 DeepSeek，填入刚获取的 API Key。将模型名称切换为 deepseek-v4-pro（支持 100 万上下文），否则 Claude Code 默认限制为 128K。完成后点击右下角“添加”。

4.3 验证模型生效

重新打开 CMD，输入 claude 进入控制台，输入 /model 查看当前可用模型列表。确认 DeepSeek V4 已出现在列表中，或直接询问“当前使用的模型是什么？”即可验证。

五、实际使用示例

在桌面新建一个文件夹（名称任意），打开文件夹后在地址栏输入 cmd 回车，在 CMD 中输入 claude 启动控制台，选择信任当前文件夹。

在对话框中输入提示词，例如：

“使用 HTML + CSS + JavaScript 生成一个待办事项管理页面，支持添加、完成、删除任务，界面风格简洁现代。”

Claude Code 在运行过程中会主动申请各类工具权限（如读写文件、安装依赖、启动本地服务等），遇到提示时输入 yes 确认即可。等待执行完毕后，它会通知你生成的文件位置，输入指令让其帮助打开 HTML 文件即可预览效果。

六、常用命令汇总

命令	说明
node -v	查看 Node.js 版本
npm -v	查看 npm 版本
npm config set registry ...	设置 npm 镜像源
git --version	查看 Git 版本
npm install -g @anthropic-ai/claude-code	安装 Claude Code
claude --version	查看 Claude Code 版本
claude	启动 Claude Code 控制台
/model	查看/切换当前模型

七、常见问题与注意事项

• 配置文件中的标点符号必须为英文格式，否则跳过登录配置将失效

• DeepSeek API Key 丢失后无法找回，请务必在生成后第一时间保存

• 首次运行 Claude Code 时，所有工具权限申请建议选择 yes 以确保流程顺畅

• 如遇依赖包下载缓慢，请检查 npm 镜像源是否已正确设置为国内镜像

• 使用 cc-switch 切换模型时，需确保模型名称填写准确，否则无法正常调用

• 若控制台出现网络连接错误，请检查系统代理或防火墙设置是否拦截了 Claude Code 的通信

按照以上步骤操作，即可在本地环境中完成 Claude Code 的部署与配置，并通过 DeepSeek V4 模型获得完整的 AI 编程辅助能力。基础功能开箱即用，如需更强大的自动化能力，可后续添加更多 Skills 插件。