呼和浩特市着力打造内蒙古场景创新示范标杆
2026-07-22 3417649
2026-07-22 0
之前一直想在本地部署 Claude Code，长期被网络问题卡住。官方直连方案一直没有调通，第三方中转服务仍然是使用官方，收费偏高。摸索许久，发现DeepSeek等国内人工智能都提供兼容Claude Code的接口，普通国内宽带即可直连调用，踩坑相对更少，于是整理这份完整落地流程，方便有同样需求的开发者参考。
想要正常运行 Claude Code，Node、Git、Python 三样基础工具缺一不可，下面一步步把环境配齐。
本身可能会使用Node有多种版本，所以使用用nvm管理Node版本方便后续切换。优先装长期支持 LTS 版本。nvm安装，就不做介绍了。
查看线上可用 Node 版本：
nvm list available
安装 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
常规安装流程，自行下载安装包配置环境变量，这里不多赘述。
官网下载对应系统安装包
装好后执行命令验证：
python --version pip --version
打开 PowerShell 一次性执行下面四条命令，全部正常输出版本号就代表基础环境没问题：
>node -v >npm -v >git --version >python --version
打开 PowerShell 切换到 E 盘，创建存放代码项目的文件夹并初始化 git：
cd .ivyai mkdir ai-code-projects cd .ai-code-projects git init
以上步骤全部执行无报错，前期准备工作就全部做完，能正式开始装 Claude Code 本体了。
国内网络直接装容易超时，先切换淘宝镜像源再安装：
npm config set registry https://registry.npmmirror.com npm install -g @anthropic-ai/claude-code claude --version
校验是否安装成功
# 校验是否安装成功 claude --version
安装好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配置
本次只实操国内可用的 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"
}
}
进入之前建好的 ai-code-projects 项目目录，终端直接输入claude启动程序
2.3.3 验证
查看当前接口、模型状态校验配置是否生效
> /status
/model haiku
开始使用的是千问是按月收费，后来切换到deepseek按量收费。所以可能图有的不是很正确。
比如输入「今天星期几」「你是什么大模型」，能正常返回 回答就代表整套流程跑通。
今天星期几 你是什么大模型
很长一段时间，我一直在寻找稳定可用的Claude Code部署方案，先后尝试两条路径都不尽人意：直连 Anthropic官方接口根本无法连通；各类第三方中转服务，要么费用偏高，要么响应不稳定。兜兜转转，终于找到第三种可行方案，借助DeepSeek兼容接口实现本地运行。普通家庭宽带就能正常调用，按量计费模式成本可控。
整套部署最容易踩坑的三处问题：Node 安装包下载超时、各类配置文件路径混淆、两组密钥环境变量弄混。遇到 Node 下载失败采用离线包手动部署；配置文件严格遵循 Windows 指定路径创建；分清ANTHROPIC_API_KEY与ANTHROPIC_AUTH_TOKEN适用场景，就能规避绝大多数报错。
环境部署完成后，可以直接在本地终端使用Claude Code编程辅助能力。编写脚本、改造项目代码、梳理工程逻辑，不用频繁切换浏览器网页，对日常开发提升很明显。这套兼容接入逻辑通用性较强，后续打算更换其他兼容Anthropic接口的大模型，直接参照这套配置修改即可复用。
千问是包月的，DeepSeek是计量，短期测试还是使用Deepseek比较好，所以前期使用千问后来切换到Deepseek的。