跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

macOS 安装 Claude Code 完整教程

综述由AI生成介绍在 macOS 系统（Monterey 及以上）上安装和配置 Claude Code 的完整流程。涵盖三种方式：通过 pip 安装 CLI 命令行工具、集成 VS Code 插件以及使用 Homebrew 一键安装。核心步骤包括安装 Python 依赖、获取并配置 Anthropic API Key，以及验证环境。文章还提供了常见问题排查指南及 Apple Silicon 芯片优化建议，帮助用户高效利用 Claude 进行代码生成与交互。

CloudNative发布于 2026/3/30更新于 2026/5/2432 浏览

macOS 安装 Claude Code 完整教程

本文适配 macOS 12+（Monterey 及以上）系统，支持 Intel/Apple Silicon（M1/M2/M3）全机型，涵盖 Claude Code CLI 命令行、VS Code 插件两种核心使用方式的安装、配置与验证流程。

一、前置准备（必做）

1.1 系统与环境要求

  • 系统版本：macOS 12.0+（Monterey、Ventura、Sonoma 均支持）
  • 硬件兼容：Intel 芯片、Apple Silicon（M1/M2/M3）芯片全机型
  • 基础依赖：Python 3.8+（CLI 方式必需）、网络环境（需可访问 Anthropic 服务器）

1.2 关键准备工作

  1. 安装 Homebrew（推荐，简化依赖安装） 打开「终端」（访达 → 应用程序 → 实用工具 → 终端），执行以下命令： 
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    安装过程中按提示输入电脑密码，等待完成即可。无 Homebrew 可跳过，后续采用手动安装方式。
  2. 获取 Claude API Key
    1. 访问 Anthropic 官网控制台，注册/登录账号；
    2. 进入「API Keys」页面，点击「Create API Key」创建密钥；
    3. 复制生成的 API Key 并保存（后续配置必需，请勿泄露）。

二、安装方式一：Claude Code CLI（命令行，推荐）

通过 pip 安装官方 CLI 工具，支持终端直接执行编程交互、代码生成等操作。

2.1 安装 Python 依赖

# 1. 用 Homebrew 安装最新版 Python 3（推荐）
brew install python3

# 2. 验证 Python 版本（需 ≥3.8）
python3 --version

# 3. 升级 pip（避免安装失败）
pip3 install --upgrade pip

2.2 安装 Claude Code CLI

# 全局安装 anthropic-cli（Claude 官方 CLI 包）
pip3 install anthropic-cli

# 验证安装（输出版本号即成功）
anthropic --version

2.3 解决「command not found: anthropic」问题

若终端提示命令未识别，需配置 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
 ~/.zshrc


  >> ~/.bash_profile
 ~/.bash_profile
source
# 若终端是 bash
echo
'export PATH="$HOME/Library/Python/3.11/bin:$PATH"'
source

注：将命令中的「3.11」替换为你的 Python 实际版本（通过 python3 --version 查看）。

2.4 配置 API Key（核心步骤）

配置 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

2.5 CLI 基础使用示例

# 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 插件集成（可视化使用，推荐）

通过 VS Code 插件实现可视化操作，支持右键生成/修复代码、侧边栏实时聊天，适配编程习惯。

3.1 安装 VS Code 插件

  1. 打开 VS Code（官网下载：https://code.visualstudio.com/Download）；
  2. 进入扩展商店（快捷键 Cmd + Shift + X）；
  3. 搜索「Claude AI」（Anthropic 官方出品，认准蓝色官方图标）；
  4. 点击「安装」，安装完成后重启 VS Code 生效。

3.2 配置插件 API Key

  1. 打开 VS Code 设置（快捷键 Cmd + ,）；
  2. 在搜索框输入「Claude API Key」；
  3. 在对应输入框粘贴你的 Claude API Key；
  4. （可选）设置默认模型：搜索「Claude Model」，选择 claude-3-sonnet-20240229（推荐）。

3.3 插件核心功能使用

  • 代码生成：右键编辑器空白处 → 选择「Claude: Generate Code」，输入编程需求；
  • 代码修复：选中报错/待优化代码 → 右键 → 选择「Claude: Fix Code」或「Claude: Optimize Code」；
  • 实时聊天编程：打开 VS Code 左侧边栏的「Claude」面板，直接输入需求对话；
  • 文件分析：拖拽本地代码文件到 Claude 面板，输入「分析这个文件的功能和潜在问题」。

四、安装方式三：Homebrew 一键安装（仅 CLI，简化版）

