Claude Code macOS 安装完整指南Homebrew、原生脚本与常见问题解决Claude Code macOS 完整安装教程原生 curl 脚本、Homebrew cask 两种方式PATH 配置、OAuth 登录、Xcode 依赖、M1/M2/M3 芯片兼容性、dyld 报错修复以及 VS Code 和 iTerm2 集成配置。2026/3/153分钟 阅读ClaudeEaglemacOS 是 Claude Code 体验最好的平台Terminal.app、iTerm2 都完美支持。本文覆盖从安装到第一次运行的全流程包含 Apple SiliconM 系列的注意事项。前提要求macOS 12 Monterey 及以上有 claude.com 账号免费或订阅终端 appTerminal、iTerm2 均可方式一原生脚本安装推荐curl-fsSLhttps://claude.ai/install.sh|bash安装后重新加载 shell 配置source~/.zshrc# 大多数 macOS 用 zsh# 或source~/.bash_profile# 如果你用 bash验证安装claude--versionwhichclaude# 应该显示 /Users/你的用户名/.local/bin/claude优点自动后台更新始终保持最新版本。方式二Homebrew 安装如果你已经用 Homebrew 管理工具链brewinstall--caskclaude-code升级brew upgrade claude-code注意Homebrew 安装不自动更新需要手动运行升级命令。建议把brew upgrade claude-code加入定期维护习惯。登录claude /login会自动打开默认浏览器在 claude.com 授权后回到终端即登录成功。企业/服务器环境用 API Key 登录跳过浏览器exportANTHROPIC_API_KEYsk-ant-你的key# 加到 ~/.zshrc 永久生效echoexport ANTHROPIC_API_KEYsk-ant-你的key~/.zshrc第一次使用# 进入你的项目目录cd~/projects/your-project# 启动claudeApple SiliconM1/M2/M3特别说明Claude Code 原生支持 Apple Silicon不需要 Rosetta。如果遇到dyld相关错误# 方法 1移除隔离属性xattr-dcom.apple.quarantine$(whichclaude)# 方法 2在「系统设置 - 隐私与安全」里点击「仍要打开」# 方法 3重新安装通常能解决大多数问题curl-fsSLhttps://claude.ai/install.sh|bashPATH 问题排查如果安装后command not found: claude# 检查安装位置ls-la~/.local/bin/claude# 检查 PATHecho$PATH|tr:\n|greplocal# 手动添加到 zshechoexport PATH$HOME/.local/bin:$PATH~/.zshrcsource~/.zshrcXcode Command Line Tools部分功能依赖 Git确保已安装xcode-select--install# 或检查是否已安装git--versionVS Code 集成# 安装 Claude Code 扩展code --install-extension anthropic.claude-code# 或在 VS Code 里 CmdShiftX 搜索 Claude Code安装后在 VS Code 的内置终端里运行claude侧边栏会出现 Claude Code 面板。iTerm2 推荐配置Claude Code 在 iTerm2 里体验最佳推荐开启自然文本编辑Preferences - Profiles - Keys - Presets - Natural Text Editing字体Cascadia Code 或 JetBrains Mono等宽字体代码显示更清晰主题One Dark 或 Dracula深色背景减少眼睛疲劳更新和卸载# 手动更新原生安装自动更新Homebrew 需要手动brew upgrade claude-code# 卸载# 原生安装rm-rf~/.local/bin/claude ~/.claude# Homebrewbrew uninstall--caskclaude-code常见问题Q安装报 “Permission denied”不要用 sudo脚本安装到用户目录~/.local/bin/不需要 root 权限。Q每次打开终端都要重新登录登录状态存储在~/.claude/auth.json如果丢失需要重新/login。检查这个文件是否存在。QClaude Code 版本很旧怎么强制更新curl-fsSLhttps://claude.ai/install.sh|bash# 原生安装会自动覆盖旧版本