安装 Claude Code 并让它真的跑起来

第一次运行卡住的三件事：Node 版本、PATH，以及你登录的套餐。

Claude Code 是命令行工具，不是编辑器插件。安装本身很短，失败几乎都出在环境上——真正让人放弃的，通常不是工具，而是第一次运行时的三个报错。

1. Node 版本

它需要较新的 Node LTS。如果 node -v 显示低于 18，先升级再谈其他。macOS 和 Linux 上最省事的是版本管理器，nvm 或 fnm，而不是系统包——发行版的包往往落后一到两个大版本。Windows 上走官方安装包装一个当前 LTS，然后重启终端。

2. 安装并检查 PATH

装完打开一个新的终端窗口再运行。如果提示 command not found，说明可执行文件被放到了 shell 不查找的位置——通常是没进 PATH 的全局 npm 目录。先看包装到了哪里，再决定改 PATH 还是重装。修 PATH 比重装快得多，这也是最常见的首次失败原因。

3. 用对的账号登录

工具使用的是你认证的那个账号上的订阅。有两个账号的人，先确认当前生效的是哪一个：在会话里问它登录的是哪个账号，或者去浏览器看账号页面。A 账号上的 Max，对登录在 B 账号的会话毫无作用。浏览器和终端落在不同账号上，是很常见的情况。

4. 在仓库里启动

在项目根目录运行，而不是你的主目录。agent 从启动位置读取上下文；从错误的目录启动，正是人们得出「它不懂这个项目」这个结论的原因。路径里有空格或中文时，先在终端里 cd 过去再启动。

5. 给一个可验证的任务

第一次运行应该小一点：「让这个失败的测试通过」「解释这个模块做什么」「给这条命令加一个参数」。宽泛的请求会产生昂贵的乱逛，也会让一个好用的工具留下糟糕的第一印象。

能跑起来但提示没有权限，怎么办

这是所有人问的第二个问题，而且很少是安装问题。按三步查。第一步，确认这个会话到底认证在哪个账号上，浏览器和终端可能不是同一个。第二步，确认那个账号确实持有付费周期：订阅是开在你提供 Organization ID 的那个账号上，不是开在你顺手登录的那个邮箱上。Organization ID 在设置里的账号页，前缀是 org_。第三步，区分两种标识：以 sk-ant- 开头的是 API 的计费密钥，不是账号标识；账号上的订阅不会跟着这个 key 走。如果套餐确实在、状态也正常，终端仍拒绝，就退出登录、关掉终端、重新在浏览器里完成一次登录。

另外说明一句流程：这边不需要你的密码，也不需要 2FA 验证码或恢复码。任何索要这两样的人，都不是我们。

常见失败，按频率排序

• Node 太旧——安装失败，或二进制立即退出。
• PATH——新终端里找不到命令。
• 账号不对——登录成功，但提示没有权限。
• 把 API 密钥当登录用——认证成功，但看不到订阅。
• 目录不对——改了不该改的文件。

第一次运行之前，先配好这三件事

第一，权限范围。工具会请求写文件、跑命令。第一次用，把可写范围限制在当前项目目录，把命令白名单留空，让它每次问你。习惯养成之后再放开，这不是胆小，这是让第一次运行的消耗可控。

第二，版本控制状态。先确认工作树干净，或者至少新开一个分支。agent 改文件的速度比你看 diff 的速度快，出错时唯一能救命的是能一次回滚。没有 git 的项目，先手动备份要改的那几个目录。

第三，密钥不进上下文。仓库里的 .env、私钥、令牌文件，先加到忽略列表里。工具的上下文来自启动目录，读进去了就等于发出去了。这一条比任何提示词技巧都重要。

Windows 上还有两个特有的问题：PowerShell 的执行策略可能拦住脚本，需要在当前用户范围放开；路径里有空格或中文时，先在终端里 cd 到项目目录再启动，不要让工具自己拼路径。

装完之后的三分钟健康检查

四条命令，顺序别换：node -v 确认版本够新；npm config get prefix 记下全局目录，然后确认它在 PATH 里；在新终端里跑一次版本查询，确认可执行文件真的找得到；最后在项目目录里而不是主目录里启动一次。这四步过了，剩下的问题基本都出在账号，不在环境。

账号侧只要记住一句：命令行用的是你认证的那个账号的订阅，而认证走浏览器。看到「没有权限」，先确认是哪个账号，再怀疑安装。

跑起来之后，限流指南解释为什么重度使用的下午会提前停下，套餐列表列出哪一档适合你的工作强度；想知道登录时用到的是哪个字段，先看Organization ID 是什么。

常见问题

返回套餐 →