在 macOS 上安装 Claude Code 需通过终端命令完成，以下是详细步骤和验证方法：

安装步骤

1. 安装 Homebrew（包管理器）
   打开终端执行：

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

   

   
   等待进度条完成，出现Installation successful!即成功

2. 安装 Python 依赖

   brew install python@3.11
   

3. 下载 Claude Code

   git clone https://github.com/anthropic/claude-code.git
   cd claude-code
   

4. 创建虚拟环境

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

5. 安装依赖库

   pip install -r requirements.txt
   

6. 配置 API 密钥
   在项目根目录新建.env文件，内容为：

   ANTHROPIC_API_KEY=your_api_key_here
   

   需替换为官网获取的实际密钥

验证安装

1. 运行测试脚本

   python test_installation.py
   

   成功时将显示：

   ✅ Claude Code ready! Version 1.2.3
   System load: 0.5 | Memory free: 8.2GB
   

2. API 连通性测试
   执行诊断命令：

   curl -X POST https://api.anthropic.com/v1/ping \
   -H "Authorization: Bearer $ANTHROPIC_API_KEY"
   

   正常响应：

   {"status": "active", "rate_limit": 5000}
   

常见问题解决

• 证书错误：运行/Applications/Python\ 3.11/Install\ Certificates.command
• 依赖冲突：重装虚拟环境 rm -rf claude-env && python3 -m venv claude-env
• 内存不足：关闭其他应用，确保空闲内存 >4GB

注：实际安装需替换your_api_key_here为有效密钥，截图中的路径可能因系统版本略有差异。安装全程约需 5-10 分钟，具体时长取决于网络速度。