小白速成！Claude Code 在 macOS 上的安装步骤与基础设置

一、准备工作

1. 系统要求

   • macOS 10.15 Catalina 或更高版本
   • 至少 8GB 内存
   • 15GB 可用存储空间

2. 安装必要工具
   打开终端执行：

   # 安装 Homebrew（包管理器）
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

二、安装 Claude Code

方法一：通过 Homebrew 安装（推荐）

# 添加专属仓库
brew tap claude-ai/tools

# 执行安装
brew install claude-code

方法二：手动安装

1. 访问官网下载页获取最新 .dmg 文件
2. 双击挂载镜像 → 将图标拖入 Applications 文件夹

三、基础配置

1. 初始化设置
   首次启动时按提示操作：

   # 生成配置文件
   claude-code init
   

   • 选择编程语言（Python/JavaScript 等）
   • 设置默认工作目录（建议 ~/Code）

2. 环境变量配置
   在 ~/.zshrc 添加：

   export PATH="/opt/claude-code/bin:$PATH"
   

   生效配置：

   source ~/.zshrc
   

四、验证安装

运行测试命令：

claude-code --version

成功输出示例：

Claude Code 2.3.1 (macOS-arm64)

五、常见问题解决

💡 效率技巧：
使用 claude-code autocomplete 启用命令自动补全，大幅提升操作效率！

六、进阶设置（可选）

1. 编辑器集成
   在 VS Code 安装官方插件：

   • 扩展商店搜索 Claude Assistant
   • 按提示关联本地安装路径

2. 自定义快捷键
   编辑 ~/.claude/config.yaml：

   keybindings:
     run_current_file: ⌘R   # 绑定运行当前文件
     suggest_code: ⌥␣       # 触发代码建议
   

完成所有步骤后，现在可以开始使用 Claude Code 高效编程啦！🎉