企业官网建设流程全解析

先说一个很多人在群里问的问题：Claude Code 4.5 在 Windows 下到底怎么装？网上教程不少，但大部分默认你用的是 macOS 或者 Linux，写到 Windows 这一步要么直接跳过，要么甩你一句“建议用 WSL”。其实根本没有那么复杂，Claude Code 4.5 在 Windows 原生环境下的安装门槛比想象中低得多，只要你把前面的环境准备做扎实，后面就是一条 npm 命令的事。这篇博文就是把我自己的完整安装流程复盘一遍，从环境检查、Node.js 安装到首次登录配置，再把常见的坑逐个标出来。适合刚接触 Claude Code 的开发者，也适合已经装到一半卡住的人。

我建议你按顺序读完再动手，因为很多报错不是安装那一步出的，而是前面某个环境变量没配好，等到运行 claude 命令的时候才统一爆发。与其出了问题再回头查，不如一开始就把底子打好。

1. 安装之前先搞明白：Claude Code 4.5 到底能干什么

1.1 它不是聊天框，而是一个跑在终端里的智能体

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。你可以把它理解成一个住在终端里的同事：你在项目目录里敲下 claude，它能看到当前项目的文件结构、读取代码内容、理解你正在做的事情，然后帮你分析问题、写代码、改 bug、补测试，甚至直接执行终端命令。它和网页版、桌面版的 Claude 最大的区别在于，它不是一个独立窗口里的聊天框，而是紧贴着你的项目在运行，天然拥有项目上下文。

4.5 这个版本在会话管理、工具调用稳定性、权限控制方面都有不少优化。尤其让我比较满意的一点是，它对 Windows 原生的支持比早期版本好了很多，不再给人“只在 Mac 上能用”的感觉。对于日常写脚本、做项目重构、快速理解陌生代码库这类需求，它确实是个很趁手的工具。

1.2 为什么在终端里干活反而更高效

很多人的第一个疑问是：我用 VS Code 插件或者 JetBrains 插件不香吗？为什么非要命令行？

我的体会是，终端本身就是开发者的基础设施。你在终端里跑 git、跑构建、跑测试，Claude Code 可以直接接管这一整套命令，而不只是停留在“给你一段代码让你自己去跑”的层面。它可以在你的授权下执行命令、查看输出、根据报错继续调整代码，这种闭环工作流是纯聊天式 AI 给不了的。

另外，终端工具不挑 IDE。不管你是 VS Code、IDEA、还是纯 Vim 党，只要有一个终端就能用。这对我来说是很大的自由。

1.3 两条运行路线，选错后面很折腾

在 Windows 上跑 Claude Code，主流有两条路线，我在装之前纠结了很久，这里直接给你结论：

• 路线 A：Windows 原生环境，用 PowerShell 或 Windows Terminal 直接跑 Node.js 版本。安装最省事，适合日常在 Windows 上写代码、处理脚本、做文件操作的开发者。
• 路线 B：先装 WSL2，在 Linux 子系统里安装和使用。适合开发目标环境是 Linux、需要 Docker、或者依赖 Linux 工具链的场景。

两条路线并不冲突，但我不建议同时混用来做跨项目协作，容易把环境变量和文件路径搞得一团糟。本文接下来以路线 A 为主，如果你是 WSL 用户，安装命令本身一样，只是需要在 WSL 的终端里执行，并且记得 Node.js 也要装到 WSL 里，而不是用 Windows 那个。

2. 环境准备：Node.js 和 Git 一个都不能少

2.1 安装 Node.js 的正确姿势

Claude Code 是通过 npm 分发的，所以 Node.js 是整个安装环节的地基。版本要求是 18.0.0 及以上，我建议直接装 LTS 版本，比如 20.x 或者 22.x，不建议装最新的大版本尝鲜，稳定优先。

安装方式有两种，任选其一：

• 方式一：到 nodejs.org 官网下载 Windows Installer（.msi 文件），一路下一步。需要注意安装到“选择功能”那一步时，确认"Add to PATH"选项是勾选状态，这是很多人后面找不到命令的根源。
• 方式二：如果你需要频繁切换 Node.js 版本，可以装 nvm-windows（一个针对 Windows 的 Node 版本管理工具），然后用命令安装指定版本。我个人比较推荐这种方式，因为后续升级 Node.js 或者为不同项目切换版本会方便很多，但如果你只是偶尔用，直接装官网的安装包就够了。

