以下是在 macOS 系统上安装 Claude Code 的完整步骤及环境配置指南，涵盖常见问题解决方案：

一、环境准备

1. 系统要求

   • macOS 10.15 (Catalina) 或更高版本
   • 终端访问权限（Terminal）
   • 安装 Xcode 命令行工具：

     xcode-select --install
     

2. 安装 Homebrew（包管理器）

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

   • 验证安装：brew --version

二、Python 环境配置

1. 安装 Python 3.10+

   brew install python@3.10
   

   • 设置默认 Python 版本：

     echo 'export PATH="/usr/local/opt/python@3.10/bin:$PATH"' >> ~/.zshrc
     source ~/.zshrc
     

2. 创建虚拟环境（推荐）

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

三、安装 Claude Code

1. 通过 pip 安装

   pip install anthropic
   

2. 验证安装
   创建测试文件 test_claude.py：

   from anthropic import Anthropic
   client = Anthropic(api_key="YOUR_API_KEY")
   print(client.models.list())
   

   • 运行：python test_claude.py
   • 成功输出模型列表即安装完成

四、API 密钥配置

1. 获取密钥
   访问 Anthropic 控制台 创建 API Key

2. 环境变量配置

   echo 'export ANTHROPIC_API_KEY="your_api_key_here"' >> ~/.zshrc
   source ~/.zshrc
   

五、常见问题解决

六、进阶配置

1. VS Code 集成
   安装官方 Anthropic 扩展，在设置中添加 API Key

2. 代理设置（如需）

   import os
   os.environ["HTTP_PROXY"] = "http://127.0.0.1:7890"
   os.environ["HTTPS_PROXY"] = "http://127.0.0.1:7890"
   

重要提示：

• 定期更新包：pip install --upgrade anthropic
• 文档参考：Anthropic Official Docs
• 安全建议：勿将 API Key 提交至版本控制系统

按此流程操作后，即可在 macOS 上稳定运行 Claude Code 进行开发。遇到问题可查阅终端错误日志，通常包含详细解决方案线索。