Claude Code装完跑不动?九成是开局踩了这个坑
Claude Code装完跑不起来,十有八九是环境没配对。不是它难伺候,是你开局踩了坑。**先确认三件事:系统版本、Node.js有没有装、Git装没装**。macOS需要13以上,Windows要Win10 1809+。Node.js低于18的直接升级,别硬上。Git是Windows用户的必装项,没它Claude Code底层命令跑不动。这三样齐了,才有资格谈安装。1
快速安装,选对方式省一半时间
**macOS/Linux用户**终端执行一行命令就搞定:curl -fsSL https://claude.ai/install.sh | bash。装完别急着跑,关闭终端重新打开,让PATH生效。**Windows用户**用PowerShell(管理员):irm https://claude.ai/install.ps1 | iex。前提是先装好Git for Windows,否则内部Git Bash跑不起来。1
有魔法的直接走官方脚本,国内网络环境推荐改用npm全局安装:npm install -g @anthropic-ai/claude-code。npm方式依赖Node.js,但绕过网络问题最稳。Homebrew也能装,但装完不会自动更新,**需要定期跑brew upgrade claude-code**才能跟上最新版。2
装完跑不动?配置没做全是白搭
**输入claude --version能看到版本号才算成功**。如果提示command not found,八成是PATH没配。macOS/Linux执行:echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc。Windows用户在系统环境变量Path里加一条:%USERPROFILE%\.local\bin,然后重启终端。1
国内用户用第三方API,必须跳过官方登录检查。创建配置文件:mkdir -p ~/.claude && echo '{"hasCompletedOnboarding": true}' > ~/.claude.json。然后在settings.json里填入API密钥和地址。**配置完必须重启终端**,否则新配置不生效。1
报错别慌,先跑这个命令
**遇到任何问题,第一时间输入/doctor**。它会自动扫描安装版本、配置文件合法性、PATH设置、网络连通性、Git依赖等七类问题,并给出具体修复建议。比在网上乱搜靠谱十倍。1
当前文章无评论,是时候发表评论了