Skip to content

macOS Intel Mac Claude Desktop 界面渲染异常:禁用 GPU Compositing 修复

问题

macOS Intel 机器上 Claude Desktop 出现以下渲染异常:

  • 打开侧边栏时,主内容区域被遮挡或裁剪(灰色空白覆盖)
  • 聊天输入框只显示一半
  • 页面布局错乱,内容无法正常查看

Apple Silicon (M 系列) Mac 通常不受影响,此问题集中在 Intel Mac 用户。

来源:GitHub Issue #48532

解决方案

根因: Intel Mac 的 GPU Compositing 渲染与 Electron 版本存在兼容问题,禁用 GPU 合成渲染即可解决。

方法 1:命令行临时启动(验证是否有效)

bash
/Applications/Claude.app/Contents/MacOS/Claude --disable-gpu-compositing

如界面恢复正常,可继续用方法 2 将其固化。

方法 2:创建 Automator 应用快捷方式(永久生效)

  1. 打开 Automator(在 Spotlight 搜索"Automator")
  2. 选择"应用程序"作为文稿类型
  3. 在操作列表中搜索"运行 Shell 脚本",拖入工作流
  4. 粘贴以下脚本:
bash
/Applications/Claude.app/Contents/MacOS/Claude --disable-gpu-compositing
  1. 存储为应用(Cmd+S),命名如 Claude Fixed,保存到"应用程序"文件夹
  2. 替换 Dock 中的图标:
    • 将旧的 Claude 图标从 Dock 拖走删除
    • 将新建的 Claude Fixed 应用拖入 Dock

可选:Get InfoCmd+I)将 Claude 官方图标复制到 Claude Fixed 应用,保持视觉一致。