装完之后，打开一个新的 PowerShell 窗口，分别执行下面两条命令验证：

node -v npm -v

如果都能输出版本号，说明 Node.js 环境就绪了。如果提示“node 不是内部或外部命令”，先别急着查别的，大概率是安装时没加到 PATH，要么重装一遍，要么手动把 Node.js 的安装目录加到系统 PATH 里。

2.2 顺手装好 Git，省得后面麻烦

Git 不是 Claude Code 的硬性依赖，不装它也不会影响安装，但我非常建议装。

原因很简单：Claude Code 在辅助开发时，经常会用到 git 命令来查看代码变更、对比文件、甚至生成 commit 信息。如果你机器上没有 git，这些功能全部不可用，体验直接砍半。

Git for Windows 的安装包同样没什么难度，安装向导里一路下一步就行。装完之后验证一下：

git --version

然后顺手配置一下全局用户信息，方便后续生成 commit 时不会报错：

git config --global user.name "你的名字" git config --global user.email "你的邮箱"

2.3 提前确认 PATH 环境变量，给自己省掉一晚上的排查

这一节是所有 Windows 安装教程里最容易忽略，但也是最容易出问题的地方。

npm 通过-g参数全局安装的工具，默认会被放到一个固定的目录。以 Windows 系统来说，通常是C:\Users\你的用户名\AppData\Roaming\npm。这个目录必须存在于 PATH 环境变量中，否则你安装完 claude 之后，在终端里敲 claude 会得到一句很经典的报错：

claude : 无法将“claude”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。

这句报错在热搜里出现率极高，几乎每天都有新人踩进去。提前检查一下就能规避。

在 PowerShell 里执行：

npm prefix -g

这个命令会输出 npm 全局安装目录。接着查看当前 PATH 是否包含它：

echo $env:Path

如果输出里没有那个 npm 目录，你需要手动添加。打开“设置 → 系统 → 关于 → 高级系统设置 → 环境变量”，在“用户变量”里找到 Path，点击编辑，新建一条，填上 npm 全局目录的路径，保存后重开终端。

或者用命令直接追加（注意把路径换成你自己的）：

setx PATH "$env:Path;C:\Users\你的用户名\AppData\Roaming\npm"

注意：用 setx 设置 PATH 会覆盖式地重写这个变量，虽然上面这条命令把原有内容也带上了，但为了稳妥起见，还是建议用图形界面操作。

3. 核心安装步骤：本质上就一条 npm 命令

3.1 用 npm 全局安装 Claude Code

环境准备好之后，安装反而没什么好说的。打开 PowerShell，执行：

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

我解释一下这条命令做了什么：npm 会从 npm 仓库下载 @anthropic-ai/claude-code 这个包，并且以全局模式安装，-g 参数决定了它会被放到前面说的那个全局目录，而不是当前项目里。

安装过程中你会看到进度条和一堆下载日志，如果网络正常，一两分钟内就能完成。装完之后，输出里通常会显示类似added X packages in Xs的信息，并且在列表里出现claude这个可执行命令的名称。

安装完成后第一件事，新开一个 PowerShell 窗口（注意，必须新开，不是继续用之前那个），执行版本验证：

claude --version

如果能输出一个版本号，比如4.5.x，恭喜你，安装这一关就已经过了。

3.2 不全局安装的临时用法

如果你只是想在某个项目里临时体验一下，不想污染全局环境，可以用 npx 方式直接运行：

npx @anthropic-ai/claude-code

npx 会临时下载并执行这个包，用完就走，不会在全局目录留下可执行文件。但说实话，Claude Code 这种工具你是要日常反复用的，每次敲一长串 npx 命令太啰嗦，直接全局安装才是正解。

如果你碰到 npm 网络慢的问题，可以先把 npm 的镜像源切换到国内镜像，再执行安装：

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

切换之后重新安装，速度通常会快很多。这个属于基础网络优化，不属于任何特殊工具，放心用。

3.3 安装后第一次运行，先别急着干活

安装成功之后，我建议你先不要直接跑到真实项目里去搞，而是先在一个空白目录跑一下 claude，感受一下它的启动流程。因为第一次启动需要初始化环境、可能还要下载一些补充文件，如果直接跑到大项目里，大项目文件多，上下文加载慢，你可能会误以为程序卡死了。用空白目录走一遍，确认它能正常启动，再正式进项目。

mkdir test-claude cd test-claude claude

