AI Agent / 系统课时
在 macOS 上安装
在 macOS 上安装
macOS 上可以使用官方原生安装器,也可以通过 Homebrew 管理。原生安装器是默认推荐路径并支持后台更新;Homebrew 更适合希望统一由包管理器维护软件的用户。本课完成安装、路径检查、启动和验证。
学习目标
- 使用原生安装器完成 macOS 安装
- 了解 Homebrew 稳定通道的替代方案
- 处理
command not found和路径问题
安装前检查
Claude Code 当前要求 macOS 13 或更高版本,并支持 x64 与 ARM64。先检查系统版本、架构、Git 和 curl:
sw_vers -productVersion
uname -m
git --version
curl --version | head -n 1预期输出应分别显示 13.0 或更高版本、arm64 或 x86_64、Git 版本和 curl 版本。实际小版本可能不同。
使用原生安装器
在 Terminal、iTerm2 等终端中执行:
curl -fsSL https://claude.ai/install.sh | bash预期结果是脚本以退出码 0 完成,并把 claude 启动器安装到当前用户目录。原生方式不需要把整个安装过程放在 sudo 下运行。关闭并重新打开终端,然后验证:
command -v claude
claude --version
claude doctor预期输出中的路径和版本会随安装变化。
/Users/<USER>/.local/bin/claude
<VERSION> (Claude Code)
诊断完成;未发现阻断启动的问题,或给出可操作的修复建议claude doctor 是只读诊断,不会进入交互会话。它可检查安装健康、设置文件错误和更新状态。
使用 Homebrew 安装
已经使用 Homebrew 统一维护开发工具时,可安装稳定通道:
brew install --cask claude-code预期结果是 Homebrew 完成 cask 安装,随后 claude --version 能打印版本。
Homebrew 的 claude-code 默认跟踪较稳定的发布通道,不由 Claude Code 自身自动更新。后续应使用:
brew upgrade claude-code预期结果是包已升级,或 Homebrew 提示当前已经是可用的最新版本。
不要同时长期保留原生安装和 Homebrew 安装。若 command -v claude 指向意外位置,先确认 Shell 实际调用的是哪一份程序,再卸载重复来源。
处理 PATH 问题
原生安装完成后若出现 claude: command not found,先检查文件是否存在:
ls -l "$HOME/.local/bin/claude"
printf '%s\n' "$PATH" | tr ':' '\n'预期结果是第一条命令能看到启动器,第二条输出中包含 $HOME/.local/bin 对应的展开路径。
若路径未加载,可把下面一行加入 ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"这是 Shell 配置片段,保存后执行 source ~/.zshrc 或重新打开终端,再运行 claude --version 验证。若使用 Bash,应写入对应的 ~/.bashrc 或 ~/.bash_profile。
首次启动
进入一个测试项目目录并启动:
cd <PROJECT_PATH>
claude预期结果是进入交互会话;首次使用时会提示完成账号认证。<PROJECT_PATH> 替换为真实仓库路径。