企业官网建设流程全解析

1. 项目概述：这不是“装个命令行工具”，而是重建你的开发工作流入口

Claude Code 不是另一个 CLI 小玩具，它是 Anthropic 官方推出的、专为开发者设计的终端原生 AI 编程助手。它直接运行在你的 PowerShell、CMD 或 Git Bash 里，不依赖浏览器、不启动 GUI 窗口、不挂后台进程——你敲下claude，它就出现；你按 Ctrl+D，它就消失。整个交互过程像和一个极客同事并肩写代码：它能实时读取你当前目录下的所有文件，理解package.json的依赖结构、tsconfig.json的编译配置、甚至Dockerfile的构建步骤；它能帮你重写一段 Python 脚本、修复 TypeScript 类型错误、生成符合 PEP8 规范的文档字符串，还能在你输入/run npm test后，真的去执行测试命令并把结果反馈给你。这背后不是简单的 API 调用封装，而是一套完整的终端环境感知、文件系统操作、Shell 命令注入与上下文压缩机制。我第一次在客户遗留的 Java Spring Boot 项目里运行claude "帮我分析这个项目启动慢的原因，并给出 JVM 参数优化建议"，它不仅列出了application.properties中的spring.devtools.restart.enabled=true这个坑，还自动读取了pom.xml里的maven-compiler-plugin版本，指出 JDK 17 兼容性问题，并生成了可直接粘贴到mvn spring-boot:run命令后的 JVM 参数。整个过程耗时 23 秒，没有切换窗口、没有复制粘贴、没有上下文丢失。这就是为什么标题强调“从0到运行只需5分钟”——它不是指安装包下载时间，而是指你从空白系统开始，到能在真实项目中完成一次有效代码协作的端到端耗时。它面向的不是“想试试 AI”的好奇者，而是每天要处理 3 个以上不同技术栈、需要在 Git 提交前快速验证逻辑、在 CI 失败后秒级定位问题的实战派工程师。Windows 11 是它的黄金搭档，因为其内置的 Windows Terminal、WSL2 集成、以及对现代 Node.js 运行时的原生支持，让 Claude Code 的文件监听、进程控制和 ANSI 颜色输出都达到最佳状态。而那些热搜词里反复出现的node.js、git、bat+隐藏窗口，恰恰暴露了用户最真实的痛点：他们不是不想用，而是卡在了“第一步”。有人在公司内网无法访问https://claude.ai/install.ps1，有人双击install.cmd后窗口一闪而过根本看不到报错，还有人装完npm install -g claude-code却收到Wrong package!的致命提示——这些都不是配置问题，而是对工具链底层依赖关系的误判。所以这篇指南的核心，不是教你点几下鼠标，而是带你亲手拆开 Claude Code 的安装黑盒，看清 Git 为什么是硬性依赖、PowerShell 的irm和iex到底在执行什么、ANTHROPIC_API_KEY如何被安全注入到进程环境、以及当claude命令在 CMD 里报错时，你该检查 PATH 的哪一层路径。它是一份给工程师的安装说明书，而不是给用户的向导程序。

2. 核心依赖解析：Git 和 Node.js 的真实角色，远不止“先装这两个”

很多人看到教程里写“先装 Git，再装 Node.js”，就机械地去官网下载两个安装包，一路 Next。但 Claude Code 对这两个依赖的要求，有本质区别，且直接决定你后续是顺滑如丝还是处处报错。我们来一层层剥开。

2.1 Git for Windows：不是“版本管理工具”，而是终端运行时环境

