国内直连Claude Code的本地部署完整实操手册(DeepSeek兼容接口版)

一. 基础环境安装

想要顺畅地跑起Claude Code，Node、Git、Python这三样基础工具，缺一不可。下面我们一步步把环境配齐。

1.1 nvm安装node

工作中可能用到多个Node版本，用nvm来管理版本，切换起来很方便。推荐优先安装长期支持 (LTS) 版本。nvm的安装过程就不展开了，网上教程很多。 查看线上可用的Node版本：

nvm list a vailable

安装24.18.0 LTS版：

nvm install 24.18.0

如果下载一直卡住，可以手动下载安装包处理。下载地址是：nodejs.org/dist/v24.18… 把压缩包重命名为node.zip，放到nvm安装路径下的 `d:UsersAdministratorAppDataRoaming vmv24.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<用户名>.claudesettings.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<用户名>.claudesettings.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了。