如果一切正常，你会看到 Claude Code 的交互界面，它会提示你进行登录认证。这一步下一节详细讲。

4. 首次启动与登录认证：绕不开的关键步骤

4.1 登录方式怎么选

Claude Code 首次启动时会要求你认证身份。目前主流的认证方式有两种：

• 方式一：直接用 Claude 账号登录。在交互界面里选择登录选项，它会弹出一个浏览器窗口，你完成网页登录授权之后，终端里的 Claude Code 就自动关联上你的账号了。这种方式比较省事，适合使用 Claude 订阅服务的用户。
• 方式二：使用 API Key。如果你是通过 API 来调用，需要先到对应平台创建一个 API Key，然后在系统环境变量里配置好。

具体选哪一种，取决于你的账号类型和使用场景。订阅账号直接用账号登录最方便；API 用户则建议用 API Key。

4.2 配置 API Key 的两种姿势

如果你想用 API Key 方式，环境变量名是ANTHROPIC_API_KEY。

在 PowerShell 里，临时配置的方式是：

$env:ANTHROPIC_API_KEY = "sk-ant-你的密钥"

但这种方式只对当前终端窗口有效，终端一关就失效了，下次启动还得重新设置。所以我更推荐永久配置，用 setx 写入用户环境变量：

setx ANTHROPIC_API_KEY "sk-ant-你的密钥"

执行这条命令后，你需要在系统设置里找到环境变量确认一下，设置成功后重开终端，运行echo $env:ANTHROPIC_API_KEY验证一下。

注意：把 API Key 写进环境变量之后，任何终端进程都能读到它，请确认这台机器是你个人专用。另外，key 不要写进项目代码或提交到 git 仓库，那是给自己埋雷。

4.3 第一次进入交互界面，先掌握这几个基础操作

登录认证完成后，Claude Code 就正式进入可交互状态了。它会先扫描当前目录的文件结构，加载上下文。这里有几个高频操作，我建议你先记住：

• 输入你准备让 AI 处理的任务描述，然后回车，等待它处理
• 输入/help可以查看所有可用命令，比如/model切换模型、/clear清空当前会话、/compact压缩对话历史
• 按 Ctrl+C 两次，或者输入 exit，退出交互界面
• 当 Claude Code 想执行终端命令时，它会请求你的授权，输入 y 允许，输入 n 拒绝

第一次用的时候，建议先给它一个小任务来适应它的工作方式，比如“帮我看看这个目录下有哪些 Python 文件，并简单描述每个文件的功能”。这样能快速确认环境是否一切正常。

4.4 配置文件在哪里

Claude Code 的配置信息通常存放在用户目录下的.claude/文件夹中。你可以在里面找到 settings.json 等配置文件，修改模型的默认行为、设置代理等。关于代理，我的建议是：如果你所在的网络环境访问相关服务不稳定，自行检查系统网络设置即可，这里不展开也不讨论工具类话题。

在项目层面，.claude/ 也可以放在项目根目录，用于做项目级别的自定义配置。如果你和团队协作，把项目级配置提交到仓库里是常见做法，但要确保里面没有敏感信息。

5. 常见问题排查与避坑实录

5.1 “claude 不是内部或外部命令”怎么破

这是 Windows 下最经典的报错，搜索引擎热搜词里长期霸榜。

原因我前面已经暗示过了：npm 全局安装目录没有加到 PATH 里，或者安装时没有把 Node.js 加到 PATH。排查步骤如下：

1. 执行npm prefix -g拿到全局目录路径
2. 执行echo $env:Path确认目录是否在 PATH 中
3. 如果不在，按 2.3 节的方法添加
4. 添加后重开终端，再执行claude --version

补充一点：如果你用的是 PowerToys、Windows Terminal 这类工具，添加环境变量后需要完全关闭所有终端窗口再重新打开，有时甚至需要重启一次系统才能生效。这不是系统坏了，只是环境变量刷新时机的问题。

5.2 npm 安装慢、卡住、超时

npm 默认使用官方源，在某些网络环境下访问不稳定。最直接的解决办法就是切换到国内镜像源：

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

设置完成后再执行安装，速度会有明显改观。如果你的安装过程卡在某个地方超过几分钟没反应，直接 Ctrl+C 中断重来，没必要干等。另外，装完之后如果想换回官方源，执行：

npm config set registry https://registry.npmjs.org/

5.3 PowerShell 里中文乱码怎么办