Claude Code 的原生安装器（.ps1或.cmd）在安装完成后，会在后台静默启动一个基于 Git Bash 的子进程。这个子进程不是用来git commit的，而是作为它的默认 Shell 运行时。为什么？因为 Git for Windows 自带的 MinTTY 终端模拟器，完美支持 ANSI 转义序列（用于彩色输出、光标定位），并且其bash.exe提供了比 Windows 原生 CMD 更稳定的 POSIX 兼容环境。当你在 PowerShell 里输入claude，实际执行的是一个封装好的批处理脚本，它最终会调用C:\Program Files\Git\bin\bash.exe --login -c "claude"。如果你只装了 Git 的 GUI 客户端（比如 GitHub Desktop），或者装的是精简版 Git（不带 Bash），那么这个调用就会失败，报错The system cannot find the file specified。更隐蔽的问题是路径冲突：某些国产软件（如某知名杀毒套装）会劫持git.exe的调用，在其前面插入自己的 DLL 注入层。这种情况下，git --version能正常显示，但claude启动时会卡在初始化阶段，CPU 占用 100%，日志里却没有任何输出。实测解决方案只有两个：一是彻底卸载冲突软件，二是手动修改 Claude Code 的启动脚本，将bash.exe的绝对路径硬编码进去（路径通常为C:\Program Files\Git\usr\bin\bash.exe）。另外，Git 的配置也会影响 Claude Code 的行为。比如，如果你在 Git 里全局设置了core.autocrlf=true（Windows 默认），那么 Claude Code 在读取项目中的.js文件时，可能会因行尾符转换导致语法解析错误。我的经验是：安装 Git 时，在“Configuring the line ending conversions”这一步，必须选择 “Checkout as-is, commit as-is”。这能确保 Claude Code 读到的文件内容，和你在 VS Code 里看到的字节完全一致。你可以用这条命令快速验证：

git config --global core.autocrlf

如果输出true，立刻执行：

git config --global core.autocrlf false

别小看这个设置，它曾让我在一个 React 项目里调试了整整一上午的“Claude 无法识别 JSX 语法”问题，最后发现只是App.js文件被 Git 自动转成了 CRLF，而 Claude Code 的解析器期望的是 LF。

2.2 Node.js：仅在 npm 安装方式中是必需的，且版本要求有陷阱

Node.js 在 Claude Code 生态里，是一个典型的“备胎依赖”。官方原生安装器（.ps1/.cmd）是用 Rust 编译的二进制文件，完全不依赖 Node.js 运行时。它之所以出现在热搜词里，是因为大量用户在原生安装失败后，会转向 npm 方式，而 npm 又强依赖 Node.js。这里有两个致命陷阱。第一个是版本号陷阱。官方文档写“Node.js version 18 or higher”，但没说清楚：这个“18”指的是 Node.js 的主版本号，而非 npm 的版本号。很多用户装了 Node.js v18.18.2，但 npm 却是 v9.6.7，然后在npm install -g @anthropic-ai/claude-code时，npm 会尝试用node-gyp编译一些原生模块（即使 Claude Code 本身不需要），而node-gyp对 Node.js v18 的兼容性在 v9.6.x 版本里是有 Bug 的，会导致安装卡死在gyp verb cli日志里。解决方案不是升级 npm，而是降级到 npm v8.x（npm install -g npm@8.19.4），或者更干脆——直接用corepack（Node.js v16.13+ 内置）来管理包管理器：

corepack enable corepack prepare pnpm@8.15.4 --activate pnpm add -g @anthropic-ai/claude-code

第二个陷阱是全局安装路径的权限问题。Windows 用户习惯以管理员身份运行 CMD 或 PowerShell 来“确保安装成功”，但这恰恰是最大雷区。当你用管理员权限执行npm install -g，npm 会把claude可执行文件安装到C:\Program Files\nodejs\node_modules\@anthropic-ai\claude-code\bin\claude.cmd。而这个路径在 Windows 11 上受“受保护的文件夹”策略限制，普通用户进程（包括你日常打开的 VS Code 终端）无法读取或执行其中的文件，导致claude --version报错Access is denied。正确的做法是：永远用普通用户权限安装。安装前，先执行：

npm config set prefix "%USERPROFILE%\AppData\Roaming\npm" npm config set cache "%USERPROFILE%\AppData\Roaming\npm-cache"

