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

来源：互联网 2026-07-23 06:25:08

基于DeepSeek兼容接口实现ClaudeCode本地部署，普通家庭宽带即可直连调用，按量计费成本可控。需配置Node、Git、Python环境，通过npm安装后设置配置文件跳过登录并接入凭证。注意Node下载超时、路径混淆及密钥区分等易错点，配置完成后可在终端直接使用编程辅助功能。

一. 基础环境安装

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

1.1 nvm 安装 Node

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

nvm list available

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

安装 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` 目录下，再解压即可。

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

长期稳定更新的攒劲资源： >>>点此立即查看<<<

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

node -v
npm -version

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

1.2 安装 Git

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

1.3 安装 Python

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

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

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

python --version
pip --version

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

1.4 整体环境校验

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

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

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

1.5 新建测试项目目录

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

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

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

以上步骤全部执行完毕且无报错，前期准备工作即完成，可以开始安装 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

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

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 Code本地部署完整实操指南：国内直连DeepSeek兼容接口

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

{
  "hasCompletedOnboarding": true
}

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

**配置接入凭证** 新建 `~/.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"
  } 
}

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

2.3 本地运行测试

2.3.1 运行 Claude

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

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

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

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

2.3.3 验证

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

> /status

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

2.3.4 切换模型命令

/model haiku

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

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

2.3.5 简单对话测试可用性

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

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

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

三. 小结

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

侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述