汪湜1. Claude 安装与配置全流程指南
作为 Anthropic 推出的新一代 AI 开发工具，Claude 正在成为开发者构建智能代理（AI Agent）的首选平台。不同于传统 AI 工具的单一问答模式，Claude 提供了完整的终端集成开发环境，让开发者可以直接在命令行中与 AI 协同工作。下面我将结合多次安装部署经验，详细介绍各平台下的安装方法及常见问题解决方案。
1.1 Windows 系统安装详解
Windows 用户需要通过 WSL（Windows Subsystem for Linux）来运行 Claude，因为其核心组件依赖 Linux 环境。以下是分步操作指南：
-
启用 WSL 功能：
powershell复制dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行后重启系统，然后在 PowerShell 中设置 WSL 2 为默认版本：
powershell复制wsl --set-default-version 2 -
安装 Linux 发行版：
推荐使用 Ubuntu 22.04 LTS，可通过 Microsoft Store 直接获取。安装完成后，首次启动会提示创建 UNIX 用户名和密码。 -
配置开发环境：
在 WSL 终端中执行：bash复制sudo apt update && sudo apt upgrade -y sudo apt install -y python3-pip git curl -
安装 Claude CLI：
bash复制
curl -sSL https://cli.claude.ai/install | bash安装完成后运行
claude --version验证，正常应显示类似claude 2.3.1的版本信息。
注意：若遇到 "Virtual machine platform not available" 错误，需进入 BIOS 启用 CPU 虚拟化支持（Intel VT-x 或 AMD-V）。部分品牌机需在电源管理中关闭 "内核隔离" 功能。
1.2 macOS 安装的特殊处理
macOS 由于 Unix 基础，安装过程更为简单，但需注意权限管理和 Rosetta 兼容层：
bash复制# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 添加 Claude 官方仓库
brew tap anthropic/tap
brew install claude
# 配置 API 密钥
echo 'export CLAUDE_API_KEY="your_key_here"' >> ~/.zshrc
source ~/.zshrc
若使用 M 系列芯片遇到架构问题，可尝试：
bash复制arch -x86_64 brew install claude
这会通过 Rosetta 2 转译运行，但性能会有约 15-20% 的损失。
1.3 国内用户的特殊配置
由于网络限制，国内用户可能需要额外配置：
-
通过镜像源安装依赖：
bash复制pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple -
设置终端代理（如有合法网络访问权限）：
bash复制export http_proxy=http://127.0.0.1:1087 export https_proxy=http://127.0.0.1:1087 -
如遇 "not available in your country" 提示，可尝试通过 Cloudflare Workers 搭建反向代理。
1.4 安装后验证与故障排除
完成安装后，建议运行诊断命令：
bash复制claude doctor
该命令会检查：
- 网络连通性（api.claude.ai）
- 计算资源（CPU/GPU 可用性）
- 依赖库版本（Python ≥3.8, PyTorch 等）
常见错误及解决方案：
| 错误现象 | 可能原因 | 解决方法 |
|---|