以下是在 macOS 系统上安装 Claude Code 的完整环境配置指南，包含关键依赖和版本选择建议：

一、核心依赖环境

1. Python 环境

   • 推荐版本：Python 3.8-3.10

     # 使用 Homebrew 安装
     brew install python@3.9
     

   • 验证安装：

     python3 --version  # 应输出 Python 3.x.x
     

2. 虚拟环境（必需）
   避免依赖冲突：

   python3 -m venv claude-env
   source claude-env/bin/activate
   

3. 开发工具链

   • Xcode Command Line Tools：

     xcode-select --install
     

   • Homebrew 包管理器：

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
     

二、关键软件包版本建议

注意：Apple Silicon (M1/M2) 用户需安装 PyTorch 的 macOS 专用版本：

pip3 install --pre torch -f https://download.pytorch.org/whl/nightly/cpu/torch_nightly.html

三、版本选择策略

1. 稳定版 vs 开发版

   • ✅ 生产环境：选择最新稳定版（如 v1.2.3）
   • ⚠️ 尝鲜功能：可用 nightly 版但需承担风险

   # 安装 nightly 版
   pip3 install claude-code --pre
   

2. CUDA 支持

   • Intel Mac：无需 CUDA
   • M1/M2 芯片：使用 Apple 的 Metal 加速

   import torch
   device = 'mps' if torch.backends.mps.is_available() else 'cpu'
   

四、环境验证脚本

创建 test_env.py：

import torch
from transformers import pipeline

print(f"PyTorch版本: {torch.__version__}")
print(f"MPS加速可用: {torch.backends.mps.is_available()}")

# 测试基础推理
generator = pipeline('text-generation', model='gpt2')
print(generator("Hello, Claude!", max_length=15)[0]['generated_text'])

运行：

python test_env.py

五、常见问题解决

1. 依赖冲突
   重建虚拟环境：

   deactivate
   rm -rf claude-env
   python3 -m venv new-env
   

2. 内存不足
   添加交换空间：

   sudo sysctl vm.swapusage=8GB
   

3. 安装中断
   使用国内镜像源：

   pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple [包名]
   

最后确认：

1. 终端执行 sysctl -n hw.memsize 确认内存 ≥16GB
2. 确保 macOS 版本 ≥ 12.3 (Monterey)
3. 在虚拟环境中执行 pip list 检查无版本冲突