人人都会AI编程

2.1 终端 CLI 版本安装

更新时间：2026-06-28

CLI 版本是 Claude Code 的核心形态，功能最全且资源占用最低。安装前请确认已完成第 1.2 节的环境检查和第 1.3 节的 API Key 准备。

2.1.1 官方原生脚本安装（推荐）

适用所有支持的平台（macOS、Linux、WSL2），自动检测系统架构并完成配置。

# 在终端执行（macOS/Linux/WSL2 通用）
curl -fsSL https://claude.ai/install.sh | sh

脚本执行流程：

  1. 检测系统架构（x86_64/ARM64）
  2. 下载对应二进制文件到 ~/.local/bin/claude
  3. 如目录不在 PATH 中，自动提示添加环境变量
  4. 验证安装并显示版本号

权限问题处理：
若提示 Permission denied，说明 /usr/local/bin 需要管理员权限，改用以下命令：

curl -fsSL https://claude.ai/install.sh | sudo sh
# 或安装到用户目录（无需 sudo）
curl -fsSL https://claude.ai/install.sh | sh -s -- --install-dir ~/.local/bin

2.1.2 npm 全局安装方式

适合已配置 Node.js 开发环境的用户，便于版本管理。

# 要求 Node.js 18.x 或 20.x（见 1.2 节）
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

优缺点：

  • ✅ 与现有 Node 工具链统一管理，便于更新（npm update -g）
  • ❌ 可能受 npm 镜像源影响下载速度，且全局安装需注意权限（macOS/Linux 建议使用 nvm 避免 sudo）

2.1.3 macOS Homebrew 安装

适合习惯使用 Homebrew 管理工具链的 macOS 用户。

# 添加官方 Tap（首次使用需执行）
brew tap anthropic-ai/claude-code

# 安装
brew install claude-code

# 更新
brew upgrade claude-code

注意事项：

  • Homebrew 版本可能略滞后于官方脚本（通常延迟 1-3 天）
  • Apple Silicon 用户无需额外配置，Homebrew 会自动选择 ARM64 版本

2.1.4 Windows 平台安装步骤

前置要求：必须在 WSL2（Windows Subsystem for Linux）内安装，不支持 PowerShell 或 CMD。

安装流程：

  1. 确保 WSL2 已启用并安装 Ubuntu（见 1.1 节）
  2. 在 WSL2 终端内执行与 Linux 相同的命令：
# 在 WSL2 Ubuntu 终端中执行
curl -fsSL https://claude.ai/install.sh | sh

# 或 npm 方式
npm install -g @anthropic-ai/claude-code

Windows 文件系统访问：

  • 访问 Windows 盘符（如 D 盘项目）：cd /mnt/d/你的项目
  • 建议在 WSL2 用户主目录（~/）下创建项目软链接，避免路径混淆

2.1.5 Linux 平台安装步骤

Ubuntu/Debian：

# 方式1：官方脚本（推荐）
curl -fsSL https://claude.ai/install.sh | sh

# 方式2：npm（需先安装 Node.js）
sudo apt update
sudo apt install -y nodejs npm
npm install -g @anthropic-ai/claude-code

Fedora/CentOS/RHEL：

# 官方脚本通用，或手动下载
curl -fsSL https://claude.ai/install.sh | sh

# 如遇依赖缺失
sudo dnf install -y curl git nodejs  # Fedora
sudo yum install -y curl git nodejs  # CentOS

Arch Linux：
官方暂未提供 Pacman 包，请使用官方脚本或 npm 安装。

安装验证与首次启动

无论采用哪种方式，安装完成后执行：

# 1. 检查版本（应显示类似 claude 0.x.x）
claude --version

# 2. 验证 API Key 配置（如未设置会提示输入）
claude

# 3. 测试进入项目目录后启动
cd /path/to/your/project
claude

首次启动提示：

  • 如看到 Please set your ANTHROPIC_API_KEY，请返回 1.3 节配置环境变量
  • 首次进入项目时，Claude 会自动创建 .claude/ 缓存目录，无需手动干预

故障排查：

  • command not found：检查 ~/.local/bin 是否已加入 PATH（echo $PATH），或尝试重新加载 shell 配置（source ~/.bashrc 或 source ~/.zshrc）
  • Architecture not supported：确认系统为 64 位（uname -m 应显示 x86_64 或 aarch64）