Windows / Mac 安装 Claude Code 完整步骤

按 Anthropic 官方文档整理 · 2026 年 11 月更新 · 命令如有变化以官方文档为准

Claude Code 是 Anthropic 推出的命令行编程助手，能直接读懂你的项目、改代码、跑命令。下面是从零装好它的完整流程。

一、先确认这几件事

• 系统：macOS 13 以上；Windows 10（1809 以上）或 Windows 11；Ubuntu 20.04+ / Debian 10+ 等。
• 配置：4 GB 以上内存，x64 或 ARM64 处理器。
• 账号：需要 Claude 的 Pro、Max、Team、Enterprise 订阅或 Console（API）账号，免费版不能用 Claude Code。
• 地区：需要身处 Anthropic 官方支持的国家和地区。

二、Windows 安装

按 Win 键搜索“PowerShell”并打开（不需要管理员权限），粘贴下面这行，回车：

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

如果你打开的是“命令提示符”（CMD，提示符前面没有 PS），用这行：

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

安装过程中没有进度条，看起来像卡住了，耐心等它结束即可。

建议再装 Git for Windows：到 git-scm.com 下载安装，一路默认即可。装了以后 Claude Code 可以使用 Git Bash 执行命令，兼容性更好；不装也能用（会改用 PowerShell）。

三、Mac / Linux 安装

打开“终端”（Mac 按 Command + 空格 搜索“终端”），粘贴：

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

习惯用 Homebrew 的 Mac 用户也可以：

brew install --cask claude-code

Homebrew 版不会自动更新，需要定期运行 brew upgrade claude-code；用上面官方脚本装的会在后台自动更新。

四、验证安装

关掉终端，重新打开一个新窗口，输入：

claude --version

显示版本号（例如 2.1.x (Claude Code)）就说明装好了。想做更全面的检查：

claude doctor

五、第一次登录

进入你的项目文件夹，输入 claude 回车，按提示在浏览器里登录你的 Claude 账号，回到终端就能开始对话了：

cd 你的项目文件夹
claude

六、常见报错

• 提示 claude 不是内部或外部命令 / command not found：先关掉终端重新打开；还不行，说明安装目录没加进 PATH，参考官方安装排错文档。
• 提示 The token '&&' is not a valid statement separator：你在 PowerShell 里用了 CMD 的命令，换成第二节第一行命令。
• 提示 'irm' is not recognized：你在 CMD 里用了 PowerShell 的命令，换成 CMD 那一行。
• 安装时报 403 或 syntax error near unexpected token '<'：通常是网络或所在地区的问题，确认网络正常、身处官方支持地区后重试。
• 登录后提示没有权限：检查账号是否为付费订阅，免费版不包含 Claude Code。

七、更新与卸载

官方脚本安装的会自动更新，也可以手动运行 claude update。卸载方法见官方说明。