AI Agent / 系统课时

在 macOS 上安装

在 macOS 上安装

macOS 上可以使用官方原生安装器,也可以通过 Homebrew 管理。原生安装器是默认推荐路径并支持后台更新;Homebrew 更适合希望统一由包管理器维护软件的用户。本课完成安装、路径检查、启动和验证。

学习目标

  • 使用原生安装器完成 macOS 安装
  • 了解 Homebrew 稳定通道的替代方案
  • 处理 command not found 和路径问题

安装前检查

Claude Code 当前要求 macOS 13 或更高版本,并支持 x64 与 ARM64。先检查系统版本、架构、Git 和 curl:

bash
sw_vers -productVersion
uname -m
git --version
curl --version | head -n 1

预期输出应分别显示 13.0 或更高版本、arm64 或 x86_64、Git 版本和 curl 版本。实际小版本可能不同。

使用原生安装器

在 Terminal、iTerm2 等终端中执行:

bash
curl -fsSL https://claude.ai/install.sh | bash

预期结果是脚本以退出码 0 完成,并把 claude 启动器安装到当前用户目录。原生方式不需要把整个安装过程放在 sudo 下运行。关闭并重新打开终端,然后验证:

bash
command -v claude
claude --version
claude doctor

预期输出中的路径和版本会随安装变化。

text
/Users/<USER>/.local/bin/claude
<VERSION> (Claude Code)
诊断完成;未发现阻断启动的问题,或给出可操作的修复建议

claude doctor 是只读诊断,不会进入交互会话。它可检查安装健康、设置文件错误和更新状态。

使用 Homebrew 安装

已经使用 Homebrew 统一维护开发工具时,可安装稳定通道:

bash
brew install --cask claude-code

预期结果是 Homebrew 完成 cask 安装,随后 claude --version 能打印版本。

Homebrew 的 claude-code 默认跟踪较稳定的发布通道,不由 Claude Code 自身自动更新。后续应使用:

bash
brew upgrade claude-code

预期结果是包已升级,或 Homebrew 提示当前已经是可用的最新版本。

不要同时长期保留原生安装和 Homebrew 安装。若 command -v claude 指向意外位置,先确认 Shell 实际调用的是哪一份程序,再卸载重复来源。

处理 PATH 问题

原生安装完成后若出现 claude: command not found,先检查文件是否存在:

bash
ls -l "$HOME/.local/bin/claude"
printf '%s\n' "$PATH" | tr ':' '\n'

预期结果是第一条命令能看到启动器,第二条输出中包含 $HOME/.local/bin 对应的展开路径。

若路径未加载,可把下面一行加入 ~/.zshrc:

bash
export PATH="$HOME/.local/bin:$PATH"

这是 Shell 配置片段,保存后执行 source ~/.zshrc 或重新打开终端,再运行 claude --version 验证。若使用 Bash,应写入对应的 ~/.bashrc 或 ~/.bash_profile。

首次启动

进入一个测试项目目录并启动:

bash
cd <PROJECT_PATH>
claude

预期结果是进入交互会话;首次使用时会提示完成账号认证。<PROJECT_PATH> 替换为真实仓库路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在 macOS 上安装

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通