macOS 安装 Claude Code 后无法启动的排查与修复
在 macOS 系统中，Claude Code 无法启动通常由权限错误、依赖缺失或系统兼容性问题引起。以下是三种快速排查与修复方法。
方法 1: 检查并修复应用权限
在 macOS 中，如果应用缺少执行权限，会导致无法启动。这可能是由于安全设置或手动安装引起。
- 打开终端：通过 Spotlight 搜索'终端'并打开。
修复权限：使用 chmod 命令添加执行权限：
chmod +x /Applications/ClaudeCode.app/Contents/MacOS/ClaudeCode
完成后，尝试重新启动应用。如果问题依旧，进入方法 2。
验证权限：使用 ls -l 命令检查应用文件权限。例如，如果 Claude Code 安装在 /Applications/ClaudeCode.app，运行：
ls -l /Applications/ClaudeCode.app
输出中应包含 drwxr-xr-x（表示可执行权限）。如果缺少，继续下一步。
方法 2: 检查并安装缺失依赖
Claude Code 可能依赖特定库或框架（如 Xcode Command Line Tools）。如果未安装，启动会失败。
更新 Homebrew（如使用）：如果 Claude Code 通过 Homebrew 安装，运行：
brew update && brew upgrade
然后重启应用。如果仍无法启动，进入方法 3。
安装必要工具：确保 Xcode Command Line Tools 已安装：
xcode-select --install
同意提示并等待安装完成。
检查依赖：在终端运行以下命令，查看错误日志（通常存储在系统日志中）：
log show --predicate 'process == "ClaudeCode"' --last 10m
查找类似 dyld: Library not loaded 的错误，指出缺失的库。
方法 3: 重新安装或重置应用
缓存损坏或安装不完整是常见原因。重新安装前，先清除临时文件。
- 卸载并重新安装：
- 重新下载官方安装包，运行安装程序。
检查系统兼容性：确保 macOS 版本支持 Claude Code。查看官方文档要求（如需要 macOS 12.0+），并更新系统：
softwareupdate -i -a
如果通过包管理器（如 Homebrew），运行：
brew uninstall claudecode && brew install claudecode
如果通过安装包安装，先卸载：
sudo rm -rf /Applications/ClaudeCode.app
