介绍在 macOS 系统（Monterey 及以上）上安装和配置 Claude Code 的完整流程。涵盖三种方式：通过 pip 安装 CLI 命令行工具、集成 VS Code 插件以及使用 Homebrew 一键安装。核心步骤包括安装 Python 依赖、获取并配置 Anthropic API Key，以及验证环境。文章还提供了常见问题排查指南及 Apple Silicon 芯片优化建议，帮助用户高效利用 Claude 进行代码生成与交互。
本文适配 macOS 12+（Monterey 及以上）系统，支持 Intel/Apple Silicon（M1/M2/M3）全机型，涵盖 Claude Code CLI 命令行、VS Code 插件两种核心使用方式的安装、配置与验证流程。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
通过 pip 安装官方 CLI 工具，支持终端直接执行编程交互、代码生成等操作。
# 1. 用 Homebrew 安装最新版 Python 3（推荐）
brew install python3
# 2. 验证 Python 版本（需 ≥3.8）
python3 --version
# 3. 升级 pip（避免安装失败）
pip3 install --upgrade pip
# 全局安装 anthropic-cli（Claude 官方 CLI 包）
pip3 install anthropic-cli
# 验证安装（输出版本号即成功）
anthropic --version
若终端提示命令未识别，需配置 Python 二进制文件路径到系统环境变量：
# 1. 查看 Python 包安装路径
pip3 show anthropic-cli | grep Location
# 2. 复制路径（示例：/Users/你的用户名/Library/Python/3.11/lib/python/site-packages）
# 3. 将路径添加到环境变量（根据终端类型选择命令）
# 若终端是 zsh（macOS 默认）
echo 'export PATH="$HOME/Library/Python/3.11/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 若终端是 bash
echo 'export PATH="$HOME/Library/Python/3.11/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
注：将命令中的「3.11」替换为你的 Python 实际版本（通过 python3 --version 查看）。
配置 API Key 后，CLI 工具才能正常调用 Claude 服务，支持临时配置和永久配置两种方式：
# 方式 1：临时配置（终端关闭后失效）
export ANTHROPIC_API_KEY="你的 Claude API Key"
# 方式 2：永久配置（推荐）
# zsh 终端
echo 'export ANTHROPIC_API_KEY="你的 Claude API Key"' >> ~/.zshrc
source ~/.zshrc
# bash 终端
echo 'export ANTHROPIC_API_KEY="你的 Claude API Key"' >> ~/.bash_profile
source ~/.bash_profile
# 验证配置（输出 API Key 即成功）
echo $ANTHROPIC_API_KEY
# 1. 进入编程交互模式（实时对话编程）
anthropic code
# 2. 直接提交编程需求（生成指定代码）
anthropic code "写一个 Python 爬虫，爬取豆瓣 Top250 电影列表，保存为 CSV 文件，包含异常处理"
# 3. 指定模型（推荐 Claude 3 Sonnet，平衡速度与效果）
anthropic code --model claude-3-sonnet-20240229 "优化这段 JavaScript 代码的性能：[粘贴你的代码]"
# 4. 读取本地文件并分析/修复
anthropic code --file ./main.py "分析这段代码的性能瓶颈，给出优化方案"
# 5. 生成 iOS SwiftUI 代码（适配 Apple 生态开发）
anthropic code "用 SwiftUI 写一个待办事项 APP，包含添加/删除/标记完成功能，适配深色模式"
通过 VS Code 插件实现可视化操作，支持右键生成/修复代码、侧边栏实时聊天，适配编程习惯。
Cmd + Shift + X）；Cmd + ,）；claude-3-sonnet-20240229（推荐）。若已安装 Homebrew，可通过官方源一键安装 Claude CLI，步骤更简洁：
# 1. 添加 Anthropic 官方 Homebrew 源
brew tap anthropic-ai/tap
# 2. 安装 Claude CLI
brew install claude-cli
# 3. 验证安装
claude --version
配置 API Key 方式与「方式一」一致，仅命令名从 anthropic 改为 claude，使用逻辑完全相同。
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 安装 pip 包时提示「Permission denied」权限错误 | 无全局安装权限 | 添加 --user 参数安装：pip3 install --user anthropic-cli |
| 配置 API Key 后仍提示「未授权」 | API Key 错误、过期，或账号无可用额度 | 1. 检查 API Key 是否完整（无空格/换行）；2. 登录 Anthropic 控制台确认账号有余额/免费额度；3. 重新创建并配置新的 API Key |
| VS Code 插件无响应，无法加载 Claude | 网络无法访问 Anthropic 服务器，或插件未重启生效 | 1. 检查网络环境（需可访问境外网络）；2. 重启 VS Code；3. 卸载并重新安装插件 |
| Apple Silicon 机型安装 Homebrew 后提示命令未识别 | 安装了 Intel 版本 Homebrew，与芯片不兼容 | 1. 卸载旧版 Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"2. 重新安装 ARM 版本 Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" |
| CLI 执行命令时提示「模型不存在」 | 模型名称错误，或版本号不匹配 | 使用官方支持的模型名称，推荐：claude-3-sonnet-20240229（代码生成首选）claude-3-opus-20240229（复杂任务） |
针对 M1/M2/M3 芯片机型，优化安装配置以提升性能：
# 1. 确认 Homebrew 是 ARM 版本（输出 /opt/homebrew 即正确）
brew --prefix
# 2. 重新安装适配 ARM 的 Python
brew reinstall python3
# 3. 配置 pip 优先安装 ARM 版本包
echo 'export PIP_NO_BINARY=:all:' >> ~/.zshrc
source ~/.zshrc
# 4. 重新安装 Claude CLI
pip3 install --user anthropic-cli
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online