官方一键安装脚本是最可靠的安装方式，支持 macOS、Linux 原生环境及 Windows WSL2，能自动处理架构检测和权限配置。
安装命令
在终端执行以下命令（无需提前下载任何文件）：
curl -fsSL https://claude.ai/install.sh | sh如遇到网络问题，可尝试使用镜像或代理：
# 使用代理（根据实际情况替换端口）
curl -fsSL https://claude.ai/install.sh -x http://127.0.0.1:7890 | sh安装过程详解
脚本执行时会自动完成以下操作（通常耗时 10-30 秒）：
- 系统检测：识别操作系统（macOS/Linux）和芯片架构（x86_64 或 ARM64）
- 下载二进制文件：从 AWS S3 拉取对应版本的
claude可执行文件（约 50-80 MB） - 选择安装位置：
- 优先尝试
/usr/local/bin/（系统级，所有用户可用） - 如无权限，自动降级到
$HOME/.local/bin/（用户级）
- 设置执行权限：
chmod +x确保文件可运行 - PATH 检测：检查安装目录是否已在系统 PATH 中，如未加入会给出提示
安装后配置
情况 A：安装在 /usr/local/bin/（有 sudo 权限时）
通常已默认在 PATH 中，直接可用：
claude --version
# 输出示例：claude 0.2.14情况 B：安装在 ~/.local/bin/（无 sudo 权限时）
需手动将目录加入 PATH（根据你的 shell 选择）：
# 对于 Zsh (macOS 默认)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 对于 Bash (Linux 默认)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# 对于 Fish
fish_add_path ~/.local/bin验证安装
执行以下三步确认安装成功：
# 1. 检查命令是否识别
which claude
# 应输出 /usr/local/bin/claude 或 /home/用户名/.local/bin/claude
# 2. 查看版本
claude --version
# 3. 测试启动（首次会提示输入 API Key，见 1.3 节）
claude常见问题处理
提示 "Permission denied"（curl 阶段）
说明当前目录无执行权限，改用用户级安装：
curl -fsSL https://claude.ai/install.sh | sh -s -- --install-dir ~/.local/bin提示 "claude: command not found"（安装后）
- 检查 PATH 是否生效：
echo $PATH | grep ".local/bin" - 如未生效，重新加载 shell 配置：
source ~/.zshrc（或.bashrc） - 或直接使用绝对路径运行：
~/.local/bin/claude
下载卡住或超时
- 检查网络连接：
curl -I https://claude.ai/install.sh应返回 HTTP 200 - 国内用户可能需要配置终端代理或更换 DNS
升级与卸载
# 升级（重新运行安装脚本即可，会自动覆盖）
curl -fsSL https://claude.ai/install.sh | sh
# 卸载（直接删除二进制文件）
rm $(which claude)
# 同时可删除配置缓存：rm -rf ~/.claude下一步
安装完成后，请确保已完成 1.3 节 的 API Key 配置，然后进入 3.4 节 进行首次启动验证。