Windows 下极简配置 Claude Code + DeepSeek V4 完整教程

适合完全零基础的小白，跟着做就能在本地拥有一个超低成本的 AI 编程助手。

为什么选择这套方案？

• 成本极低：用 DeepSeek V4 替代官方 Claude API，成本是官方的 1/10 甚至更低。（重点）

• 功能完整：Claude Code 能读/写文件、执行终端命令、生成 Git 提交，真正像一个结对程序员。

• 开箱即用：通过 ZCF 自动化工具，无需手动编辑繁琐的 JSON 配置文件。

准备工作（只需要做一次）

1. 安装 Node.js

Claude Code 基于 Node.js 运行。

• 访问 Node.js 官网，下载 LTS 版本（Windows 安装包 .msi，64-bit）。

• 双击安装，全程保持默认选项，一路 Next 即可。

• 安装完成后，重启电脑（让环境变量生效）。

2. 安装 Git（Windows 必需）

Claude Code 依赖 Git Bash 来执行命令。

• 访问 Git 官网，下载 Windows 版本安装包。

• 安装时同样保持默认选项，一路 Next。

3. 注册 DeepSeek 并获取 API Key

• 打开浏览器，进入 DeepSeek 开放平台。

• 注册一个账号（支持手机号或邮箱）。

• 实名认证，不然无法创建 API Key 。

• 登录后，点击 「创建 API Key」，随便起个名字，复制生成的 sk-xxxx... 密钥，保存到记事本（后面要用）。

💡 整个教程只需要这一个 API Key，不需要任何付费账号，如果要使用还是需要付费。（可以先少量充值体验一下）

正式安装：用 ZCF 一键搞定

ZCF（Zero-Config Code Flow）是一个自动化配置工具，它会帮你完成 Claude Code 安装、DeepSeek 对接、工作流导入等所有繁琐操作。

步骤 1：打开终端

• 按 Win + R，输入 cmd，然后回车。

• 或者直接搜索「cmd」打开。

步骤 2：运行 ZCF 命令

在终端里输入下面这行命令，然后按回车：

npx zcf

系统会提示是否安装 zcf 包，输入 y 并回车。

步骤 3：选择中文界面

? 选择ZCF显示语言
  1. 简体中文   <— 选这个
  2. English

用方向键选中 1，然后回车。

步骤 4：选择完整初始化

你会看到一个彩色菜单，输入 1 （完整初始化）然后回车。

请选择功能
-------- Claude Code --------
1. 完整初始化 - 安装 Claude Code + 导入工作流 + 配置 API ...

步骤 5：选择 Claude Code 安装方式

? 请选择 Claude Code 的安装方式:
  npm  <— 选这个
  powershell [推荐]   
  cmd

用方向键选中 npm，回车。

如果安装过程中提示「Command not found」，别慌，后续用 npm install -g @anthropic-ai/claude-code 手动补装即可（ZCF 会自动跳过已安装部分）。

步骤 6：添加 DeepSeek API 配置

• ZCF 会列出 API 供应商清单，输入 12（DeepSeek）并回车。

• 配置名称随便写，例如 DeepSeek。

• 粘贴你之前保存的 API Key（sk-xxxx...）。

• 问「是否设为默认配置」时，选 yes。

• 问「是否继续添加 Claude Code 配置」时，选 no（因为我们只用一个模型）。

步骤 7：选择工作流（可选但推荐）

你会看到工作流选择界面，用空格键选中下面几个（按自己喜好，初学者可以全选）：

• 通用工具

• 六步工作流

• 功能规划和 UX 设计

• Git 指令

• BMAD-Method 扩展安装器

选好后按回车，ZCF 会自动安装。

步骤 8：选择输出风格（随便选）

推荐选 傲娇大小姐工程师 (好玩)或 工程师专业版，也可以直接回车跳过。

步骤 9：是否配置 MCP 服务？

选 no。MCP 是高级功能，小白暂时不需要。

至此，ZCF 配置完毕。它会自动生成配置文件并保存到 C:\Users\你的用户名\.claude\settings.json。

简单讲下什么是MCP（可以跳过）

手动补装 Claude Code（如果 ZCF 自动安装失败）

在同一个终端中执行：

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

等待安装完成，然后关闭当前终端，重新打开一个新的。

验证安装是否成功：

claude --version

如果显示了版本号（例如 2.0.0），说明安装成功。

绕过官方登录（重要）

因为我们用的是第三方 API，不是 Anthropic 官方账号，所以需要告诉 Claude Code 「已经完成登录」。

在 PowerShell 中执行：

echo '{"hasCompletedOnboarding": true}' > $env:USERPROFILE\.claude.json

这样 Claude Code 启动时就不会要求你登录了。

一般情况下ZCF会自动完成

第一次启动 Claude Code

1. 进入你的项目文件夹：

cd C:\你的项目路径

2. 输入 claude 并回车。

如果一切正常，你会看到一个命令行对话界面，底部状态栏（如果你装了 CCometixLine）会显示模型为 deepseek-v4-pro。

让 Claude 快速了解你的项目

在 Claude Code 中输入：

/init

它会自动扫描项目结构，生成一个 CLAUDE.md 文件。以后 AI 就能更准确地理解你的代码。

让 Claude 帮你提交代码到 GitHub

1. 授予执行 Git 命令的权限

在 Claude Code 中输入 /permissions，然后：

• 选择 1. Add a new rule...

• 输入 Bash(git commit:*)，保存位置选 Project settings (local)。

• 再添加一条 Bash(git push:*)，同样保存到 local。

2. 让 Claude 提交并推送

直接对 Claude 说：

请帮我把所有修改提交，并推送到远程仓库

Claude 会自动执行 git add .、git commit -m "..." 和 git push。

如果提示认证失败，请先在终端中执行 gh auth login 登录 GitHub CLI。

常见问题

Q1: 提示 command not found: claude

解决：关闭终端重新打开，或手动把 C:\Users\你的用户名\AppData\Roaming\npm 添加到系统环境变量 PATH 中。

Q2: 启动后仍然要求登录 Anthropic

解决：确认 C:\Users\你的用户名\.claude.json 文件存在且内容为 {"hasCompletedOnboarding": true}。

Q3: 模型显示不是 DeepSeek

解决：检查 C:\Users\你的用户名\.claude\settings.json 文件中的 ANTHROPIC_BASE_URL 是否为 https://api.deepseek.com/anthropic。

最后

你现在拥有了一个完全由你掌控、成本极低的 AI 结对程序员。不仅可以写代码、改 bug，还能帮你管理 Git 流程。

如果你按照本文一步步操作成功了，欢迎在评论区留言告诉我。遇到任何问题，也可以把报错信息贴出来，我会尽力帮你解决。

Happy Coding! 🚀

本文中使用的工具：

• Claude Code – Anthropic 官方 CLI

• ZCF – 自动化配置工具

• DeepSeek – 高性能低价 API