claude code安装以及常见问题

一、安装Node.js环境

Claude Code运行依赖Node.js，最低要求Node.js ≥18（建议安装LTS稳定版）。

方法一：官网下载（推荐新手）

访问Node.js官网，下载Windows LTS版本安装包

双击安装包，按向导默认安装即可（一路"Next"，建议勾选"Add to PATH"

验证安装是否成功

打开PowerShell（建议管理员身份运行，避免权限问题），输入以下命令检查版本：

bash 复制代码

node --version  # 输出v18.x.x或更高版本
npm --version   # 输出对应的npm版本

二、安装Claude Code

Node.js环境就绪后，用npm全局安装Claude Code：

bash 复制代码

npm install -g @anthropic-ai/claude-code

安装完成后验证：

bash 复制代码

claude --version  # 输出类似 @anthropic-ai/claude-code/x.x.x

进入claude

bash 复制代码

claude

必须做的两个配置（否则启动会卡）

1️⃣C:\Users\Administrator.claude.json

如果没有就创建

bash 复制代码

{"hasCompletedOnboarding": true}

保存即可（你走 DeepSeek 中转，根本不会连 Anthropic，这个文件能跳过所有地区校验）。

2️⃣确认 DeepSeek 中转配置

打开 C:\Users\Administrator.claude\settings.json（没有就新建），确保内容正确：

bash 复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeekKey",
    "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"
  }
}

deepseek api申请地址

https://platform.deepseek.com/usage

创建APIKey 并复制key写到上述配置中

选配操作建议配置不配置容易出问题

禁用自动更新，如自动更新可能会导致程序运行错误

✅ 必做 1：确认当前版本，决定要不要锁

CMD 里：

bash 复制代码

claude --version

两种情况：

2.1.112或更早 → 这是最后一个 Node 跑的版本，Bun banner 问题在这版根本不会发生，保持住就行 ✅

2.1.113+ → 已经切 Bun binary 了，Win 下有复发风险，建议锁回 2.1.112：

bash 复制代码

npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code@2.1.112

✅ 必做 2：禁自动更新（最关键，漏这步必翻）

不禁用，claude后台会自动检查升级，某天悄悄从 2.1.112 拉到最新 Bun 版，一夜回到解放前。

PowerShell（管理员）执行：

bash 复制代码

[Environment]::SetEnvironmentVariable("DISABLE_AUTOUPDATER", "1", "User")

重开 CMD 验证：

bash 复制代码

echo %DISABLE_AUTOUPDATER%
:: 回 1 就 OK

想更狠一点（连手动 claude update也禁掉）：

把值换成 DISABLE_UPDATES=1

✅ 必做 3：npm 源锁 npmmirror

防止以后 npm install -g又从官方源拉到半残包：

bash 复制代码

npm config set registry https://registry.npmmirror.com/

验证：

bash 复制代码

npm config get registry
:: 应回 https://registry.npmmirror.com/

✅ 必做 4：确认没有混装

你之前 npm / bun / 原生三份可能打架，跑一下：

bash 复制代码

claude doctor

不报 Mixed paths between Bun, npm and Node.js→ 干净 ✅

报了 → 说明还有别的安装残留，把 where claude和 where bun输出贴我看

常见问题整理

一.

执行 claude 提示Bun is a fast JavaScript runtime, package manager, bundler, and test runner. (1.4.0+63bb0ca0d)

✅ 终极解决方案（Win10 Administrator 专用，按顺序执行）

第一步：CMD 里换国内 npm 镜像（解决网络问题）

右键「开始菜单」→ 命令提示符(管理员)，执行：

bash 复制代码

npm config set registry https://registry.npmmirror.com/

第二步：彻底清理之前的混乱安装

bash 复制代码

npm uninstall -g @anthropic-ai/claude-code
where claude

如果 where claude还能打出路径，手动删掉：

del

bash 复制代码

"C:\Users\Administrator\AppData\Roaming\npm\claude*"
rd /s /q "C:\Users\Administrator\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code"

第三步：重新安装（这次肯定能成）

bash 复制代码

npm install -g @anthropic-ai/claude-code

看到 added 1 package之类的提示就成功了。

第四步：验证安装

claude --version

✅ 能出版本号（比如 2.x.x）就说明 CLI 装好了。

✅ 可选 6：如果以后还是翻了，30 秒修复脚本（存着备用）

npm cache clean --force

npm uninstall -g @anthropic-ai/claude-code

del "C:\Users\Administrator\AppData\Roaming\npm\claude*"

rd /s /q "C:\Users\Administrator\AppData\Roaming\npm\node_modules@anthropic-ai"

npm install -g @anthropic-ai/claude-code@2.1.112

✅ 自检三连（做完以上跑一遍就安心了）

claude --version :: 看版本

claude doctor :: 看混装

claude → /status :: 看 DeepSeek 中转