Claude Code + DeepSeek 从零安装教程：面向纯小白，6 步拥有自己的 AI 编程助手

一、Claude Code 是什么？

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

它不是 IDE 插件，而是独立运行在终端里的完整编程代理——能理解整个项目的代码结构，跨文件修改，甚至可以帮你从头搭建一个项目。

二、第 1 步：安装 Git

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

Claude Code 不会自动帮你初始化 Git。你需要先打开终端，进入项目文件夹，输入 git init 完成初始化。

Windows：

1. 浏览器访问 git-scm.com，点击右侧Install for Windows

2. 再点击Git for Windows/x64 Setup下载会自动开始

3. 如果下载太慢，可以访问国内镜像网站https://registry.npmmirror.com/binary.html?path=git-for-windows/v2.54.0.windows.1/

4. 得到Git-2.xx.x-64-bit.exe，双击运行

5. 一路点 Next（所有选项保持默认）

6. 装完后按Win + R，输入cmd回车

git --version

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

macOS：

打开终端（Cmd + 空格，搜索「终端」），输入git --version。如果没装，系统会自动弹窗提示安装 Xcode Command Line Tools，点安装并等待完成。

可选：安装 Homebrew ：如果你不想每次手动下载安装包，可以装个 Homebrew（相当于「命令行版 App Store」），后面 Git、Node.js 等开发工具都能一行命令搞定：

先在终端里检查装过没：

brew --version

显示 Homebrew 4.x.x 说明已有，跳到下一步。

如果提示 command not found，运行下面命令安装：

​/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

装好后，Git 也可以用 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：

1. 访问 nodejs.org，点击左边绿色 Node.js® 按钮下载

2. 再点击左下角Windows 安装程序（.msi）下载

3. 如果下载太慢可以访问

   https://registry.npmmirror.com/-/binary/node/v24.16.0/node-v24.16.0-x64.msihttps://registry.npmmirror.com/-/binary/node/v24.16.0/node-v24.16.0-x64.msi

4. 得到node-v20.xx.x-x64.msi，双击运行

5. 关键步骤：确保 "Add to PATH" 是勾选的（默认就是）

6. 一路 Next 直到完成

7. 关闭旧终端，重新打开一个新的 cmd，输入：

node --version npm --version

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

macOS：

如果安装了Homebrew终端输入：

brew install node

或访问 https://nodejs.org 下载.pkg安装包。验证：

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

国内用户先设置 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

显示版本号（如2.1.144 (Claude Code)）即成功。

五、第 4 步：跳过首次登录（重要）

首次运行claude时，Claude Code 会要求登录 Anthropic 账号。因为我们用的是 DeepSeek 后端，不需要 Anthropic 账号，必须跳过这一步。

编辑~/.claude/.claude.json（Windows 在C:\Users\你的用户名\.claude\.claude.json）。

情况一：文件不存在（首次安装）

直接新建，写入：

{
"hasCompletedOnboarding": true
}

情况二：文件已存在（之前装过 Claude Code）

打开后会看到已有的配置，例如：

{
"installMethod": "native",
"autoUpdates": true
}

在最后一个配置项末尾加上英文逗号,，再换行加上新配置：

{
"installMethod": "native",
"autoUpdates": true,
"hasCompletedOnboarding": true
}

逗号在 JSON 中用来分隔同级配置项，和中文里顿号的作用类似——「这一项结束了，后面还有」。最后一项末尾不加逗号。JSON 中所有符号（{ }、:、,）都必须是英文半角，不能混用中文全角。

六、第 5 步：配置 settings.json

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

配置文件位置：

如果文件不存在，新建一个即可。用任意文本编辑器打开，写入以下内容（把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[1m]", "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash[1m]", "CLAUDE_CODE_EFFORT_LEVEL": "max" } }

字段说明：

关闭保存文件，直接下一步验证。

七、第 6 步：获取 DeepSeek API Key

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

1. 打开 platform.deepseek.com，用手机号注册

2. 左侧菜单点「充值」，输入金额（最低 1 元），支付宝或微信扫码支付

3. 左侧菜单点「API Keys」→「创建 API Key」，起个名字（如claude-code）

4. 立即复制保存— Key 只显示一次，关掉页面就找不到了

5. Key 的格式是sk-开头的一长串字符

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

八、第 7 步：验证是否成功

启动 Claude Code：

claude

首次启动可能需要 1-2 分钟初始化。看到欢迎界面说明启动成功。输入一个简单问题，比如「1 + 1 等于几？」，能正常回复说明配置无误。

想确认请求确实发到了 DeepSeek：

claude --debug-file debug.log

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

九、常见问题排查

十、项目地址

GitHub：https://github.com/hawkongz/claude-code-deepseek-guide

如果帮到了你，欢迎 Star ⭐，也欢迎提 Issue 和 PR。