Claude Code国内直连本地部署完整实操手册（DeepSeek兼容版）

时间：2026-07-22 | 作者：318050 | 阅读：0

一. 基础环境安装

想要顺畅地跑起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:UsersAdministratorAppDataRoamingnvmv24.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"
  } 
}