主题
Linux安装
安装前准备
Claude Code 需要通过 npm 安装。
npm 通常跟随 Node.js 一起安装，所以 Linux 系统需要先安装 Node.js。
安装前请先准备好：
- 一台 Linux 电脑或 Linux 服务器
- 可以正常联网
- 可以打开终端
- 知道自己使用的是哪种 Linux 发行版
注意：不同 Linux 发行版安装 Node.js 的方式可能不同。
建议优先使用 Node.js 官网推荐的安装方式，不要随便复制来路不明的安装命令。
Node.js 官方地址：
text
https://nodejs.org/第一步：下载或安装 Node.js
打开 Node.js 官方网站：
text
https://nodejs.org/选择 LTS 长期支持版。
如果官网提供适合你系统的安装方式，优先按照官网说明操作。
如果你使用的是常见 Linux 发行版，也可以使用系统包管理器安装。
Ubuntu 或 Debian 系统可以参考下面的基础命令：
bash
sudo apt update
sudo apt install nodejs npm这两行命令的作用是：更新软件列表，然后安装 Node.js 和 npm。
如果你会使用 nvm，也可以通过 nvm 安装 Node.js LTS 版本。
如果你不确定该用哪种方式，建议先使用 Node.js 官网推荐方式，或者让熟悉 Linux 的人帮你确认。
第二步：检查 Node.js 是否安装成功
打开终端。
复制下面这行命令，粘贴到终端里，然后按回车：
bash
node -v这个命令用来查看 Node.js 版本。
如果看到类似 v20.x.x、v22.x.x 这样的版本号，说明 Node.js 可以使用。
如果提示 node 命令不存在，说明 Node.js 还没有安装成功，或者安装路径没有配置好。
第三步：检查 npm 是否可用
继续在终端输入下面这行命令：
bash
npm -v这个命令用来查看 npm 版本。
如果看到版本号，说明 npm 可以正常使用。
如果 node -v 正常，但 npm -v 不正常，说明 npm 可能没有安装，需要根据你的系统补装 npm。
第四步：使用 npm 安装 Claude Code
确认 node -v 和 npm -v 都能正常显示版本号后，再安装 Claude Code。
复制下面这行命令，粘贴到终端里，然后按回车：
bash
npm install -g @anthropic-ai/claude-code这行命令的意思是：使用 npm 在系统里全局安装 Claude Code。
安装过程可能需要等待一会儿，请不要中途关闭终端。
如果安装过程中出现权限问题，不要随便复制网上的危险命令。
请先确认 npm 的全局安装目录权限是否正确，或者让熟悉 Linux 的人帮你处理。
第五步：检查 Claude Code 是否安装成功
安装完成后，输入下面这行命令：
bash
claude --version这个命令用来查看 Claude Code 的版本。
如果能看到版本号，说明 Claude Code 已经安装成功。
你也可以再执行下面这行命令，做更完整的环境检查：
bash
claude doctor这个命令会检查 Claude Code 当前环境是否正常。
如果检查结果没有明显错误，就可以继续下一步。
第六步：第一次启动 Claude Code
复制下面这行命令，粘贴到终端里，然后按回车：
bash
claude这个命令会启动 Claude Code。
第一次启动时，终端可能会提示你登录或进行初始化设置。
按照终端提示一步一步操作即可。
常见问题
node 命令不存在怎么办？
说明 Node.js 还没有安装成功，或者当前终端找不到 Node.js。
可以重新按照 Node.js 官网的 LTS 长期支持版说明安装。
安装完成后，重新打开终端再试。
npm 命令不存在怎么办？
有些 Linux 系统会把 Node.js 和 npm 分开安装。
可以根据你的发行版补装 npm。
如果你使用 Ubuntu 或 Debian，可以参考：
bash
sudo apt install npm执行前请确认你正在使用的系统确实是 Ubuntu 或 Debian。
claude 命令不存在怎么办？
先确认安装命令是否执行成功：
bash
npm install -g @anthropic-ai/claude-code然后重新打开终端，再执行：
bash
claude --version如果还是找不到，可能是 npm 全局安装目录没有加入 PATH。
安装很慢怎么办？
安装慢通常和网络有关。
可以先等待几分钟。
如果一直没有进度，可以换网络后再试。
终端看不懂怎么办？
你只需要复制文档里的命令，粘贴到终端里，然后按回车。
如果出现报错，不要乱试危险命令。
可以把报错内容截图发给客服或懂 Linux 的人帮你看。
安装完成后下一步做什么？
先执行：
bash
claude doctor确认环境正常后，再执行：
bash
claude然后按照 Claude Code 的提示继续配置。