Claude Code本地部署完整实操指南：国内直连DeepSeek兼容接口

一. 基础环境安装

想要顺畅运行 Claude Code，Node、Git、Python 这三样基础工具缺一不可。下面按步骤配置环境。

1.1 nvm 安装 Node

工作中可能用到多个 Node 版本，使用 nvm 管理版本切换方便。推荐优先安装长期支持（LTS）版本。nvm 安装过程不再赘述，网上教程较多。 查看线上可用的 Node 版本：

nvm list available

安装 24.18.0 LTS 版：

nvm install 24.18.0

如果下载一直卡住，可以手动下载安装包处理。下载地址：nodejs.org/dist/v24.18… 将压缩包重命名为 node.zip，放到 nvm 安装路径下的 `d:\Users\Administrator\AppData\Roaming\nvm\v24.18.0` 目录下，再解压即可。

安装完成后，先校验版本：

node -v
npm -version

1.2 安装 Git

常规安装流程，从官网下载安装包，配置好环境变量即可，此处不再展开。

1.3 安装 Python

从官网下载对应系统的安装包。

安装完毕后，执行命令验证：

python --version
pip --version

1.4 整体环境校验

打开 PowerShell，一次性执行以下四条命令，如果都能正常输出对应版本号，说明基础环境已就绪。

>node -v
>npm -v
>git --version
>python --version

1.5 新建测试项目目录

打开 PowerShell，切换到 E 盘，创建存放代码项目的文件夹，并初始化 Git：

cd .ivyai
mkdir ai-code-projects
cd .ai-code-projects
git init

以上步骤全部执行完毕且无报错，前期准备工作即完成，可以开始安装 Claude Code 本体。

二. Claude Code 安装与 DeepSeek 适配配置

2.1 npm 全局安装

国内网络直接从 npm 安装容易超时，先切换到淘宝镜像源再安装：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

安装完成后，先校验是否安装成功：

claude --version

2.2 API 配置

2.2.1 配置说明

安装好 Claude Code 后，需要配置 API 密钥或登录方式才能使用。 核心配置参数速查表：

参数（环境变量）	作用	何时使用
ANTHROPIC_API_KEY	Anthropic 官方 API Key	直接使用官方服务时
ANTHROPIC_AUTH_TOKEN	第三方平台的 API Key	使用中转/第三方模型时
ANTHROPIC_BASE_URL	API 端点地址（覆盖默认地址）	使用中转/第三方服务时
ANTHROPIC_MODEL	默认使用的模型名称或别名	持久指定默认模型
ANTHROPIC_DEFAULT_OPUS_MODEL	opus 槽位映射的具体模型	自定义三级槽位映射
ANTHROPIC_DEFAULT_SONNET_MODEL	sonnet 槽位映射的具体模型	自定义三级槽位映射
ANTHROPIC_DEFAULT_HAIKU_MODEL	haiku 槽位映射的具体模型	自定义三级槽位映射
API_TIMEOUT_MS	API 请求超时时间（毫秒）	网络慢或模型推理耗时长时

注意：**参数关系说明**：`ANTHROPIC_API_KEY` 用于官方直连，`ANTHROPIC_AUTH_TOKEN` 用于第三方服务。两者不要同时设置，否则会冲突。`ANTHROPIC_BASE_URL` 只在使用非官方端点时需要设置。 **三种配置方式对比：**

配置方式	持久性	作用范围	推荐场景
临时环境变量	关闭终端即失效	当前终端窗口	快速测试、临时切换
永久环境变量	永久生效	所有终端和项目	日常一台电脑固定使用
配置文件 settings.json	永久生效	全局或特定项目	多项目/多模型切换、团队共享

配置文件路径说明： - **全局**：`~/.claude/settings.json`（Windows：`C:\Users\<用户名>\.claude\settings.json`） - **项目级（团队共享）**：项目根目录/.claude/settings.json（可提交 Git） - **项目级（个人私有）**：项目根目录/.claude/settings.local.json（加入 .gitignore） 三种配置方案：

方案选择指南：

你能直接访问 Anthropic 网站吗？
├── 能 → 方案一：使用 Anthropic 官方 API（推荐）
└── 不能 → 你在国内吗？
   ├── 想用原版 Claude 模型 → 方案二：使用第三方API中转服务 国内首选
   ├── 想用其他模型（DeepSeek/千问/GLM等） → 方案三：接入其他模型
   └── 想要包月套餐、省心不操心 → 在方案三中选择厂商 Coding Plan

这里只准备第三种方案，即 DeepSeek 的配置。

2.2.2 DeepSeek 适配完整配置流程

本次仅实操国内可用的 DeepSeek 兼容方案，官方文档参考：api-docs.deepseek.com/zh-cn/quick… 提前为 DeepSeek 账户充值，并获取专属 API Key。

**跳过登录验证** 编辑或新建 `~/.claude.json`（Windows 路径：`C:\Users\<用户名>\.claude.json`），将 `hasCompletedOnboarding` 设为 `true`，这样可以跳过 Anthropic 官方的登录验证。

{
  "hasCompletedOnboarding": true
}

**配置接入凭证** 新建 `~/.claude/settings.json`（Windows 路径：`C:\Users\<用户名>\.claude\settings.json`），将里面的 `<你的 DeepSeek API Key>` 替换为自己的密钥：

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

2.3 本地运行测试

2.3.1 运行 Claude

进入之前建好的 `ai-code-projects` 项目目录，在终端直接输入 `claude` 启动程序。

2.3.2 弹出选项，输入数字 1，回车进入对话界面

2.3.3 验证

查看当前接口和模型状态，校验配置是否生效：

> /status

2.3.4 切换模型命令

/model haiku

测试过程中，前期使用了千问（按月收费），后期切换到 DeepSeek（按量收费）。因此截图中模型信息可能不一致，请以实际操作为准。

2.3.5 简单对话测试可用性

例如输入“今天星期几”、“你是什么大模型”，如果能正常返回回答，说明整套流程已跑通。

今天星期几
你是什么大模型

三. 小结

很长一段时间里，寻找稳定可用的 Claude Code 部署方案并不容易。先后尝试了两条路径，效果都不理想：直连 Anthropic 官方接口无法连通；各类第三方中转服务要么费用偏高，要么响应不稳定。最终通过 DeepSeek 的兼容接口，实现了本地运行。普通家庭宽带即可正常调用，按量计费的模式也让成本相对可控。 整套部署过程中，容易踩坑的三个地方：Node 安装包下载超时、各类配置文件路径混淆、两组密钥环境变量弄混。遇到 Node 下载失败，可用离线包手动部署；配置文件需严格遵循 Windows 指定路径创建；关键要分清 `ANTHROPIC_API_KEY` 和 `ANTHROPIC_AUTH_TOKEN` 的适用场景，从而规避绝大多数报错。 环境部署完成后，即可在本地终端直接使用 Claude Code 的编程辅助能力。无论是编写脚本、改造项目代码，还是梳理工程逻辑，都无需频繁切换浏览器网页，对日常开发效率提升明显。这套兼容接入的逻辑通用性较强，后续如需更换其他兼容 Anthropic 接口的大模型，直接参照此配置修改即可复用。 千问是包月，DeepSeek 是计量，短期测试更适合使用 DeepSeek。因此前期测试使用了千问，后期切换到 DeepSeek。