专为 Windows 用户打造的 Claude Code 安装、降级与配置工具箱。解决在中国大陆 Windows 环境下使用 Claude Code 时可能遇到的各种痛点：
- Node.js 版本检测与自动安装/升级
- 一键安装/降级 Claude Code CLI 并锁定版本（防止静默更新）
- 自动禁用遥测与不必要的网络请求
- 切换国内 npm 镜像源加速下载
- 配置 DeepSeek V4 作为后端模型，绕过区域限制
- 修复 PowerShell/CMD 中文乱码问题
- 附带 VS Code 插件离线安装包（v2.1.153）
cc-backup/
│
├── setup-old-cc/ # 旧版降级 & 锁版本工具
│ ├── Setup-Old-CC-by-Admin.bat # ★ 入口：右键管理员运行
│ ├── Setup-Old-ClaudeCode.ps1 # 核心脚本
│ ├── anthropic.claude-code-2.1.153
│ │ └── -win32-x64.vsix # VS Code 插件离线安装包
│ └── 告小白：要快，就右键管理员运行.bat文件！！！.txt
│
├── cc-quick-install-scripts/
│ └── cc-auto-install/ # 全新安装套件
│ ├── cc-install-by-Admin.bat # ★ 入口：右键管理员运行
│ ├── cc-install.ps1 # 一键安装 CC + 配置 DeepSeek
│ ├── DS 接入 Claude Code - DeepSeek API Docs.url # 官方文档快捷方式
│ ├── DeepSeek V4 官方配置与实际个人取舍.url # 配置参考快捷方式
│ ├── node-install-by-Admin.bat # ★ 入口：右键管理员运行
│ ├── node-install.ps1 # Node.js 安装/升级
│ ├── npm-mirror-switcher-by-Admin.bat # ★ 入口：右键管理员运行
│ ├── npm-mirror-switcher.ps1 # npm 镜像源切换
│ ├── 告小白：要快，就右键管理员运行.bat文件！！！.txt
│ └── 踩坑历史（部分）/ # 开发过程中的参考记录
│ ├── Convert-ToUTF8BOM.ps1 # UTF-8 BOM 编码修复
│ └── ...其他调试脚本
│
└── README.md
⚠️ 注意：以.ps1结尾的 PowerShell 脚本不支持直接右键管理员运行，请始终通过同目录下的.bat文件启动。.bat文件支持 右键 → 以管理员身份运行。
如果你是第一次安装 Claude Code，或想快速重装并配置好 DeepSeek 后端：
- 进入
cc-quick-install-scripts/cc-auto-install/ - 右键
cc-install-by-Admin.bat→ 以管理员身份运行 - 脚本自动完成以下 6 步：
- 检测 Node.js 版本（需 v18+，不满足则提示）
- 全局安装
@anthropic-ai/claude-code及必要依赖 - 将 Claude Code 添加到系统 PATH
- 配置
~/.claude/settings.json禁用自动更新 - 设置用户级环境变量禁用遥测
- 配置 DeepSeek V4 作为后端模型：设置
ANTHROPIC_BASE_URL、ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU_MODEL及CLAUDE_CODE_SUBAGENT_MODEL - 提示输入 DeepSeek API Key 并保存
- 附带 DeepSeek 官方配置与接入文档快捷方式
- 绕过 Claude Code 区域限制
如果已安装新版 Claude Code（v2.1.154+），由于消息体结构变化导致接入第三方 API（如 DeepSeek、MiniMax）时报 API Error: 400 unknown variant system 错误，需要回退到 v2.1.153 并锁定版本防止再次升级：
- 进入
setup-old-cc/ - 右键
Setup-Old-CC-by-Admin.bat→ 以管理员身份运行 - 脚本自动完成：
- 修改
~/.claude/settings.json禁用自动更新 - 设置用户级环境变量禁用遥测
- 卸载当前 Claude Code，安装
@anthropic-ai/claude-code@2.1.153 - 提示 VS Code 插件降级步骤
- 修改
VS Code 插件手动处理：如果使用 VS Code 插件，CLI 降级后插件仍为最新版，需额外手动降级。打开 VS Code → 扩展面板 → 找到 Claude Code → 齿轮图标 → "安装另一版本..." → 选择
2.1.153。若列表中未显示，可卸载后使用附带的.vsix文件手动安装。
Node.js 版本低于 v18，或想通过 NVM 管理多版本：
- 进入
cc-quick-install-scripts/cc-auto-install/ - 右键
node-install-by-Admin.bat→ 以管理员身份运行 - 脚本自动检测当前 Node.js 版本：
- 满足要求（v18+）→ 可选择是否重新安装
- 过低或未安装 → 弹出菜单选择 v18 LTS 或 v22 LTS
- 优先使用 NVM for Windows 安装，失败则自动回退到 MSI 安装
- 安装完成后自动切换为国内 npm 镜像源（淘宝镜像）
npm install 速度慢或超时：
- 进入
cc-quick-install-scripts/cc-auto-install/ - 右键
npm-mirror-switcher-by-Admin.bat→ 以管理员身份运行 - 从菜单中选择一个镜像源：
| 选项 | 镜像源 | 说明 |
|---|---|---|
| 1 | npm Official（registry.npmjs.org） |
官方源 |
| 2 | 淘宝（registry.npmmirror.com） |
国内推荐 |
| 3 | 华为云 | 国内备用 |
| 4 | 腾讯云 | 国内备用 |
| 5 | 中科大 USTC | 教育网友好 |
| 6 | 自定义 URL | 手动输入 |
.bat / .cmd / .ps1 脚本在 CMD 或 PowerShell 中显示中文乱码时：
- 找到
踩坑历史（部分）/Convert-ToUTF8BOM.ps1 - 右键 → 使用 PowerShell 运行
- 脚本自动遍历当前目录及所有子目录，为不包含 BOM 的
.bat、.cmd、.ps1文件添加 UTF-8 with BOM 编码
| 文件 | 说明 |
|---|---|
Setup-Old-CC-by-Admin.bat |
入口文件，右键管理员运行，自动调用同目录下的 PowerShell 脚本 |
Setup-Old-ClaudeCode.ps1 |
核心脚本：检查当前版本 → 配置 settings.json 禁用更新 → 设置遥测禁用环境变量 → 降级到 v2.1.153 → 输出 VS Code 插件处理建议 |
anthropic.claude-code-2.1.153-win32-x64.vsix |
VS Code 插件离线安装包，v2.1.153 版本（Windows x64），供无法在线降级的用户使用 |
| 文件 | 说明 |
|---|---|
cc-install-by-Admin.bat |
Claude Code 一键安装入口 |
cc-install.ps1 |
6 步完成：检测 Node → 安装 CC → 配置 PATH → 配置 settings.json → 设置环境变量 → 配置 DeepSeek 后端（不锁定主模型，子智能体使用 flash）并绕过区域限制 |
DS 接入 Claude Code - DeepSeek API Docs.url |
DeepSeek 官方接入文档快捷方式，手动安装时参考 |
DeepSeek V4 官方配置与实际个人取舍.url |
DeepSeek V4 模型配置指南与个人调优说明 |
node-install-by-Admin.bat |
Node.js 安装入口 |
node-install.ps1 |
检测 Node 版本，通过 NVM 或 MSI 安装 v18/v22，安装后自动切换国内镜像 |
npm-mirror-switcher-by-Admin.bat |
npm 镜像切换入口 |
npm-mirror-switcher.ps1 |
交互式切换 npm registry 到 6 种可选镜像源，支持自定义源 |
| 文件 | 说明 |
|---|---|
踩坑历史（部分）/Convert-ToUTF8BOM.ps1 |
批量为脚本文件添加 UTF-8 with BOM 编码，解决 Windows 中文乱码 |
Claude Code CLI 的配置文件（Windows 路径：C:\Users\<用户名>\.claude\settings.json）。脚本会在其中写入以下字段：
{
"autoUpdates": false,
"DISABLE_UPDATES": "1",
"DISABLE_AUTOUPDATER": "1",
"disableAutoUpdater": true
}| 变量名 | 值 | 说明 |
|---|---|---|
DISABLE_TELEMETRY |
1 |
禁用遥测上报（关闭 Datadog、BigQuery 等通道） |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
1 |
禁用非必要网络流量 |
DISABLE_ERROR_REPORTING |
1 |
禁用错误报告 |
以下由 cc-install.ps1 额外设置，用于配置 DeepSeek 后端：
| 变量名 | 值 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL |
https://api.deepseek.com/anthropic |
DeepSeek API 端点 |
ANTHROPIC_DEFAULT_OPUS_MODEL |
deepseek-v4-pro[1m] |
Opus 级主力模型（高性能） |
ANTHROPIC_DEFAULT_SONNET_MODEL |
deepseek-v4-pro[1m] |
Sonnet 级主力模型（同上） |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
deepseek-v4-flash[1m] |
Haiku 级轻量模型（子智能体等快速任务） |
CLAUDE_CODE_SUBAGENT_MODEL |
deepseek-v4-flash[1m] |
子智能体专用模型（后台分析任务） |
CLAUDE_CODE_EFFORT_LEVEL |
high |
思考预算级别（可用 /effort 动态调整） |
ANTHROPIC_AUTH_TOKEN |
sk-xxxxxx |
DeepSeek API Key（安装时交互输入） |
关于
[1m]后缀：告诉 Claude Code 该模型支持 1M 上下文窗口，避免错误识别上下文容量，同时可开启 DeepSeek 侧的某些性能优化。关于 Effort Level：
high为日常编码推荐值。复杂系统设计/调试可选xhigh/max；简单脚本可选medium/low。可在 CC 中用命令/effort随时切换。关于
ANTHROPIC_MODEL：该变量不再设置，避免锁定默认模型。在 CC 中使用/model切换模型后自动成为默认模型，更符合预期。
-
管理员权限：所有涉及修改系统环境变量、PATH 或
settings.json的操作均需管理员权限。请始终通过右键.bat文件 → 以管理员身份运行 来执行。 -
关闭遥测存在性能代价：Anthropic 官方将 1 小时 Prompt Cache 视为实验性功能，关闭遥测会导致 Prompt Cache TTL 从 1 小时降至默认的 5 分钟，长对话场景下的 Token 消耗和延迟可能会显著增加。
-
身份信息无法彻底关闭：
DISABLE_TELEMETRY=1只能关闭 Datadog 和 BigQuery 通道。API 请求自身携带的Attribution Header（含设备指纹）和Attestation（原生客户端认证）仍然会发送。 -
VS Code 插件需手动降级：CLI 降级后，VS Code 插件通常仍为最新版，如遇插件报错需在插件设置中手动安装
2.1.153版本。本工具箱附带了.vsix离线安装包。 -
重启终端：修改环境变量后，需重启 PowerShell / CMD / VS Code 才能生效。
-
npm 镜像同步延迟：国内镜像源与官方源存在数分钟到数小时的同步延迟，如遇包版本找不到，可切回官方源重试。