Claude CLI 安装指南：直接安装、Node.js 安装与 Windows/macOS 配置

Claude CLI 通常指 Claude Code CLI：Anthropic 提供的命令行 AI 编程工具。它可以在终端里读取项目上下文、修改代码、运行命令，并通过交互式对话完成开发任务。

这篇文章只讲安装和基础配置，覆盖两条路线：

直接安装：优先推荐，少依赖，适合大多数用户。
Node.js/npm 安装：适合已经有 Node.js 环境、希望通过 npm 管理全局命令的用户。

系统覆盖 Windows 和 macOS，Linux/WSL 的命令也一并给出。

安装前准备

先确认三件事：

你有一个可用的 Anthropic / Claude 账号。
终端可以访问外网。
如果走 npm 安装，Node.js 建议使用 18 或更高版本。

检查 Node.js：

1 2	node -v npm -v

如果你只是想尽快开始用 Claude CLI，优先看下面的“直接安装”。

方式一：直接安装

直接安装不要求你先配置 Node.js，是官方更推荐的路线。安装完成后，系统里会出现 claude 命令。

macOS 直接安装

打开 Terminal，执行：

1	curl -fsSL https://claude.ai/install.sh \| bash

安装完成后，重新打开终端，或者按安装脚本提示刷新 shell 配置，然后检查：

1	claude --version

如果你使用 Homebrew，也可以用：

1	brew install --cask claude-code

Windows 直接安装

Windows 推荐使用 PowerShell。打开 PowerShell，执行：

1	irm https://claude.ai/install.ps1 \| iex

安装完成后，关闭并重新打开 PowerShell，检查：

1	claude --version

如果你习惯使用 WinGet，也可以尝试：

1	winget install Anthropic.ClaudeCode

Windows 还有另一条路线：通过 WSL 使用 Linux 环境。适合项目本身就在 Linux 工具链里开发的情况。

1 2	curl -fsSL https://claude.ai/install.sh \| bash claude --version

Linux / WSL 直接安装

Linux 和 WSL 使用同一条命令：

1	curl -fsSL https://claude.ai/install.sh \| bash

然后验证：

1	claude --version

如果提示 claude: command not found，通常是 PATH 没刷新。重新打开终端，或者按安装输出里的提示把 Claude CLI 所在目录加入 PATH。

如果没有 Node.js

只有选择 npm 安装时才需要 Node.js。如果你使用上面的直接安装方式，可以跳过这一节。

Node.js 建议安装 LTS 版本，它更适合日常开发和命令行工具。安装完成后，终端里应该同时能看到 node 和 npm：

1 2	node -v npm -v

Windows 安装 Node.js

最简单的方式是去 Node.js 官网下载 Windows Installer，选择 LTS 版本，一路按默认选项安装。安装完成后，关闭并重新打开 PowerShell：

1 2	node -v npm -v

如果你习惯用 WinGet，也可以直接安装：

1	winget install OpenJS.NodeJS.LTS

然后重新打开 PowerShell 验证版本：

1 2	node -v npm -v

macOS 安装 Node.js

macOS 可以从 Node.js 官网下载 LTS 安装包，也可以用 Homebrew：

1	brew install node

安装完成后验证：

1 2	node -v npm -v

如果你需要在多个项目之间切换 Node.js 版本，可以用 nvm：

1	curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh \| bash

重新打开终端后安装 LTS：

nvm install --lts
nvm use --lts
node -v
npm -v

Linux / WSL 安装 Node.js

Ubuntu / Debian 可以先用系统包管理器安装：

1 2	sudo apt update sudo apt install -y nodejs npm

然后验证：

1 2	node -v npm -v

如果系统源里的 Node.js 版本太旧，更推荐用 nvm 安装 LTS：

1	curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh \| bash

重新打开终端后执行：

nvm install --lts
nvm use --lts
node -v
npm -v

WSL 用户要注意：在 WSL 里安装 WSL 自己的 Node.js，不要依赖 Windows 里的 Node.js。这样路径、权限和项目依赖会更一致。

方式二：Node.js/npm 安装

如果你的机器已经有 Node.js 和 npm，可以通过 npm 全局安装：

1	npm install -g @anthropic-ai/claude-code

安装后检查：

1	claude --version

这条路线的优点是简单直观，缺点是会受到 Node.js、npm 全局目录和权限配置影响。尤其在 macOS/Linux 上，不建议用 sudo npm install -g 解决权限问题，最好先把 npm 全局目录配置到用户目录。

macOS 使用 npm 安装

推荐先安装 Node.js。可以从 Node.js 官网下载安装包，也可以使用 Homebrew：

1	brew install node