若已安装 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（复杂任务）

六、Apple Silicon 机型专属优化（可选）

针对 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

七、总结

  • 核心推荐：「CLI 命令行 + VS Code 插件」组合，兼顾终端高效操作与可视化编程；
  • 关键步骤：安装依赖 → 配置 API Key → 验证使用，API Key 是核心（需确保有效且未泄露）；
  • 适配要点：Intel/Apple Silicon 机型均支持，Apple 芯片需确保 Homebrew 为 ARM 版本；
  • 网络要求：需可访问 Anthropic 服务器，否则无法调用 Claude 服务。

目录

  1. macOS 安装 Claude Code 完整教程
  2. 一、前置准备（必做）
  3. 1.1 系统与环境要求
  4. 1.2 关键准备工作
  5. 二、安装方式一：Claude Code CLI（命令行，推荐）
  6. 2.1 安装 Python 依赖
  7. 1. 用 Homebrew 安装最新版 Python 3（推荐）
  8. 2. 验证 Python 版本（需 ≥3.8）
  9. 3. 升级 pip（避免安装失败）
  10. 2.2 安装 Claude Code CLI
  11. 全局安装 anthropic-cli（Claude 官方 CLI 包）
  12. 验证安装（输出版本号即成功）
  13. 2.3 解决「command not found: anthropic」问题
  14. 1. 查看 Python 包安装路径
  15. 2. 复制路径（示例：/Users/你的用户名/Library/Python/3.11/lib/python/site-packages）
  16. 3. 将路径添加到环境变量（根据终端类型选择命令）
  17. 若终端是 zsh（macOS 默认）
  18. 若终端是 bash
  19. 2.4 配置 API Key（核心步骤）
  20. 方式 1：临时配置（终端关闭后失效）
  21. 方式 2：永久配置（推荐）
  22. zsh 终端
  23. bash 终端
  24. 验证配置（输出 API Key 即成功）
  25. 2.5 CLI 基础使用示例
  26. 1. 进入编程交互模式（实时对话编程）
  27. 2. 直接提交编程需求（生成指定代码）
  28. 3. 指定模型（推荐 Claude 3 Sonnet，平衡速度与效果）
  29. 4. 读取本地文件并分析/修复
  30. 5. 生成 iOS SwiftUI 代码（适配 Apple 生态开发）
  31. 三、安装方式二：VS Code 插件集成（可视化使用，推荐）
  32. 3.1 安装 VS Code 插件
  33. 3.2 配置插件 API Key
  34. 3.3 插件核心功能使用
  35. 四、安装方式三：Homebrew 一键安装（仅 CLI，简化版）
  36. 1. 添加 Anthropic 官方 Homebrew 源
  37. 2. 安装 Claude CLI
  38. 3. 验证安装
  39. 五、常见问题排查
  40. 六、Apple Silicon 机型专属优化（可选）
  41. 1. 确认 Homebrew 是 ARM 版本（输出 /opt/homebrew 即正确）
  42. 2. 重新安装适配 ARM 的 Python
  43. 3. 配置 pip 优先安装 ARM 版本包
  44. 4. 重新安装 Claude CLI
  45. 七、总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • Python 将元组组成的列表转换为字典
  • IntelliJ IDEA 中安装 Python xlrd 模块
  • AI 无人机智慧巡检平台：20+ 场景智能识别与全流程管理
  • VLM Unlearning 技术路线论文梳理
  • OpenClaw 多机器人团队协作搭建指南
  • Flutter 组件 tavily_dart 在鸿蒙系统的适配与进阶应用
  • OpenHarmony与华为云IoT智能家居开发指南
  • Vivado 中实现 LVDS 串行通信的设计流程
  • 前端文件上传处理：提升用户体验与性能
  • XXHash64：非加密哈希算法的速度与架构解析
  • LangGraph 工具调用实战：实现 ReAct 搜索机器人
  • 转行Python的实践与思考
  • 多模态大模型 Llama 3.2 正式发布，支持视觉推理与边缘部署
  • Web 自动化测试入门：核心概念与 Selenium 实战指南
  • OpenClaw 接入飞书机器人与 Kimi K2.5 配置指南
  • LangChain Agent 基础入门：LLM 外部工具调用
  • 前端 PWA 技术详解：离线缓存与推送通知实现
  • 医疗大模型 LoRA 微调实战指南
  • 利用 DeepSeek 提升 Excel 数据处理效率指南
  • Cesium 无人机智能航线规划：航点动作组与 AI 识别

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online