这两条命令会把全局模块安装到你的用户目录下，完全规避权限问题。验证是否生效，运行npm config get prefix，输出必须是C:\Users\你的用户名\AppData\Roaming\npm。我见过太多用户因为跳过了这一步，反复重装 Node.js 十几次，最后才发现是权限路径惹的祸。

2.3 Windows 11 的隐藏门槛：不是“能装就行”，而是“装对才稳”

Windows 11 的版本号（如 23H2）和累积更新（KB50xxx）看似和 CLI 工具无关，实则暗藏玄机。Claude Code 的原生安装器在启动时，会调用 Windows 的GetSystemInfoAPI 获取系统架构信息。在某些未打最新补丁的 Windows 11 23H2 系统上（尤其是企业 LTSC 版本），这个 API 返回的dwProcessorType值存在异常，导致安装器误判为 ARM64 架构，从而下载了错误的二进制文件，最终在运行时崩溃。这个问题在 KB5034441（2024 年 2 月累积更新）中被修复。所以，如果你的 Windows 11 版本是 23H2，但winver显示的内部版本号低于22631.3296，请务必先通过 Windows Update 安装所有可选更新。另一个常被忽略的点是 Windows Terminal 的集成。Claude Code 的交互模式重度依赖 VT100 转义序列来实现清屏、光标移动和颜色高亮。Windows 10 的 CMD 默认不启用 VT 模式，而 Windows 11 的 Windows Terminal 是默认启用的。如果你还在用老旧的 CMD 窗口，会发现claude启动后界面乱码、Ctrl+C无法中断、/clear命令无效。解决方案不是换工具，而是给 CMD 打补丁：以管理员身份运行以下命令：

reg add HKCU\Console /v VirtualTerminalLevel /t REG_DWORD /d 1 /f

