Claude Code + DeepSeek 从零安装教程：纯小白也能 30 分钟上手

zhk177

621人浏览 · 2026-05-20 02:50:33

zhk177 · 2026-05-20 02:50:33 发布

一、这是什么

二、第 1 步：安装 Git

三、第 2 步：安装 Node.js

四、第 3 步：安装 Claude Code

五、第 4 步：获取 DeepSeek API Key

六、第 5 步：配置 settings.json

七、第 6 步：验证是否成功

八、常见问题排查

九、项目地址

一、这是什么

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。你在终端里用自然语言描述需求，它就能自动读代码、改代码、执行命令、提交 Git。

DeepSeek 提供了与 Anthropic 完全兼容的 API 端点（https://api.deepseek.com/anthropic），国内直连、输出只要 6 元/百万 token，约为 Claude 官方价格的 1/30。最低充值 1 元即可使用。

本教程面向没有任何编程基础的纯小白，从安装 Git 开始，Windows / macOS / Linux 三平台每一步都有详细说明。每步末尾都配了验证命令，确保上一步成功了再往下走，不会出现走了半天发现前面是错的这种情况。

二、第 1 步：安装 Git

Git 是版本管理工具，Claude Code 的提交代码、查看改动、切换分支等功能都依赖它。

Windows：

浏览器访问 git-scm.com，点击右侧 Download for Windows
得到 Git-2.xx.x-64-bit.exe，双击运行
一路点 Next（所有选项保持默认即可）
装完后按 Win + R，输入 cmd 回车，在黑色窗口里输入：

git --version

看到 git version 2.xx.x 说明安装成功。

macOS：

打开终端，输入 git --version。如果没装，系统会自动弹窗提示安装 Xcode Command Line Tools，点安装并等待完成。

或者用 Homebrew：brew install git

Linux (Ubuntu/Debian)：

sudo apt update
sudo apt install git -y
git --version

三、第 2 步：安装 Node.js

Claude Code 运行在 Node.js 上，必须先装。

Windows：

访问 nodejs.org，点击左边绿色 LTS 按钮下载
得到 node-v20.xx.x-x64.msi，双击运行
关键步骤：确保 "Add to PATH" 是勾选的（默认就是）
一路 Next 直到完成
关闭旧终端，重新打开一个新的 cmd，输入：

node --version
npm --version

分别显示版本号即安装成功。

macOS：

brew install node
node --version
npm --version

Linux (Ubuntu/Debian)：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
node --version
npm --version

四、第 3 步：安装 Claude Code

Node.js 装好后，用自带的 npm 一行命令安装。

国内用户先设置镜像，否则下载很慢或失败：

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

验证镜像生效：

npm config get registry

# 应输出 https://registry.npmmirror.com

安装：

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

Windows 用户用管理员身份打开终端再执行（右键开始菜单 → 终端（管理员））。

安装约 1-2 分钟，完成后验证：

claude --version

显示版本号即成功。

五、第 4 步：获取 DeepSeek API Key

DeepSeek API 是按量付费的，用多少扣多少，不是按月订阅。最低充值 1 元。

步骤：

打开 platform.deepseek.com，用手机号注册
左侧菜单点「充值」，输入金额（最低 1 元），支付宝或微信扫码支付
左侧菜单点「API Keys」→「创建 API Key」，起个名字（如 claude-code）
立即复制保存 — Key 只显示一次，关掉页面就找不到了
Key 的格式是 sk- 开头的一长串字符

API Key 等于你的账户密码，不要发给任何人，也不要直接写在公开的代码仓库里。

六、第 5 步：配置 settings.json

目的：告诉 Claude Code「别走 Anthropic 官方接口，用 DeepSeek」。

配置文件位置：

系统	路径
Windows	`C:\Users\你的用户名\.claude\settings.json`
macOS / Linux	`~/.claude/settings.json`

如果文件不存在，新建一个即可。

编辑 settings.json，写入以下内容（把 sk-你的... 换成你自己的 API Key）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的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"
  }
}

各字段含义：

字段	作用
`ANTHROPIC_BASE_URL`	API 请求地址，从 Anthropic 改到 DeepSeek
`ANTHROPIC_AUTH_TOKEN`	你的 DeepSeek API Key
`ANTHROPIC_MODEL`	主模型，`[1m]` 表示启用 100 万 token 上下文
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 角色 → 实际用 DeepSeek V4 Pro
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 角色 → 实际用 DeepSeek V4 Pro
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Haiku 角色 → 实际用 DeepSeek V4 Flash（轻量快速）
`CLAUDE_CODE_SUBAGENT_MODEL`	子代理用轻量模型，节省 token
`CLAUDE_CODE_EFFORT_LEVEL`	`max` = 启用最强推理能力，需要深度分析时很有用

保存文件后不需要重启电脑，直接下一步验证。如果之前用过其他配置，建议开新终端窗口确保新配置生效。

七、第 6 步：验证是否成功

启动 Claude Code：

claude

首次启动可能需要 1-2 分钟初始化。看到欢迎界面说明启动成功。

测试对话：

输入一个简单问题，比如「1 + 1 等于几？」，能正常回复说明配置无误。

进阶验证（确认请求确实发到了 DeepSeek）：

claude --debug-file debug.log

随便问一个问题后退出，打开 debug.log，搜索 api.deepseek.com，找到了就 100% 确认接入成功。

八、常见问题排查

问题	原因	解法
`claude` 命令找不到	npm 全局目录未加入 PATH	运行 `npm config get prefix` 查看路径，手动加入系统 PATH
401 Unauthorized 认证失败	API Key 格式错误或余额不足	确认 Key 以 `sk-` 开头，到 DeepSeek 控制台检查状态和余额
响应慢或超时	高峰期排队 + 默认超时太短	在 settings.json 加 `"API_TIMEOUT_MS": "3000000"`
Windows 保存 settings.json 乱码	记事本默认编码非 UTF-8	另存为时编码选 UTF-8，推荐用 VS Code 编辑
`npm install -g` 权限不足	npm 尝试写入系统目录但无权限	用 nvm 管理 Node.js，或创建 `~/.npm-global` 目录
工具调用不如原生 Claude	DeepSeek 工具调用准确率低于 Claude 原生	拆成小步骤操作，每次只改少量内容，多确认结果