[已解决]有没有大佬能详细教一下安装Claude code

woshijunjun

网上的教程实在是鱼龙混杂，有没有大佬有详细的教程（避坑指南）。

最佳答案

月排行榜 / 总排行榜

FishC

昨天 09:37

• 安装Node.js（推荐LTS版本，如18.x或20.x），不要安装太旧的版本，也不建议用最新的奇数版本（如21.x），否则可能不兼容。Windows用户请勾选“Add to PATH”；macOS用户建议使用nvm管理版本。
• 打开终端（cmd/PowerShell/terminal），运行以下命令全局安装Claude Code：
  
  1. 
     
  2. npm install -g @anthropic-ai/claude-code
     

  复制代码
  
  如果提示权限错误，Windows请以管理员身份运行终端；macOS/Linux请加 sudo 前缀，即 sudo npm install -g @anthropic-ai/claude-code。
• 安装完成后，需要设置API密钥。前往Anthropic官网获取API Key，然后在终端中输入：
  
  1. 
     
  2. set ANTHROPIC_API_KEY=你的API密钥
     

  复制代码
  
  （Windows用户）或者
  
  1. 
     
  2. export ANTHROPIC_API_KEY=你的API密钥
     

  复制代码
  
  （macOS/Linux用户）。建议将这一行写入shell配置文件（如.bashrc或.zshrc）避免每次重启终端重复输入。
• 验证安装：运行 claude --version 或 claude -h，看到版本号或帮助信息即成功。
  

避坑指南：

• 不要使用npm自带的旧版本，Node.js务必≥18.0.0，否则可能报错“不支持某些语法”。
• 如果安装时卡在“sill idealTree buildDeps”，请尝试更换npm镜像源：npm config set registry [url=https://registry.npmmirror.com。]https://registry.npmmirror.com。[/url]
• 注意API Key的额度，免费额度有限，用完需要付费。不要泄露给他人。
• 如果运行claude后提示“command not found”，请检查npm全局安装路径是否在PATH中。Windows用户可以尝试重新安装Node.js并勾选“Add to PATH”；macOS用户可以运行 npm config get prefix 查看路径，然后手动添加到PATH。
• 部分杀毒软件或防火墙可能拦截npm下载，请暂时关闭或添加信任。
• 如果使用Windows，建议直接使用PowerShell（管理员）而非CMD，避免权限问题。
  

如果以上步骤仍有问题，请提供具体的错误信息，我会帮你分析。

以上回复来自 FishC AI 小助理，如未能正确解答您的问题，请继续追问。

跳转到最佳答案楼层

FishC

• 安装Node.js（推荐LTS版本，如18.x或20.x），不要安装太旧的版本，也不建议用最新的奇数版本（如21.x），否则可能不兼容。Windows用户请勾选“Add to PATH”；macOS用户建议使用nvm管理版本。
• 打开终端（cmd/PowerShell/terminal），运行以下命令全局安装Claude Code：
  
  1. 
     
  2. npm install -g @anthropic-ai/claude-code
     

  复制代码
  
  如果提示权限错误，Windows请以管理员身份运行终端；macOS/Linux请加 sudo 前缀，即 sudo npm install -g @anthropic-ai/claude-code。
• 安装完成后，需要设置API密钥。前往Anthropic官网获取API Key，然后在终端中输入：
  
  1. 
     
  2. set ANTHROPIC_API_KEY=你的API密钥
     

  复制代码
  
  （Windows用户）或者
  
  1. 
     
  2. export ANTHROPIC_API_KEY=你的API密钥
     

  复制代码
  
  （macOS/Linux用户）。建议将这一行写入shell配置文件（如.bashrc或.zshrc）避免每次重启终端重复输入。
• 验证安装：运行 claude --version 或 claude -h，看到版本号或帮助信息即成功。
  

避坑指南：

• 不要使用npm自带的旧版本，Node.js务必≥18.0.0，否则可能报错“不支持某些语法”。
• 如果安装时卡在“sill idealTree buildDeps”，请尝试更换npm镜像源：npm config set registry [url=https://registry.npmmirror.com。]https://registry.npmmirror.com。[/url]
• 注意API Key的额度，免费额度有限，用完需要付费。不要泄露给他人。
• 如果运行claude后提示“command not found”，请检查npm全局安装路径是否在PATH中。Windows用户可以尝试重新安装Node.js并勾选“Add to PATH”；macOS用户可以运行 npm config get prefix 查看路径，然后手动添加到PATH。
• 部分杀毒软件或防火墙可能拦截npm下载，请暂时关闭或添加信任。
• 如果使用Windows，建议直接使用PowerShell（管理员）而非CMD，避免权限问题。
  

如果以上步骤仍有问题，请提供具体的错误信息，我会帮你分析。

以上回复来自 FishC AI 小助理，如未能正确解答您的问题，请继续追问。

woshijunjun

已解决

FishC

woshijunjun 发表于 2026-06-26 10:47
已解决

太好了，很高兴听到问题已经解决！  

如果你在后续使用中遇到其他疑问，比如如何配置项目、优化代码提示，或者不同API版本的兼容性问题，随时可以再来找我探讨。祝你编码愉快！

以上回复来自 FishC AI 小助理，如未能正确解答您的问题，请继续追问。