一、Claude Code 是什么Claude Code 是 Anthropic 推出的命令行 AI 编程助手。在终端里用自然语言描述需求它就能自动读代码、改代码、执行命令、提交 Git。它不是 IDE 插件而是独立运行在终端里的完整编程代理——能理解整个项目的代码结构跨文件修改甚至可以帮你从头搭建一个项目。二、第 1 步安装 GitGit 是版本管理工具Claude Code 的提交代码、查看改动、切换分支等功能都依赖它。Claude Code 不会自动帮你初始化 Git。你需要先打开终端进入项目文件夹输入 git init 完成初始化。Windows浏览器访问 git-scm.com点击右侧Install for Windows再点击Git for Windows/x64 Setup下载会自动开始如果下载太慢可以访问国内镜像网站https://registry.npmmirror.com/binary.html?pathgit-for-windows/v2.54.0.windows.1/得到Git-2.xx.x-64-bit.exe双击运行一路点 Next所有选项保持默认装完后按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 gitLinux (Ubuntu/Debian)sudo apt update sudo apt install git -y git --version三、第 2 步安装 Node.jsClaude Code 运行在 Node.js 上必须先装。Windows访问 nodejs.org点击左边绿色 Node.js® 按钮下载再点击左下角Windows 安装程序.msi下载如果下载太慢可以访问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得到node-v20.xx.x-x64.msi双击运行关键步骤确保 Add to PATH 是勾选的默认就是一路 Next 直到完成关闭旧终端重新打开一个新的 cmd输入node --version npm --version分别显示版本号即安装成功。macOS如果安装了Homebrew终端输入brew install node或访问 https://nodejs.org 下载.pkg安装包。验证node --version npm --versionLinux (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-codeWindows 用户用管理员身份打开终端右键开始菜单 → 终端管理员否则可能权限不足。安装约 1-2 分钟完成后验证claude --version显示版本号如2.1.144 (Claude Code)即成功。五、第 4 步跳过首次登录重要首次运行claude时Claude Code 会要求登录 Anthropic 账号。因为我们用的是 DeepSeek 后端不需要 Anthropic 账号必须跳过这一步。编辑~/.claude/.claude.jsonWindows 在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」。配置文件位置系统路径WindowsC:\Users\你的用户名\.claude\settings.jsonmacOS / Linux~/.claude/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[1m], CLAUDE_CODE_SUBAGENT_MODEL: deepseek-v4-flash[1m], CLAUDE_CODE_EFFORT_LEVEL: max } }字段说明字段作用ANTHROPIC_BASE_URLAPI 请求地址从 Anthropic 改到 DeepSeekANTHROPIC_AUTH_TOKEN你的 DeepSeek API KeyANTHROPIC_MODEL主模型[1m]表示启用 100 万 token 上下文ANTHROPIC_DEFAULT_OPUS_MODELOpus 角色 → 实际用 DeepSeek V4 ProANTHROPIC_DEFAULT_SONNET_MODELSonnet 角色 → 实际用 DeepSeek V4 ProANTHROPIC_DEFAULT_HAIKU_MODELHaiku 角色 → 实际用 DeepSeek V4 Flash轻量快速CLAUDE_CODE_SUBAGENT_MODEL子代理用轻量模型节省 tokenCLAUDE_CODE_EFFORT_LEVELmax 启用最强推理能力关闭保存文件直接下一步验证。七、第 6 步获取 DeepSeek API KeyDeepSeek API 是按量付费的用多少扣多少不是按月订阅。最低充值 1 元日常使用够用很久。打开 platform.deepseek.com用手机号注册左侧菜单点「充值」输入金额最低 1 元支付宝或微信扫码支付左侧菜单点「API Keys」→「创建 API Key」起个名字如claude-code立即复制保存— Key 只显示一次关掉页面就找不到了Key 的格式是sk-开头的一长串字符API Key 等于你的账户密码不要发给任何人也不要直接写在公开的代码仓库里。八、第 7 步验证是否成功启动 Claude Codeclaude首次启动可能需要 1-2 分钟初始化。看到欢迎界面说明启动成功。输入一个简单问题比如「1 1 等于几」能正常回复说明配置无误。想确认请求确实发到了 DeepSeekclaude --debug-file debug.log随便问一个问题后退出打开debug.log搜索api.deepseek.com找到了就 100% 确认接入成功。九、常见问题排查问题原因解法claude命令找不到npm 全局目录未加入 PATH运行npm config get prefix查看路径手动加入系统 PATH401 Unauthorized 认证失败API Key 格式错误或余额不足确认 Key 以sk-开头到 DeepSeek 控制台检查状态和余额响应慢或超时高峰期排队 默认超时太短在 settings.json 加API_TIMEOUT_MS: 3000000Windows 保存 settings.json 乱码记事本默认编码非 UTF-8另存为时编码选 UTF-8推荐用 VS Code 或 Notepadnpm install -g权限不足npm 试图写入系统目录但无权限用 nvm 管理 Node.js或创建~/.npm-global目录工具调用不如原生 ClaudeDeepSeek 工具调用准确率低于 Claude 原生拆成小步骤操作每次只改少量内容多确认结果十、项目地址GitHubhttps://github.com/hawkongz/claude-code-deepseek-guide如果帮到了你欢迎 Star ⭐也欢迎提 Issue 和 PR。