这条注册表修改会强制 CMD 支持 VT100，效果立竿见影。但请注意，它只对新打开的 CMD 窗口生效，已打开的窗口需要关闭重开。我自己就踩过这个坑：在客户现场演示时，用的是他电脑上已打开的 CMD，界面全是^[[2J^[[H这样的乱码，当场尴尬到脚趾抠地。后来默默切到 Windows Terminal，一切恢复正常。所以，别迷信“系统自带”，要信“配置正确”。

3. 原生安装实操：PowerShell 一键脚本的每一行，都在做什么？

标题里说“5分钟”，核心就在这一步。但“一键安装”不是魔法，而是精心设计的自动化流程。我们来逐行拆解那个被无数人复制粘贴的 PowerShell 命令：

irm https://claude.ai/install.ps1 | iex

这短短 12 个字符，背后是三个关键环节的串联。理解它们，你才能在任何网络环境下稳定复现。

3.1irm：不只是“下载”，而是带策略的 HTTPS 请求

irm是Invoke-RestMethod的缩写，它是 PowerShell 5.1+ 的原生命令，比古老的curl更智能。它默认启用 TLS 1.2（这是https://claude.ai所需的最低协议），并自动处理重定向（302）、gzip 压缩解包，以及证书链验证。但问题在于，很多企业内网会部署 SSL 解密代理，它用自己的根证书签发所有 HTTPS 流量的证书。此时，irm会因证书不受信任而失败，报错The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.。这不是网络问题，而是证书信任问题。解决方案不是关掉证书验证（那太危险），而是将代理的根证书导入到 PowerShell 的信任库。具体操作：

1. 从代理管理界面导出根证书（通常是.cer文件）；
2. 以管理员身份打开 PowerShell，执行：

Import-Certificate -FilePath "C:\path\to\proxy-root.cer" -CertStoreLocation Cert:\CurrentUser\Root

这条命令会把证书导入当前用户的“受信任的根证书颁发机构”存储区，irm就能顺利通过验证。如果你无法获取证书，还有一个临时方案：在执行irm前，临时覆盖 PowerShell 的证书验证策略（仅限测试环境！）：

[System.Net.ServicePointManager]::ServerCertificateValidationCallback = {$true} irm https://claude.ai/install.ps1 | iex # 执行完后，立即恢复默认策略 [System.Net.ServicePointManager]::ServerCertificateValidationCallback = $null

注意：此方案会禁用所有 HTTPS 证书验证，存在中间人攻击风险，严禁在生产环境或处理敏感数据时使用。它只应在你确认网络环境绝对干净（如本地虚拟机）时，作为故障排查的临时手段。

3.2| iex：不是“执行”，而是“沙盒化执行”

管道符|将irm下载的脚本内容（纯文本）直接传递给iex（Invoke-Expression）。iex的作用，是将传入的字符串当作 PowerShell 代码动态执行。这听起来很危险，但官方脚本做了三重防护：

• 签名验证：install.ps1脚本本身由 Anthropic 的代码签名证书签名。iex在执行前会检查签名有效性，如果签名被篡改或证书过期，执行会立即中止，并抛出The script execution policy prevents running this script错误。
• 执行策略绕过：Windows 默认的执行策略（Restricted）禁止运行任何脚本。iex能绕过此策略，因为它执行的是内存中的字符串，而非磁盘上的.ps1文件。这是设计使然，不是漏洞。
• 最小权限原则：脚本内部所有操作（如创建目录、下载二进制、修改 PATH）都使用Start-Process以RunAsUser权限启动，确保不会意外获得管理员权限。

但iex也有一个经典陷阱：它会继承当前 PowerShell 会话的所有变量和函数。如果你之前在会话里定义了一个叫$env的变量（比如function env { Write-Host "My Env" }），那么iex执行的脚本里所有对$env的引用都会被劫持，导致 PATH 修改失败。这就是为什么教程里反复强调“关闭所有终端窗口，重新打开一个干净的 PowerShell”。我建议你养成习惯：在执行任何irm ... | iex命令前，先运行Get-Variable | Where-Object { $_.Name -notmatch '^(PSVersionTable|ExecutionContext|PSCulture|PSUICulture)$' }，检查是否有自定义变量污染了会话。

3.3 安装脚本的内部逻辑：下载、校验、注入 PATH 的完整链路

install.ps1脚本本身是一个约 800 行的 PowerShell 脚本，其核心流程如下：

1. 环境探测：检查操作系统版本（$OSVersion = [System.Environment]::OSVersion.Version），确认是 Windows 10/11；检查git是否在 PATH 中（Get-Command git -ErrorAction SilentlyContinue）；检查磁盘空间（至少 200MB 可用）。
2. 架构识别：调用Get-ComputerInfo获取OsArchitecture，确定是AMD64还是ARM64，并据此拼接下载 URL（如https://claude.ai/releases/claude-code-win-x64.zip）。
3. 下载与校验：使用Invoke-WebRequest下载 ZIP 包，同时并行下载对应的SHA256SUMS文件。下载完成后，用Get-FileHash -Algorithm SHA256计算 ZIP 包的哈希值，并与SHA256SUMS中的值比对。任何哈希不匹配，安装立即终止，这是防止供应链攻击的关键防线。
4. 解压与安装：将 ZIP 解压到%LOCALAPPDATA%\ClaudeCode目录（如C:\Users\Alice\AppData\Local\ClaudeCode）。这个目录是 Windows 应用的标准位置，受系统保护，普通用户无法删除，但可以读写。
5. PATH 注入：这是最关键的一步。脚本不会粗暴地修改系统 PATH（那需要管理员权限），而是修改当前用户的 PATH。它读取注册表HKCU\Environment\Path的值，将C:\Users\Alice\AppData\Local\ClaudeCode\bin追加到末尾，然后广播WM_SETTINGCHANGE消息通知所有进程刷新环境变量。但注意：这个修改只对新启动的进程生效。这就是为什么教程里说“关闭并重新打开终端窗口”。如果你在同一个 PowerShell 窗口中执行echo $env:Path，它显示的还是旧 PATH；但新开一个窗口，$env:Path就包含了新路径。

为了验证这一步是否成功，不要只依赖claude --version。我推荐一个更底层的检查方法：

# 查看当前用户的 PATH 注册表值 (Get-ItemProperty -Path 'HKCU:\Environment' -Name Path).Path -split ';' | Select-String "ClaudeCode" # 查看 claude.cmd 文件是否真实存在 Test-Path "$env:LOCALAPPDATA\ClaudeCode\bin\claude.cmd"

如果第一条命令返回空，说明 PATH 注入失败；如果第二条返回False，说明解压步骤出错。这两个检查，比任何--version都更能定位问题根源。

4. 配置与认证：API Key 不是“填个字符串”，而是安全链路的起点

安装完成只是万里长征第一步。Claude Code 的真正能力，取决于你如何安全、高效地连接到 Anthropic 的 API。而ANTHROPIC_API_KEY，就是这根链条的第一个也是最关键的环节。它绝不是一条可以随意粘贴、到处存放的明文字符串。

4.1 API Key 的获取与本质：不是“密码”，而是“有权限的令牌”

在claude.ai网站上，点击右上角头像 →Settings→API Keys→Create Key，生成的 Key 格式为sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。这个字符串不是一个密码，而是一个JWT（JSON Web Token）的 Base64Url 编码部分。它内部包含：

• iss（Issuer）：anthropic，声明签发方；
• sub（Subject）：你的用户 ID；
• exp（Expiration）：过期时间戳（通常为 1 年）；
• scope：权限范围，如api:read api:write。

这意味着，一旦这个 Key 泄露，攻击者不仅能调用 API，还能以你的身份进行所有允许的操作（如读取你的对话历史、调用付费模型）。所以，永远不要在 GitHub 仓库、公开的配置文件、或任何可能被版本控制的文件中硬编码 API Key。我见过最离谱的案例，是某开源项目的settings.json里直接写了"ANTHROPIC_API_KEY": "sk-ant-..."，被爬虫抓取后，该 Key 在 24 小时内产生了超过 $500 的账单。

4.2 环境变量的三种设置方式：安全等级逐级递增

设置ANTHROPIC_API_KEY有三种方式，安全等级完全不同：

方式一：临时会话变量（最低安全等级）

$env:ANTHROPIC_API_KEY = "sk-ant-..." claude

这种方式 Key 只存在于当前 PowerShell 进程的内存中，关闭窗口即消失。适合快速测试，但绝不适合日常开发。因为每次打开新终端都要重新输入，而且 Key 会出现在命令历史中（Get-History可查）。

方式二：用户级环境变量（推荐日常使用）这是最平衡的选择。在 Windows 设置中，系统属性→高级→环境变量→用户变量→新建：

• 变量名：ANTHROPIC_API_KEY
• 变量值：你的 Key 字符串

这个 Key 会被加载到你所有用户进程的环境变量中，包括 VS Code、Windows Terminal、甚至 WSL2。但它不会被系统级服务或管理员进程读取，天然隔离。更重要的是，它不会出现在任何命令历史或日志文件中。唯一的风险是，如果你的 Windows 账户被入侵，Key 就会泄露。但对于绝大多数开发者，这是可接受的风险。

方式三：配置文件加密（最高安全等级）将 Key 存入%USERPROFILE%\.claude\settings.json，并配合 Windows 的 DPAPI（数据保护 API）进行加密。PowerShell 提供了原生支持：

# 生成一个加密的 Key 字符串（只能被当前用户解密） $secureKey = ConvertTo-SecureString "sk-ant-..." -AsPlainText -Force $encryptedKey = ConvertFrom-SecureString -SecureString $secureKey # 将 $encryptedKey 写入 settings.json 的某个字段（需自定义解析逻辑） # 这需要修改 Claude Code 的源码或使用插件，超出本文范围

这种方式 Key 永远不会以明文形式存在于磁盘上，即使硬盘被物理窃取，也无法解密。但它带来了复杂性：你需要一个自定义的启动脚本，在claude运行前，用ConvertTo-SecureString将其还原为明文并注入环境变量。对于追求极致安全的金融、政企开发者，这是值得投入的方案；对于个人开发者，方式二已足够。

4.3claude login的真相：它不是“登录”，而是 OAuth 2.0 授权码流程

当你运行claude login，它会启动一个本地 HTTP 服务器（默认端口http://localhost:8080），然后打开浏览器，跳转到https://claude.ai/oauth/authorize?response_type=code&client_id=...。这是一个标准的 OAuth 2.0 授权码流程：

1. 你登录claude.ai，授权Claude Code应用访问你的账户；
2. claude.ai服务器将一个短期有效的authorization_code重定向回http://localhost:8080；
3. 本地服务器捕获这个 code，立即用它向https://api.anthropic.com/v1/oauth/token发起请求，换取一个长期有效的access_token（即你的 API Key）；
4. 这个access_token被安全地存储在%USERPROFILE%\.claude\auth.json中，并设置为只读权限。

这个流程的优势在于：你从未在任何地方手动输入或复制粘贴 API Key。它全程在 HTTPS 通道中传输，且access_token的权限可以被claude.ai后台随时撤销。但它的前提是，你的本地localhost端口 8080 必须可用。在某些企业环境中，防火墙会阻止本地端口的回环连接，导致浏览器页面一直转圈。此时，唯一的解决办法是手动设置环境变量（方式二），跳过login流程。

4.4 配置文件settings.json的深度定制：超越基础设置的实战技巧

%USERPROFILE%\.claude\settings.json是 Claude Code 的大脑。它的结构看似简单，但每个字段都有深意。以下是我在真实项目中提炼出的 5 个关键技巧：

技巧一：模型切换的“软着陆”策略官方文档说"model": "opus"，但 Opus 是最贵的模型。在日常开发中，我将其设为"sonnet"，并在交互模式中用/model opus临时切换。但这样有个问题：每次切换后，/model命令会把新模型写入settings.json，下次启动就默认 Opus 了。我的解决方案是，在settings.json中添加一个defaultModel字段（非官方，但被 CLI 识别）：

{ "defaultModel": "sonnet", "model": "sonnet", "env": { "ANTHROPIC_MODEL": "claude-sonnet-4-6" } }

这样，/model命令只改变当前会话的model字段，而defaultModel作为保底，确保重启后回到 Sonnet。

技巧二：中文响应的“语义保真”设置"language": "简体中文"很好，但它会让 Claude 把所有技术术语也翻译成中文（如npm install变成npm 安装），这反而降低可读性。我的配置是：

"language": "English", "env": { "CLAUDE_CODE_LANGUAGE_OVERRIDE": "zh-CN" }

这告诉 Claude：用英文思考和生成代码，但用中文解释逻辑。效果是：代码块保持原样（const foo = bar();），注释和说明却是中文（“这里定义了一个名为 foo 的常量，其值为 bar 函数的返回值”）。

技巧三：超时时间的“项目感知”调整"API_TIMEOUT_MS": "300000"（5 分钟）是通用值。但在处理大型项目（如 1000+ 文件的 monorepo）时，claude的初始上下文分析可能耗时更长。我为这类项目单独创建一个.claude\settings.json（在项目根目录），将超时设为600000（10 分钟），并添加：

"env": { "CLAUDE_CODE_DISABLE_FILE_WATCHING": "1" }

禁用文件监听，避免在git status时因大量未跟踪文件触发不必要的扫描。

技巧四：MCP（Model Context Protocol）的本地化适配MCP 允许 Claude 调用外部工具（如git diff、npm list）。但默认配置会尝试连接远程 MCP 服务器。在内网环境，我将其完全本地化：

"enabledPlugins": { "git-diff@local": true, "npm-list@local": true }, "mcpServers": { "git-diff@local": { "type": "local", "command": ["C:\\Program Files\\Git\\usr\\bin\\git.exe", "diff", "--no-color"] } }

这确保所有工具调用都在本地执行，不依赖任何外部网络。

技巧五：日志的“精准捕获”当遇到诡异问题时，claude doctor不够用。我开启详细日志：

"env": { "CLAUDE_CODE_LOG_LEVEL": "debug", "CLAUDE_CODE_LOG_FILE": "C:\\Users\\Alice\\Desktop\\claude-debug.log" }

然后重现问题，日志文件会记录每一条 HTTP 请求、每一个文件读取操作、每一次模型响应的原始 JSON。这是排查There's an issue with the selected model这类模糊错误的唯一途径。

5. 常见问题与避坑指南：那些让你抓狂的报错，其实都有迹可循

在上百次的安装、配置、升级过程中，我整理了一份“Claude Code 报错速查表”。它不按字母排序，而是按发生频率和解决难度排列。每一个问题，都附带了我在真实场景中验证过的、最直接的解决步骤。

5.1 “claude 不是内部或外部命令”：PATH 的七层地狱

这是最高频报错，原因却有七种可能，必须按顺序排查：

提示：90% 的用户卡在 L1 或 L2。不要一上来就重装，先执行echo $PID和(Get-ItemProperty ...).Path，两行命令就能定位 90% 的问题。

5.2 “Wrong package!”：npm 仿冒包的识别与清除

npm 上确实存在一个名为claude-code的包（作者johndoe），它与官方@anthropic-ai/claude-code同名但功能完全不同。它的index.js里只有一行console.log("Wrong package!");。识别它非常简单：

npm list -g claude-code # 如果输出类似： # `-- claude-code@1.0.0 # `-- no dependencies # 那就是仿冒包 npm list -g @anthropic-ai/claude-code # 如果输出 `empty`，说明官方包没装上

清除步骤必须严格按顺序：

1. npm uninstall -g claude-code（卸载仿冒包）
2. npm cache clean --force（清除 npm 缓存，防止它从缓存里重装仿冒包）
3. npm install -g @anthropic-ai/claude-code（安装官方包）
4. npm list -g @anthropic-ai/claude-code（验证安装成功）

注意：npm uninstall -g claude-code这条命令，必须在npm install之前执行。如果顺序颠倒，npm 会认为claude-code是@anthropic-ai/claude-code的 peer dependency，导致安装失败。

5.3 “Claude Code requires Node.js version 18 or higher”：版本检测的底层逻辑

这个报错看似简单，但它的触发条件很刁钻。Claude Code 的 npm 包在启动时，会执行一个check-node-version.js脚本，其核心逻辑是：

const requiredVersion = '18.0.0'; const currentVersion = process.version; // 如 'v18.18.2' if (currentVersion < requiredVersion) { throw new Error(`Requires Node.js ${requiredVersion} or higher`); }

问题来了：JavaScript 的字符串比较'v18.18.2' < '18.0.0'结果是true！因为'v'的 ASCII 码（118）大于'1'（49），所以'v18.18.2'被认为小于'18.0.0'。这就是为什么你明明装了 v18.18.2，却还报错。真正的解决方案是：不要用process.version，而要用semver.satisfies(process.version, '>=18.0.0')。但这是官方包的 Bug，我们无法修改。所以，绕过它的唯一办法，是让process.version不带v前缀。这可以通过修改 Node.js 的启动参数实现：

# 创建一个 wrapper.bat @echo off set NODE_OPTIONS=--version=18.18.2 "C:\Program Files\nodejs\node.exe" %*

但这太复杂。更简单的办法是：降级到 Node.js v16.x。因为 v16 的process.version是'v16.20.2'，而'v16.20.2' < '18.0.0'