Windows 终端的中文乱码问题，历史上是代码页（Code Page）设置导致的。默认情况下，GBK 代码页下跑 UTF-8 内容的程序，很容易出现汉字变乱码。

解决办法分三步，从临时到一劳永逸：

1. 在 PowerShell 里执行chcp 65001，把当前窗口代码页切换成 UTF-8，临时解决当前窗口的乱码问题。
2. 如果你用 Windows Terminal，可以在设置中找到配置文件，把默认编码方式设为 UTF-8，这样每次开启终端都是正确编码。
3. 如果你希望整个系统层面解决，可以到“控制面板 → 区域 → 管理 → 更改系统区域设置”，勾选“Beta：使用 Unicode UTF-8 提供全球语言支持”，重启后系统所有终端默认使用 UTF-8。但这里提示一下，这个选项可能影响部分老软件的显示，建议谨慎操作。

Claude Code 本身输出的内容大部分是中英文混合的，系统区域设置不对的话，显示上和代码文件的兼容性都会受影响。优先建议采用方案二，只调终端，不影响全局。

5.4 在 WSL 和 Windows 原生之间反复横跳带来的坑

有一些开发者按教程在 WSL 里装了一遍，又在 Windows 里装了一遍，然后发现两边的 claude 命令指向不同的版本，或者环境变量互相覆盖。这不是 bug，而是两套环境隔离导致的正常现象。

我的建议是：确定一个主环境。如果你日常开发在 Windows 侧，就用 Windows 的安装；如果你需要跑 Linux 工具链，就统一到 WSL 里。不要在同一个会话里频繁切换，特别是在项目文件位于两个系统交叉路径时，路径映射容易混乱。如果你已经混装了，至少保证在 Windows 终端里敲where claude确认当前用的是哪一个。

5.5 常见问题速查表

6. 装好之后怎么快速上手，别让工具吃灰

6.1 第一个实战任务，建议从这三类开始

装好工具之后最怕的就是不知道让它干什么。我建议你从下面三个方向里选一个作为第一个任务：

• 代码解释：找一个你不太熟悉的开源项目目录，运行 claude 后输入“请解释一下这个项目的整体架构，以及各个目录的作用”。它会快速生成一份脉络梳理，非常适合快速了解新项目。
• 写测试用例：挑一个你自己写的脚本模块，让它帮你补一组单元测试。它能根据现有代码逻辑生成测试框架和用例，你只需要运行并检查结果。
• 重构代码：找一段你早就看不下去的代码，告诉它“帮我重构这个函数，保持行为不变，让代码更清晰”。它会给出修改后的代码，并说明改动理由。

我个人比较推荐第一个，因为代码解释任务能让你最快感受到 Claude Code 的上下文理解能力，而且风险最低，不会动你的任何代码。

6.2 几个值得记住的命令习惯

• 会话中随时用/clear清空上下文，避免把上一个大任务的历史带进新任务里，干扰判断
• 任务比较复杂时，拆成小步骤推进，比一次性抛出一个庞大需求要靠谱得多
• 当它执行了你不理解的命令时，直接拒绝并追问它为什么执行这条命令，不要盲目放行
• 每次完成一个重要改动后，自己跑一遍测试或者构建，别直接信 AI 的“改好了”

6.3 版本升级和卸载同样重要

Claude Code 迭代速度很快，新版本经常修复 bug、增加功能。升级很简单，重新执行一次全局安装命令：

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

卸载则执行：

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

卸载之后，用户目录下的.claude/配置文件夹通常不会自动删除，如果你想彻底清理，可以手动删除该文件夹。

6.4 一个实际的流程感受

我自己的典型使用流程是：先 cd 到项目根目录，启动 claude，给它一个明确的任务描述，比如“帮我把这个 Python 脚本改成支持命令行参数输入”。它会先分析现有代码，给出修改方案，征求我同意后逐文件修改。改完之后我让它运行测试脚本，它把测试输出读回来，如果失败了还会继续迭代修复。整个过程我基本只负责观察和确认，压力小了很多。这个体验在 Windows 原生环境下目前已经很稳定，值得花点时间把它配置好。

我自己在实际操作中还有一个习惯：每次安装完这类工具，都会在桌面建一个“测试目录”专门用来跑新工具的首次验证，避免一上来就在真实项目里搞出不可控的变动。这个习惯也推荐给你，尤其是当你准备尝试新版本、新工具的时候，先隔离再接入，能帮你省下很多后悔药。