然后安装 Claude CLI：

1 2	npm install -g @anthropic-ai/claude-code claude --version

如果遇到 npm 全局权限问题，可以把全局包目录放到用户目录：

1 2	mkdir -p ~/.npm-global npm config set prefix ~/.npm-global

然后把下面这一行加入 ~/.zshrc：

1	export PATH="$HOME/.npm-global/bin:$PATH"

刷新配置：

1 2	source ~/.zshrc npm install -g @anthropic-ai/claude-code

Windows 使用 npm 安装

Windows 先安装 Node.js LTS。安装完成后，打开 PowerShell：

1 2	node -v npm -v

确认版本正常后安装：

1 2	npm install -g @anthropic-ai/claude-code claude --version

如果 claude 命令找不到，先关闭并重新打开 PowerShell。仍然不行，再检查 npm 全局目录：

1 2	npm config get prefix npm bin -g

确保 npm 的全局 bin 目录已经在系统 PATH 里。

WSL 使用 npm 安装

WSL 里不要混用 Windows 的 Node.js。建议在 WSL 内单独安装 Node.js，再安装 Claude CLI：

node -v
npm -v
npm install -g @anthropic-ai/claude-code
claude --version

如果项目主要跑在 Linux、Docker、远程服务器或 CI 环境中，WSL 往往比 Windows 原生命令行更接近生产环境。

第一次启动和登录

进入一个代码项目目录：

1 2	cd your-project claude

第一次启动会引导你登录或选择认证方式。完成后，就可以在终端里提需求，例如：

1	解释这个项目的启动流程

或者：

1	帮我修复当前测试失败的问题，并说明改了哪些文件

Claude CLI 是一个会读写本地项目的工具。第一次在重要项目里使用时，建议先确认当前 Git 工作区是干净的：

1	git status

这样即使 AI 修改了文件，也能清楚看到变更。

更新

直接安装版本通常可以使用内置更新机制，或者重新运行安装命令。npm 安装版本则使用：

1	npm update -g @anthropic-ai/claude-code

也可以直接重新安装最新版：

1	npm install -g @anthropic-ai/claude-code@latest

更新后检查：

1	claude --version

卸载

npm 安装的卸载方式：

1	npm uninstall -g @anthropic-ai/claude-code

Homebrew 安装的卸载方式：

1	brew uninstall --cask claude-code

Windows 如果是 WinGet 安装：

1	winget uninstall Anthropic.ClaudeCode

脚本直接安装的版本，按安装器实际输出的卸载提示处理；如果不确定安装位置，可以先查命令路径：

1	which claude

Windows PowerShell：

1	Get-Command claude

常见问题

1. `claude: command not found`

原因通常是 PATH 没生效。处理顺序：

关闭并重新打开终端。
检查 claude 安装位置。
把安装目录加入 PATH。

macOS/Linux：

1 2	which claude echo $PATH

Windows：

1 2	Get-Command claude $env:Path

2. npm 全局安装权限错误

不要优先使用 sudo npm install -g。更好的做法是调整 npm 全局目录到用户目录，或者使用 nvm / fnm 这类 Node.js 版本管理工具。

3. Windows 下项目命令跑不通

如果你的项目依赖 bash、make、Docker、Linux 路径或原生编译工具，建议放到 WSL 里跑 Claude CLI。Windows 原生终端适合 PowerShell、Node.js、Python、.NET 等原生开发流。

4. 公司网络或代理环境无法登录

先确认浏览器能访问 Claude，再检查终端代理配置。很多时候浏览器能联网，不代表终端也能联网。

macOS/Linux 常见代理变量：

1 2	export HTTPS_PROXY=http://127.0.0.1:7890 export HTTP_PROXY=http://127.0.0.1:7890

PowerShell：

1 2	$env:HTTPS_PROXY="http://127.0.0.1:7890" $env:HTTP_PROXY="http://127.0.0.1:7890"

端口要换成你自己的代理端口。

怎么选安装方式

如果你没有特殊要求，直接安装最省心：

macOS：curl -fsSL https://claude.ai/install.sh | bash
Windows：irm https://claude.ai/install.ps1 | iex
Linux/WSL：curl -fsSL https://claude.ai/install.sh | bash

如果你已经在用 Node.js 管理开发工具，npm 安装也很自然：

1	npm install -g @anthropic-ai/claude-code

实际选择可以很简单：个人电脑优先直接安装；已有 Node.js 工具链或需要统一 npm 管理时，用 npm 安装；Windows 上做 Linux 项目时，优先 WSL。

参考

Anthropic 官方文档：Claude Code setup
npm 包：@anthropic-ai/claude-code