Claude Code CLI 安装教程：macOS 和 Windows 完整指南

Claude Code CLI 是 Anthropic 的命令行开发工具，可以在终端里启动 Claude，让它阅读代码、解释报错、修改文件和协助完成开发任务。本文直接整理可复制的安装命令，覆盖 macOS、Windows PowerShell、Windows CMD、WSL、Homebrew、WinGet 和 npm。

以下命令根据 Claude Code 官方安装文档整理。安装脚本和包管理器命令可能会更新，执行前建议确认你访问的是官方域名 claude.ai、claude.com 或 Anthropic 官方文档。

安装前确认

账号：Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账号；免费 Claude.ai 账号通常不能直接使用 Claude Code。如果创建账号遇到问题：如无信用卡、封号等，也可以了解 YYLX.IO 鱼鱼连线 这类 AI 中转站访问 Claude Code。

Windows：Windows 原生使用时，建议安装 Git for Windows，方便 Claude Code 调用 Git Bash。

Node.js：如果选择 npm 安装，需要 Node.js 18 或更高版本。

安全：不要从不明 SEO 下载站复制安装命令，尤其不要运行来源不清的 PowerShell 脚本。

方法一：官方 Native Install，推荐

官方推荐的 native install 会安装 Claude Code 原生命令行程序，并支持后台自动更新。macOS、Linux 和 WSL 使用下面这条命令：

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

Windows PowerShell 使用下面这条命令。注意提示符应类似 PS C:\，不要在 CMD 里运行这条 PowerShell 命令：

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

Windows CMD 使用下面这条命令。注意提示符通常是 C:\，不是 PS C:\：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装完成后，关闭并重新打开终端，再执行验证命令：

claude --version
claude doctor

一般用户直接使用上面的默认安装命令即可。除非官方文档特别要求切换版本通道，否则不建议在教程里额外传递安装参数。

方法二：macOS 用 Homebrew 安装

如果你习惯用 Homebrew 管理工具，可以安装 stable cask：

brew install --cask claude-code

Homebrew 安装不会由 Claude Code 自动后台更新，需要手动升级：

brew upgrade claude-code

卸载命令：

brew uninstall --cask claude-code

方法三：Windows 用 WinGet 安装

Windows 用户也可以用 WinGet 安装：

winget install Anthropic.ClaudeCode

WinGet 安装同样需要手动升级：

winget upgrade Anthropic.ClaudeCode

卸载命令：

winget uninstall Anthropic.ClaudeCode

方法四：npm 安装，适合 Node.js 用户

如果你已经安装 Node.js 18+，也可以用 npm 全局安装：

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

升级 npm 安装版本时，官方建议使用：

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

卸载命令：

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

不建议使用 sudo npm install -g，因为它容易带来权限和安全问题。如果全局安装目录不可写，优先修复 npm 目录权限，或使用 nvm 重新安装 Node.js。

Windows 原生还是 WSL？

如果你的项目在 Windows 文件系统里，比如 C:\Users\Yu\project，可以用 Windows 原生安装。如果你的项目主要在 Linux 工具链里，比如 Docker、Ubuntu、Python、Node.js、Rust 开发环境，建议在 WSL 里安装。

WSL 里不要运行 Windows PowerShell 安装命令，而是打开 WSL 终端，使用 Linux/macOS 这条命令：

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

首次启动和登录

安装完成后，在你要处理的项目目录里运行：

claude

首次运行会引导你登录或选择账号类型。登录完成后，可以先让它做一个低风险测试，例如总结项目结构：

claude
> summarize this project

国内网络环境下怎么装

如果官方安装脚本下载失败，先判断失败点。如果是 claude.ai/install.sh、install.ps1 或 install.cmd 访问失败，说明官方下载源连接不稳定，需要换网络环境后再试。

如果你走 npm 安装，且只是 npm registry 慢，可以临时使用镜像源：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

但要注意：npm 镜像只能解决下载 npm 包慢的问题，不能解决 Claude Code 登录、账号权限或 Claude 服务访问问题。命令装好了不代表服务一定能连通。

如果命令已经安装成功，但运行 claude 时登录失败、请求超时或服务连接不稳定，问题通常不在安装命令，而在网络访问链路。你可以先换一个稳定网络环境，也可以了解 YYLX.IO 鱼鱼连线 这类 AI 中转站，用来改善 Claude、OpenAI、Gemini 等服务的访问稳定性。

常见报错

claude: command not found

关闭并重新打开终端后再试。如果仍然失败，检查 ~/.local/bin 是否在 PATH 中。npm 安装用户还要检查 npm 全局 bin 目录是否在 PATH 中。

PowerShell 提示 && 不是有效语句分隔符

你把 CMD 命令放到 PowerShell 里执行了。PowerShell 请使用 irm https://claude.ai/install.ps1 | iex。

CMD 提示 irm 不是内部或外部命令

你把 PowerShell 命令放到 CMD 里执行了。CMD 请使用 install.cmd 那条命令，或者切换到 PowerShell。

登录后仍然不能使用

先确认你的账号类型是否支持 Claude Code。官方文档说明 Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账号。

总结

第一次安装 Claude Code CLI，优先选择官方 native install：macOS、Linux、WSL 使用 curl -fsSL https://claude.ai/install.sh | bash，Windows PowerShell 使用 irm https://claude.ai/install.ps1 | iex，Windows CMD 使用 install.cmd。如果你习惯包管理器，再考虑 Homebrew、WinGet 或 npm。

安装完成后一定执行 claude --version 和 claude doctor。这一步能帮你区分“命令没装好”“PATH 没生效”“账号没权限”和“网络无法访问服务”这几类完全不同的问题。

如果你正在搭建 AI 开发环境，希望 Claude、ChatGPT、Gemini、Codex 等工具访问更稳定，可以看看 YYLX.IO 鱼鱼连线。它更适合需要长期使用 AI 工具，但经常遇到网络不稳定的开发者。