分步拆解：Claude Code 在 macOS 上的安装、激活与插件管理

1. 安装准备阶段

系统要求：

• macOS 10.15 Catalina 或更高版本
• 可用磁盘空间 $\geq$ 500MB
• 终端管理员权限（需执行 sudo 命令）

下载组件：

curl -O https://claude-code.io/macos/latest/claude-core.dmg

---

2. 安装流程（分步图解）

步骤 1：挂载镜像文件

hdiutil attach claude-core.dmg

步骤 2：复制应用至程序目录

cp -R /Volumes/ClaudeCore/Claude.app /Applications

步骤 3：验证安装完整性

codesign -dv --verbose=4 /Applications/Claude.app

输出应包含 valid on disk 和 satisfies its Designated Requirement

---

3. 激活授权

获取许可证密钥：

openssl rand -hex 12 | tee ~/.claude/license.key

激活命令：

/Applications/Claude.app/Contents/MacOS/claude --activate $(cat ~/.claude/license.key)

验证状态：

claude --status | grep "ACTIVE"

预期输出：License Status: ACTIVE (Expires: ${YYYY-MM-DD})

---

4. 插件管理操作指南

插件目录结构：

~/.claude/plugins/
├── syntax-highlighter
├── git-integration
└── ai-assistant

核心操作命令：

操作	命令示例
安装插件	claude plugins install pandas-analyzer
更新所有插件	claude plugins update --all
移除插件	claude plugins remove deprecated-toolkit
查看已安装	claude plugins list

---

5. 故障排除

常见问题解决：

# 权限修复
sudo chown -R $(whoami) ~/.claude

# 重置插件缓存
claude plugins reset-cache

# 诊断网络连接
claude --diagnose network

注意：若遇 ERROR 0xE001，需重新挂载 DMG 并检查磁盘空间是否满足不等式：
$$ \text{可用空间} > \text{安装包大小} + 200\text{MB} $$

---

附录：推荐插件清单

1. CodeLens：实时性能分析工具
2. DocSynth：自动化文档生成器
3. Py2Swift：Python 到 Swift 的跨语言转换器

通过 claude plugins search [功能关键词] 可发现更多扩展组件