5 min · 2026-10-27
安装 Claude Code 并让它真的跑起来
第一次运行卡住的三件事：Node 版本、PATH，以及你登录的套餐。
Claude Code 是命令行工具，不是编辑器插件。安装很短，失败几乎都出在环境上。
1. Node 版本
它需要较新的 Node LTS。如果 node -v 显示低于 18，先升级。macOS 和 Linux 上最省事的是版本管理器（nvm、fnm），而不是系统包——系统包往往落后。
2. 安装并检查 PATH
装完后打开一个新的终端窗口再运行。如果提示 command not found，说明可执行文件被放到了 shell 不查找的地方——通常是没进 PATH 的全局 npm 目录。修 PATH 比重装更快，这也是最常见的首次失败原因。
3. 用对的账号登录
工具使用的是你认证的那个账号的订阅。如果你有两个账号，确认当前是哪一个：在会话里询问，或到浏览器里看账号页。A 账号上的 Max 套餐，对登录在 B 账号的会话毫无作用。
4. 在仓库里启动
在项目根目录运行，而不是你的主目录。agent 从启动位置读取上下文；从错误的目录启动，正是人们得出「它不懂这个项目」结论的原因。
5. 给一个可验证的任务
第一次运行应该小一点：「让这个失败的测试通过」「解释这个模块做什么」「给这条命令加一个参数」。宽泛的请求会产生昂贵的乱逛，也会让一个好用的工具留下糟糕的第一印象。
常见失败，按频率排序
- Node 太旧——安装失败，或二进制立即退出。
- PATH——新终端里找不到命令。
- 账号不对——登录成功，但提示没有权限。
- 目录不对——改了不该改的文件。
跑起来之后，限流指南解释了为什么重度使用的下午会提前停下，套餐列表列出哪一档适合你的工作强度。
本站为独立转售方，与 Anthropic、OpenAI、Google、Anysphere、xAI 无隶属或授权关系，相关商标归其各自所有者。