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

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

之前一直想在本地部署 Claude Code，长期被网络问题卡住。官方直连方案一直没有调通，第三方中转服务仍然是使用官方，收费偏高。摸索许久，发现DeepSeek等国内人工智能都提供兼容Claude Code的接口，普通国内宽带即可直连调用，踩坑相对更少，于是整理这份完整落地流程，方便有同样需求的开发者参考。

一. 基础环境安装

想要正常运行 Claude Code，Node、Git、Python 三样基础工具缺一不可，下面一步步把环境配齐。

1.1 nvm安装node

本身可能会使用Node有多种版本，所以使用用nvm管理Node版本方便后续切换。优先装长期支持 LTS 版本。nvm安装，就不做介绍了。

查看线上可用 Node 版本：

bash 复制代码

nvm  list available

安装 24.18.0 LTS 版：

bash 复制代码

nvm install 24.18.0

如果下载一直卡住，手动下载安装包处理：

下载地址： nodejs.org/dist/v24.18...

把压缩包重命名 node.zip，放到路径nvm安装路径下的d:\Users\Administrator\AppData\Roaming\nvm\v24.18.0\下再解压即可。

安装完成校验版本：

bash 复制代码

node -v
npm -version

1.2 安装 git

常规安装流程，自行下载安装包配置环境变量，这里不多赘述。

1.3 安装 python

官网下载对应系统安装包： www.python.org/downloads/

装好后执行命令验证：

css 复制代码

python --version
pip --version

1.4 整体环境校验

打开 PowerShell 一次性执行下面四条命令，全部正常输出版本号就代表基础环境没问题：

bash 复制代码

>node -v

>npm -v

>git --version

>python --version

1.5 新建测试项目目录

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

bash 复制代码

 cd .\ivy\ai
 mkdir ai-code-projects
 
 cd .\ai-code-projects\
 git init

以上步骤全部执行无报错，前期准备工作就全部做完，能正式开始装 Claude Code 本体了。

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

2.1 npm 全局安装

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

bash 复制代码

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

校验是否安装成功

bash 复制代码

# 校验是否安装成功
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...

2.2.2.1 提前给 DeepSeek 账户充值，获取专属 API Key

2.2.2.2 跳过登录验证

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

json 复制代码

{
  "hasCompletedOnboarding": true
}

2.2.2.3 配置接入凭证

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

json 复制代码

{
  "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 验证

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

bash 复制代码

> /status

2.3.4 切换模型命令

bash 复制代码

/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的。

后续我会持续更新 Claude Code 实操使用教程，感兴趣可以持续关注。