首页 免费入门 进阶学习 工具实战 企业服务 我的学习

环境配置

Claude Code
Mac 安装与验证

使用 Anthropic 当前推荐的原生安装完成 Claude Code、登录与健康检查，再用只读小任务确认权限和项目路径都正确。

预计用时：约 30 分钟

工具专项 · 安装配置

先试读：Claude Code Mac 安装与首个验证任务

先看清当前官方安装路径与安全边界，再进入完整命令、健康检查和只读验收。

完整文章目录

  • 系统与账号前置检查
  • 原生安装与 Homebrew 二选一
  • claude doctor 健康检查
  • 首个只读项目验收

读完能做到什么

  • 只使用当前官方安装路径，不叠加旧方案
  • 知道怎样验证、排错和停止
  • 第一单从低风险、可回退任务开始
  • 不把密钥、真实数据或管理员权限当作默认输入

先照着做的验收动作

安装后先运行 claude --version 和 claude doctor；进入测试目录后，只读解释文件结构，不要修改、安装或删除任何内容。

完整文章包含当前安装命令、风险边界、故障排查和逐项验收。

这篇按 2026 年 7 月官方安装说明更新。
先安装，再验证；先只读，再允许修改。

1
确认系统与账号
↓
使用原生安装
↓
登录并运行健康检查
↓
完成第一个只读任务

第一步

开始前先确认三件事

避免安装成功后才发现系统、账号或项目不适合。

Claude Code 当前支持 macOS 13.0 及以上、x64 或 ARM64，建议至少 4GB 内存并保持联网。登录通常需要 Claude Pro、Max、Team、Enterprise 或 Console 账号；免费 Claude.ai 套餐不包含 Claude Code。

安装前检查
  • 打开“关于本机”，确认 macOS 版本与芯片架构
  • 确认要使用的账号具备 Claude Code 权限
  • 第一个测试项目使用副本或 Git 仓库，不在重要资料目录直接试
  • 不要把 API Key、密码或真实客户数据写进教程练习
唯一依据
Claude Code 官方 Advanced setup

第二步

选择一种官方安装方式

原生安装是官方推荐路径；Homebrew 适合已经用它管理软件的人。二选一，不要重复安装。

方案 A · 原生安装（推荐）
Terminal · 终端
curl -fsSL https://claude.ai/install.sh | bash
原生版本会自动更新。执行前确认域名是 claude.ai；不要从教程评论、网盘或陌生镜像复制安装脚本。
方案 B · Homebrew 稳定通道
Terminal · 终端
brew install --cask claude-code
Homebrew 版本默认不会像原生安装那样后台自动更新，需要定期运行 brew upgrade claude-code。不要再把 Node.js 和全局 npm 安装当作 Mac 新手的必经步骤。
不要用 sudo 解决安装问题。如果命令失败，先核对系统版本、网络、安装方式和官方故障说明。给全局包或网络脚本提升管理员权限，会放大错误脚本造成的影响。

第三步

验证、登录和健康检查

看到版本号只是第一关；健康检查和一次登录都通过才算安装完成。

Terminal · 逐条运行
claude --version claude doctor claude
版本检查

claude --version 能返回版本号，说明命令已进入 PATH。

健康检查

claude doctor 用来发现安装、配置或更新问题；不要看到命令能启动就跳过。

浏览器登录

运行 claude 后按官方提示完成认证。团队账号还要遵守管理员配置。

如果提示 command not found：先完全退出并重新打开终端；仍失败时回到官方安装故障页核对 PATH 和安装日志，不要连续叠加 npm、Homebrew、原生三套安装。

第四步

用一个只读任务验收

第一单不是让它改代码，而是证明它进入了正确目录、能读懂项目且不会越权。

准备：创建一个测试文件夹，放入 README 和一两个无敏感信息的样例文件；在终端先 cd 到该目录，再启动 claude。
只读查看当前目录，不要创建、修改、删除文件，也不要运行会改变系统状态的命令。请告诉我：1）有哪些文件；2）这个项目可能做什么；3）你依据了哪些文件；4）如果下一步要修改，你会先让我确认什么。

验收标准

可选

需要图形界面时再装 VS Code 扩展

终端安装与验证完成后，才增加编辑器集成，排错会更简单。

官方扩展
Claude Code for VS Code · Anthropic
确认发布者是 Anthropic。安装扩展不会替代账号权限和基础安装；如果终端尚未通过 claude doctor，先解决基础问题。

理解机制

为什么现在不必先装 Node.js

安装依赖变化后，排错思路也要跟着变。

当前官方原生安装把 Claude Code 作为平台原生程序放入用户路径，运行时不再依赖你手动维护 Node.js。npm 仍是可选的高级安装方式，但不是 Mac 新手的默认入口。

例如：原生安装后 claude --version 正常、node --version 不存在，并不代表 Claude Code 安装失败；真正应检查的是 claude doctor、登录状态和项目路径。

常见错误：看到 PATH 问题就再装一遍 Homebrew 或 npm，最后同一台机器出现多个版本。先确认 which claude 指向哪里，再决定是否需要修复安装。

Next Step

学完这篇，下一步这样走

先完成安装验证，再继续配置 Windows、Hermes Agent 或回到工具目录选择下一条工作流。

上一篇 Hermes Agent Mac 安装与模型方案选择 比较本地 Ollama、MiniMax API 和自定义 API 三种方案，并完成启动验证。 继续学习 -> 下一篇 Claude Code Windows 安装与 WSL 配置 从 WSL、Node、Claude Code 到登录验证，重点处理 Windows 用户最容易卡住的环境问题。 继续学习 -> 回到目录 返回工具专项首页 回到工具目录，按写作、查资料、做图、写代码等任务选择下一篇。 查看目录 ->
现在就练一下

安装后先做首个验证任务：让 Claude Code 只读当前文件夹，列出项目结构和下一步可执行命令，不要修改文件。