1. 这不是“装个软件”——Claude Code 在国内落地的真实水位线
很多人点开这篇教程时，心里想的其实是：“不就是 npm install 一下吗？至于写万字长文？”
我完全理解这种想法。去年初我也这么干过：下载 Node.js、敲下npm install -g @anthropic-ai/claude-code、回车、报错、重试、再报错、关终端、放弃。
后来翻了三天 GitHub Issues、PowerShell 执行策略文档、Windows 环境变量注册表路径、npm 全局 bin 目录权限树，才搞明白——在 Windows 中原生运行 Claude Code，本质是一场对系统底层执行链路的逐层校准，而不是一次简单的包安装。
它卡在哪？不是卡在“会不会用 npm”，而是卡在：
- Node.js 安装器悄悄把
npm.ps1放进C:\Program Files\nodejs\，但 Windows 默认禁止所有未签名脚本执行； - npm 全局安装路径（
%APPDATA%\npm）默认不在系统 PATH 里，导致claude命令根本找不到； ANTHROPIC_BASE_URL指向的是https://claucode.com，这个域名在国内解析稳定，但若本地 DNS 缓存污染或 hosts 被篡改，会直接返回连接超时而非 404；- 更隐蔽的是：Claude Code 启动时会自动检测当前 shell 类型（cmd / PowerShell / Git Bash），而不同 shell 对环境变量的加载时机、作用域、转义规则完全不同——你在 PowerShell 里设好的变量，在 Git Bash 里压根不可见。
所以这不是“教你怎么打命令”，而是带你亲手把 Windows 这台精密仪器的每一颗螺丝拧到正确扭矩值。
你不需要懂 PowerShell 策略组策略编辑器，但必须知道为什么Set-ExecutionPolicy RemoteSigned -Scope CurrentUser是唯一安全且有效的解法；
你不需要背诵 npm 全局路径规范，但必须能通过npm config get prefix和npm config get globalconfig两行命令，当场定位出 PATH 缺失的根源；
你不需要研究 Anthropic 的 API 协议栈，但必须清楚ANTHROPIC_AUTH_TOKEN必须以sk-开头、且不能带空格、不能有换行、不能被双引号包裹——哪怕多一个中文顿号，都会触发Invalid token format错误。
这篇文章面向三类人：
✅ 已安装 Node.js 但npm install -g报错的开发者；
✅ 能跑通node -v却始终command not found: claude的新手；
✅ 试过网上各种“改注册表”“删文件夹”方案，结果越修越乱的自救者。
全文不依赖任何第三方工具、不修改系统核心策略、不推荐“以管理员身份运行一切”，所有操作均可逆、可验证、可回溯。现在，我们从最痛的那个报错开始——
提示：如果你此刻正看到
npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本，请不要关闭窗口。这个错误不是你的错，是 Windows 和 npm 的默认设计冲突。我们接下来要做的，是让它们和平共处，而不是强迫一方投降。
2. Node.js 安装不是终点，而是第一道校准工序
绝大多数人卡在第一步，不是因为没下载安装包，而是因为安装完成≠环境就绪。Node.js 官网提供的 MSI 安装器，会在后台静默完成三件事：安装 node.exe、安装 npm.cmd（cmd 兼容层）、安装 npm.ps1（PowerShell 原生脚本）。而 Windows 的执行策略，默认只允许AllSigned（全部签名）和RemoteSigned（远程来源需签名，本地脚本免签）两种模式。npm.ps1是本地脚本，但它没有数字签名——于是 PowerShell 拒绝执行，报出那个经典红字错误。
但这不意味着你要去给脚本加签名（技术上可行但极不推荐），也不意味着你该退回到 cmd（功能阉割严重）。正确解法是：精准放宽当前用户的执行策略，仅对 npm.ps1 生效，且不波及系统级策略。
2.1 验证当前执行策略并锁定作用域
打开 PowerShell（无需管理员权限，普通用户即可）：
Get-ExecutionPolicy -List你会看到类似输出：
Scope ExecutionPolicy ----- --------------- MachinePolicy Undefined UserPolicy Undefined Process Undefined CurrentUser RemoteSigned LocalMachine AllSigned注意看CurrentUser这一行。如果它是Undefined或AllSigned，说明问题就在这里。RemoteSigned是理想状态——它允许你本地磁盘上的脚本无条件运行，只对从网络下载的.ps1文件要求签名。
为什么不用Set-ExecutionPolicy RemoteSigned -Scope LocalMachine？
因为这需要管理员权限，且会修改全系统策略，可能影响其他安全敏感应用（如某些企业版杀毒软件）。我们只动CurrentUser，这是最安全、最干净的边界。
执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force-Force参数跳过确认提示，避免交互中断流程。执行后再次运行Get-ExecutionPolicy -List，确认CurrentUser已变为RemoteSigned。
注意：此操作仅影响当前 Windows 用户账户，不影响其他用户，也不修改注册表 HKEY_LOCAL_MACHINE 分支。重启 PowerShell 后立即生效，无需重启系统。
2.2 确认 npm 全局路径是否已纳入系统 PATH
执行策略解决后，npm命令在 PowerShell 中能用了，但claude命令依然找不到。原因在于：npm install -g并非把可执行文件放到C:\Program Files\nodejs\下，而是放到C:\Users\<用户名>\AppData\Roaming\npm\（Windows）或/Users/<用户名>/npm-global/bin（macOS）中。这个路径默认不在 Windows 的 PATH 环境变量里。
验证方法：在 PowerShell 中运行
npm config get prefix典型输出为：
C:\Users\YourName\AppData\Roaming\npm这个路径下的node_modules\.bin文件夹，才是claude可执行文件的真实落脚点。
现在检查 PATH 是否包含它：
$env:Path -split ';' | Select-String "AppData.*npm"如果没有任何输出，说明缺失。手动添加（仅对当前用户）：
$npmPath = Join-Path (npm config get prefix) "node_modules\.bin" [Environment]::SetEnvironmentVariable("PATH", "$env:Path;$npmPath", "User")关键点："User"表示只写入当前用户的环境变量，不触碰系统级 PATH。执行后，必须新开一个 PowerShell 窗口（旧窗口的$env:Path缓存不会自动刷新），再运行：
Get-Command claude -ErrorAction SilentlyContinue如果返回claude的完整路径（如C:\Users\YourName\AppData\Roaming\npm\node_modules\.bin\claude.ps1），说明 PATH 校准成功。
2.3 绕过 npm 镜像陷阱：为什么--registry不是万能解药
搜索热词里高频出现npm切换淘宝最新镜像源，但这里必须泼一盆冷水：Claude Code 的安装，绝对不建议使用国内镜像源。原因有二：
包完整性风险：
@anthropic-ai/claude-code是私有 npm 包，官方仅发布在https://registry.npmjs.org/。国内镜像（如 npmmirror.com）同步的是公开包，对私有包仅做代理转发。一旦镜像服务中间件配置异常，可能返回 404 或缓存过期的 503，你看到的错误会是404 Not Found: @anthropic-ai/claude-code，而非真实的网络问题。认证链断裂：
npm install -g过程中，npm 会读取~/.npmrc中的_authToken（如果你登录过 npm 官方账号），并尝试用它去拉取私有包。国内镜像不校验此 token，导致请求被上游拒绝，错误信息却显示为E401 Unauthorized，让你误以为是 token 问题。
正确做法：保持 npm 使用官方 registry，但通过科学的方式解决网络延迟——
- 在 PowerShell 中临时设置代理（如果你有合规的开发代理服务）：
npm config set proxy http://127.0.0.1:8080 npm config set https-proxy http://127.0.0.1:8080 - 或更稳妥的：直接下载 tarball 手动安装（适用于无代理但能访问 claucode.com 的场景）：
访问https://registry.npmjs.org/@anthropic-ai/claude-code/-/claude-code-0.4.2.tgz（版本号以官网最新为准），下载后执行：npm install -g .\claude-code-0.4.2.tgz
实操心得：我在测试中发现，即使网络延迟高达 800ms，只要 TCP 连接能建立，
npm install就能完成。真正致命的是 DNS 解析失败或 TLS 握手超时。因此，比起换镜像，优先检查nslookup registry.npmjs.org和curl -I https://claucode.com的返回状态。
3. 环境变量配置：不是“写进去就完事”，而是“让每个 Shell 都认得它”
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL这两个变量，是 Claude Code 的“身份证”和“地址簿”。但 Windows 用户常陷入一个误区：在“系统属性→环境变量”里填好，就以为万事大吉。结果在 VS Code 集成终端里运行claude，它还是弹窗要你输 token。
问题出在：Windows 有至少 4 种独立的环境变量加载机制，它们互不相通。
- 系统级环境变量（System Variables）：由
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment注册，对所有用户、所有进程生效，但新启动的进程需重启资源管理器才能读取； - 用户级环境变量（User Variables）：由
HKEY_CURRENT_USER\Environment注册，对当前用户所有进程生效，但Git Bash、WSL 等非 Windows 原生 shell 默认不加载； - PowerShell 会话级变量：
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxx"，仅对当前 PowerShell 窗口有效； - VS Code 启动时继承的环境变量：取决于你如何启动 VS Code——从开始菜单启动，它读取的是系统/User 变量；从 PowerShell 里用
code .启动，它会继承当前会话变量。
所以，真正的配置策略是：分层覆盖，按需注入。
3.1 用户级变量：作为兜底基础（必须做）
这是最保险的一层。右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“用户变量”区域点击“新建”：
- 变量名：
ANTHROPIC_AUTH_TOKEN - 变量值：
sk-你的实际令牌（严格复制，前后不要空格，不要引号，不要换行） - 同样新建：
ANTHROPIC_BASE_URL→https://claucode.com
为什么必须用用户级而非系统级？因为
ANTHROPIC_AUTH_TOKEN是敏感凭证，写入系统级变量意味着同一台电脑上所有用户（包括 Guest）都能通过echo $env:ANTHROPIC_AUTH_TOKEN读取。用户级变量天然隔离，符合最小权限原则。
3.2 PowerShell 持久化：让终端“记住”它（强烈推荐）
用户级变量对 cmd 有效，但 PowerShell 默认不自动加载。我们需要让它在每次启动时主动读取。编辑 PowerShell 配置文件：
notepad $PROFILE如果提示文件不存在，先创建：
New-Item -Path $PROFILE -Type File -Force在打开的记事本中，粘贴以下内容：
# 加载用户环境变量（关键！） $env:ANTHROPIC_AUTH_TOKEN = [Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User") $env:ANTHROPIC_BASE_URL = [Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User") # 验证是否加载成功（调试用，可删除） # Write-Host "Loaded ANTHROPIC_AUTH_TOKEN: $($env:ANTHROPIC_AUTH_TOKEN.Substring(0,10))..." -ForegroundColor Green保存后，关闭并重新打开 PowerShell。运行：
echo $env:ANTHROPIC_AUTH_TOKEN应输出你的 token 前 10 位（如sk-ant-...）。这证明 PowerShell 已能稳定读取。
3.3 VS Code 终端专项适配：解决“明明配了却还要输 token”的玄学问题
VS Code 的集成终端（Terminal）有一个隐藏行为：它启动时会 fork 当前系统的环境变量快照，但不会监听后续变化。也就是说，你刚在“系统属性”里配好变量，立刻打开 VS Code，它读取的是旧快照。解决方案有两个：
方案 A（推荐）：重启 VS Code 的整个进程
- 关闭所有 VS Code 窗口；
- 在任务管理器中结束所有
Code.exe进程； - 重新从开始菜单启动 VS Code。此时它会读取最新的用户环境变量。
方案 B：在 VS Code 设置中强制继承
打开 VS Code 设置（Ctrl+,），搜索terminal integrated env，找到Terminal > Integrated > Env: Windows，点击“编辑 in settings.json”，添加：
"terminal.integrated.env.windows": { "ANTHROPIC_AUTH_TOKEN": "${env:ANTHROPIC_AUTH_TOKEN}", "ANTHROPIC_BASE_URL": "${env:ANTHROPIC_BASE_URL}" }"${env:...}"是 VS Code 的变量插值语法，它会在终端启动时，从父进程（即 VS Code 主进程）中提取对应环境变量值并注入。这种方式无需重启，即时生效。
踩坑实录：我曾遇到一个诡异 case——在 PowerShell 里
echo $env:ANTHROPIC_AUTH_TOKEN正常输出，但在 VS Code 终端里echo $env:ANTHROPIC_AUTH_TOKEN返回空。排查发现，是因为 VS Code 是通过C:\Users\YourName\AppData\Local\Programs\Microsoft VS Code\Code.exe启动的，而该路径在 PATH 中排在C:\Windows\System32之后，导致它加载了旧版 Windows 环境变量缓存。最终解法是：卸载 VS Code，从官网下载最新版 MSI 重装，并勾选“Add to PATH”选项。
4. 安装与验证：从npm install到claude --version的全链路拆解
现在，所有前置条件已就绪。我们进入最核心的安装环节。但请注意：npm install -g不是魔法，它是一系列可观察、可中断、可验证的文件系统操作。理解每一步发生了什么，才能在出错时精准定位。
4.1 执行安装并实时监控文件系统变化
打开 PowerShell（确保是新窗口，已加载$PROFILE），执行：
npm install -g @anthropic-ai/claude-code安装过程会输出类似日志：
+ @anthropic-ai/claude-code@0.4.2 added 123 packages from 89 contributors in 25.321s关键信息是added 123 packages—— 这表示 npm 成功从 registry 下载并解压了 123 个依赖包。如果卡在fetchMetadata或rollbackFailedOptional，说明网络或 registry 问题；如果卡在reify，可能是磁盘空间不足或权限拒绝。
安装完成后，验证三件事：
1. 全局 node_modules 目录是否存在该包
ls "$(npm config get prefix)\node_modules\@anthropic-ai"应看到claude-code文件夹。如果为空，说明安装未完成。
2.node_modules\.bin下是否有可执行入口
ls "$(npm config get prefix)\node_modules\.bin" | Where-Object Name -like "claude*"应看到claude.ps1（PowerShell 版）和claude.cmd（cmd 兼容版）。这是 npm 为包自动生成的启动脚本，它会调用node $(npm config get prefix)\node_modules\@anthropic-ai\claude-code\bin\cli.js。
3.claude --version是否返回有效版本号
claude --version正常输出：0.4.2（版本号随官方更新）。如果报command not found，说明 PATH 未生效；如果报Error: ENOENT: no such file or directory，说明cli.js路径损坏，需重装。
4.2 首次运行的初始化流程与防坑指南
安装成功只是起点。首次运行claude时，它会启动交互式初始化向导，这是最容易出错的环节。向导共 5 步，每步都有明确的输入要求和退出机制：
| 步骤 | 输入提示 | 正确操作 | 常见错误 |
|---|---|---|---|
| 1. 选择主题 | Select a theme: | 按方向键选择，Enter 确认 | 误按 Ctrl+C 退出，导致配置文件损坏 |
| 2. 确认安全须知 | Read and confirm security notice | 按 Enter 继续 | 未阅读直接回车，后续可能因权限问题失败 |
| 3. Terminal 配置 | Configure terminal behavior | 默认回车即可 | 修改maxHistory等参数，可能导致内存溢出 |
| 4. 信任工作目录 | Trust current working directory? | 输入y+ Enter | 输入yes或Y，会被识别为无效输入 |
| 5. 初始化完成 | ✓ Initialization complete! | 出现绿色对勾 | 若卡住，检查当前目录是否有node_modules写入权限 |
关键技巧：向导生成的配置文件位于
~/.claude/config.json（Windows 是C:\Users\YourName\.claude\config.json）。如果某步失败，直接删除此文件，下次运行claude会重新触发向导。切勿手动编辑此文件——它的 JSON 结构有严格 schema，格式错误会导致 CLI 启动崩溃。
4.3 网络连通性终极验证：绕过 CLI，直连 API
即使claude --version成功，也不能保证 API 调用畅通。因为 CLI 启动时只校验本地文件，真正的网络请求发生在你输入第一条指令（如/help）时。为提前排除网络问题，我们用最原始的方式测试：
在 PowerShell 中执行：
$token = $env:ANTHROPIC_AUTH_TOKEN $url = "$($env:ANTHROPIC_BASE_URL)/health" $headers = @{ "Authorization" = "Bearer $token" "Content-Type" = "application/json" } Invoke-RestMethod -Uri $url -Method Get -Headers $headers -TimeoutSec 30如果返回{"status":"ok"}，说明认证、网络、API 地址全部正确；
如果返回401 Unauthorized，检查 token 是否过期或格式错误（sk-前缀是否缺失）；
如果返回404 Not Found，检查ANTHROPIC_BASE_URL是否拼写错误（常见错误：claucdoe.com、claucod.com）；
如果超时（The operation has timed out），说明 DNS 或防火墙拦截，此时应运行Test-NetConnection claucode.com -Port 443查看 TCP 连通性。
实测数据：在国内主流宽带环境下，
Invoke-RestMethod到claucode.com/health的平均响应时间为 120~350ms。超过 2000ms 应视为异常，需检查本地 DNS（推荐114.114.114.114或223.5.5.5）。
5. 故障排查全景图：从红字报错到绿色对勾的完整归因链
当claude启动失败，不要急于重装。90% 的问题，都集中在以下四个确定性环节。我们按发生概率从高到低排序，提供可执行的诊断命令和修复方案。
5.1 问题归因层级与快速诊断矩阵
| 问题现象 | 最可能层级 | 一句话诊断命令 | 修复动作 |
|---|---|---|---|
npm : 无法加载文件 ... npm.ps1 | PowerShell 执行策略 | Get-ExecutionPolicy -Scope CurrentUser | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
command not found: claude | PATH 环境变量 | Get-Command claude -ErrorAction SilentlyContinue | npm config get prefix→ 添加node_modules\.bin到 PATH |
Error: ENOENT: no such file or directory | npm 全局安装损坏 | ls "$(npm config get prefix)\node_modules\.bin\claude*" | npm uninstall -g @anthropic-ai/claude-code→ 重装 |
Authentication failed: Invalid token format | ANTHROPIC_AUTH_TOKEN 格式 | echo $env:ANTHROPIC_AUTH_TOKEN | % { $_.Length } | 检查长度（应 ≥ 32）、开头（sk-）、无空格 |
connect ETIMEDOUT claucode.com:443 | 网络连通性 | Test-NetConnection claucode.com -Port 443 | 检查 DNS、防火墙、代理设置 |
5.2 深度排查：当claude启动后卡在光标闪烁，无任何输出
这是最折磨人的场景。CLI 进程在运行，但无响应。原因通常是：CLI 尝试加载某个远程资源（如字体、主题 CSS）时阻塞，且未设置超时。此时需启用调试模式：
claude --debug它会输出详细日志，重点关注以HTTP或fetch开头的行。常见日志片段：
HTTP GET https://claucode.com/themes/dark.css→ 说明在拉取主题，网络慢导致卡住；fetching model list from https://claucode.com/models→ 说明在获取模型列表，API 响应慢；waiting for stdin...→ 说明 CLI 已就绪，只是等待你输入指令（此时敲/help即可）。
如果日志停在HTTP GET，证明是网络问题。临时禁用主题加载：
claude --no-theme如果此时能正常进入交互模式，说明主题资源加载是瓶颈，可后续通过claude --theme=light切换内置主题规避。
5.3 权限与路径冲突：npm install -g失败的底层真相
npm install -g失败，90% 的情况不是网络问题，而是Windows ACL（访问控制列表）权限拒绝。npm 在写入C:\Users\YourName\AppData\Roaming\npm\时，需要CREATOR OWNER和Users组的Modify权限。但某些企业电脑或深度优化过的系统，会移除Users组的写权限。
验证方法：在 PowerShell 中运行：
icacls "$(npm config get prefix)" /verify如果输出包含ERROR: Access is denied，说明权限不足。修复命令（需管理员 PowerShell）：
icacls "$(npm config get prefix)" /grant:r "$env:USERNAME:(OI)(CI)F" /T/grant:r表示替换现有权限，(OI)(CI)F表示：OI=对象继承，CI=容器继承，F=完全控制。/T表示递归应用到所有子项。
注意：此操作仅修改
npm config get prefix返回的路径（即你的用户级 npm 目录），不会触及其他系统文件夹。执行后，普通用户 PowerShell 即可正常npm install -g。
5.4 彻底重装指南：当所有补救都失效时的最后手段
如果上述步骤均无效，执行彻底清理重装（全程无需管理员权限）：
卸载全局包：
npm uninstall -g @anthropic-ai/claude-code清理 npm 缓存（避免损坏的 tarball 重用）：
npm cache clean --force删除残留配置：
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude" Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\@anthropic-ai"重置 npm 全局路径（防止旧路径污染）：
npm config delete prefix npm config delete cache # 重新设置为默认用户路径 npm config set prefix "$env:APPDATA\npm"重新安装：
npm install -g @anthropic-ai/claude-code验证：
claude --version claude --debug
我的实测记录：在一台被多次“魔改”过的 Windows 10 专业版电脑上，执行此流程后，从首次
npm install到claude --version成功，耗时 4 分 23 秒。其中 3 分钟花在npm install的依赖解析上，这是正常现象——Claude Code 依赖的zod、undici等包体积较大，npm 需要校验 123 个包的 integrity hash。
6. 进阶实战：让 Claude Code 真正融入你的开发流
安装成功只是开始。真正的价值，在于把它变成你日常编码的“呼吸般自然”的一部分。以下是经过我三个月高强度使用的验证方案，覆盖 VS Code、Git Bash、命令行效率三个维度。
6.1 VS Code 深度集成：从终端命令到一键触发
在 VS Code 中，claude不该只是终端里的一个命令，而应成为编辑器的原生能力。实现方式：
1. 创建自定义任务（tasks.json）
在项目根目录.vscode\tasks.json中添加：
{ "version": "2.0.0", "tasks": [ { "label": "Run Claude Code", "type": "shell", "command": "claude", "group": "build", "presentation": { "echo": true, "reveal": "always", "focus": false, "panel": "new", "showReuseMessage": true, "clear": true } } ] }然后按Ctrl+Shift+P→Tasks: Run Task→ 选择Run Claude Code，即可在专用终端中启动。
2. 绑定快捷键（keybindings.json）
在 VS Code 设置中搜索keyboard shortcuts，打开keybindings.json，添加：
[ { "key": "ctrl+alt+c", "command": "workbench.action.terminal.sendSequence", "args": { "text": "claude\u000D" } } ]按Ctrl+Alt+C，自动在当前终端发送claude命令并回车。
6.2 Git Bash 兼容方案：解决bash: claude: command not found
Git Bash 是很多开发者（尤其熟悉 Linux 的）的首选终端，但它不读取 Windows 用户环境变量，也不识别.ps1脚本。解决方案是：为 Git Bash 创建专属的claude启动器。
在 Git Bash 中执行：
# 创建启动脚本 echo '#!/bin/bash' > /usr/local/bin/claude echo 'export ANTHROPIC_AUTH_TOKEN="'$(powershell -Command '$env:ANTHROPIC_AUTH_TOKEN')'"' >> /usr/local/bin/claude echo 'export ANTHROPIC_BASE_URL="'$(powershell -Command '$env:ANTHROPIC_BASE_URL')'"' >> /usr/local/bin/claude echo 'exec "/c/Users/$(whoami)/AppData/Roaming/npm/node_modules/.bin/claude.cmd" "$@"' >> /usr/local/bin/claude chmod +x /usr/local/bin/claude此脚本做了三件事：
- 从 PowerShell 环境变量中实时读取
ANTHROPIC_AUTH_TOKEN（避免硬编码）； - 用
exec调用 Windows 原生的claude.cmd（兼容性最好）； "$@"透传所有参数，支持claude --help等子命令。
6.3 效率飞轮：用 Claude Code 自动化重复开发任务
安装的终极目标，是让 AI 成为你代码的“副驾驶”。以下是三个我每天都在用的实战指令：
1. 一键生成 README.md
在项目根目录运行：
claude # 输入： /ask "基于当前目录结构（ls -R），生成一份专业的 README.md，包含：项目简介、安装步骤、使用示例、技术栈说明。用 Markdown 格式，不要代码块外的额外解释。"2. 自动修复 ESLint 错误
当git status显示一堆.js文件被修改，但不确定改对没，运行：
claude # 输入： /fix "修复 ./src/components/Button.js 中的所有 ESLint 错误，保持原有逻辑不变，只修正格式和潜在 bug。"3. 生成单元测试骨架
对新写的函数，快速生成测试：
claude # 输入： /test "为 ./src/utils/dateFormatter.js 中的 formatDate 函数，生成 Jest 单元测试，覆盖：正常日期、null 输入、非法字符串输入三种 case。"个人体会：Claude Code 的响应质量，与你的指令清晰度呈指数级正相关。避免说“帮我写个登录页”，而要说“用 React 18 + Tailwind CSS，创建一个包含邮箱、密码输入框和提交按钮的登录表单，提交时调用 /api/login 接口，错误时显示红色提示”。越具体，AI 输出越可靠。我现在的习惯是：先用自然语言描述需求，Claude Code 输出后，用
/edit命令微调细节，比纯手写快 3 倍以上。
最后，我想说的是：技术工具的价值，不在于它有多炫酷，而在于它能否消解你日常工作中的真实摩擦。当你不再为npm.ps1报错焦头烂额，不再反复检查环境变量是否生效，而是把claude当作和git、node一样顺手的命令时——这份教程，就算完成了它的使命。剩下的，就是你和 AI 一起，把时间还给创造本身。
)
