Claude Code 安装与配置指南
本教程仅适用于 macOS 系统。
一、环境准备
1.1 检查 Node.js 环境
在终端中输入以下命令，检查 Node.js 是否已安装：
npm list -g --depth=0
预期结果：
- 显示已安装的全局包列表
- 或者显示空列表（这也是正常的）
如果提示"命令未找到"：
说明你的系统还没有安装 Node.js，请按照以下步骤操作：
- 访问 Node.js 官方文档或相关安装教程
- 根据教程完成 Node.js 的安装
- 安装完成后，重新执行上述检查命令
- 如果不再提示错误，说明安装成功
二、安装 Claude Code
2.1 执行安装命令
在终端中运行以下命令：
npm i -g @anthropic-ai/claude-code@latest
2.2 处理权限问题
如果遇到 "permission denied" 权限错误，请使用管理员权限安装：
sudo npm i -g @anthropic-ai/claude-code@latest
系统会提示你输入开机密码，输入后即可继续安装。
三、验证安装
3.1 测试安装状态
⚠️ 重要提示： 这一步骤必须执行！首次运行
claude命令后，系统会在用户目录下自动生成配置文件夹，这是后续配置的基础。
在终端中输入：
claude
成功标志：
- 出现交互界面
- 或显示选项让你进行选择
3.2 解决首次运行错误
首次安装时，可能会遇到类似下图的错误提示：
解决方法：
执行以下命令完成初始化配置：
jq '. + {"hasCompletedOnboarding": true}' ~/.claude.json > /tmp/tmp.json && mv /tmp/tmp.json ~/.claude.json
四、配置 Claude Code
4.1 打开配置目录
操作步骤：
- 在 Finder（访达）中按下快捷键：
Command + Shift + G - 按下回车键，进入配置目录
在弹出的对话框中输入以下路径：
~/.claude
