Claude Cowork 工作空间启动失败排查与修复记录

环境信息

• 系统：macOS (Apple Silicon M5)
• Claude 版本：1.8555.2
• CCD (Claude Code Desktop) 版本：2.1.149
• 问题时间：2026-05-26

---

一、问题现象

在 Claude 桌面版中尝试使用 Cowork 模式（本地工作空间）时，遇到以下错误：

Failed to start Claude's workspace
Request error: net::ERR_CONNECTION_CLOSED
Restarting Claude or your computer sometimes resolves this.
If it persists, you can reinstall the workspace.

同时，任何需要调用 Bash 工具的操作都会返回：

Workspace still starting. The isolated Linux environment is booting in the background (usually 10–30 seconds). Try again shortly.

即使等待数分钟后，问题仍然存在。重启应用、重启电脑、重置工作空间均无法解决。

---

二、排查过程

2.1 查看日志定位问题

Claude 桌面版的日志位于以下目录：

• 主日志：~/Library/Logs/Claude/main.log
• VM 日志：~/Library/Logs/Claude/cowork_vm_node.log
• SSH 日志：~/Library/Logs/Claude/ssh.log
• Swift 层日志：~/Library/Logs/Claude/swift.log

通过分析 cowork_vm_node.log，发现关键错误：

[Bundle:status] rootfs.img missing
[VM] Loading @ant/claude-swift module...
[VM] Module loaded successfully
[Bundle:status] rootfs.img missing

日志显示 rootfs.img（VM 的根文件系统镜像）始终缺失，导致 Linux 工作空间无法启动。

2.2 分析 CCD Bundle 安装过程

在 main.log 中发现：

[CCD] Downloading bundle from https://downloads.claude.ai/claude-code-releases/2.1.149/darwin-arm64/claude.app.tar.zst
[CCD] Downloaded bundle: 43971827 bytes (expected: 43971827)
[CCD] Installed bundle at /Users/cyrene/Library/Application Support/Claude/claude-code/2.1.149

日志显示 CCD 声称安装成功，但实际检查该目录时：

ls ~/Library/Application\ Support/Claude/claude-code/2.1.149/
# 输出：No such file or directory

目录根本不存在！ 说明安装过程实际上失败了，但错误未被正确捕获。

2.3 进一步排查

检查 Caches 和应用支持目录：

ls -la ~/Library/Application\ Support/Claude/ | grep -E 'claude-code|cowork|vm'
# 无任何输出，确认 claude-code 目录不存在

find ~/Library/Caches -name "*.tar.zst" -o -name "claude*" 2>/dev/null
# 仅找到 claude-cli-nodejs 缓存，无 CCD bundle 缓存

磁盘空间充足（剩余 306GB），排除空间不足导致解压失败的可能。

---

三、根因分析

问题的根本原因是 CCD (Claude Code Desktop) bundle 的解压路径错误。

Claude 应用在下载完 claude.app.tar.zst 后，解压过程将内容放置在了错误的子目录中：

预期路径：
~/Library/Application Support/Claude/claude-code/2.1.149/Contents/MacOS/claude

实际路径（错误）：
~/Library/Application Support/Claude/claude-code/2.1.149/claude.app/Contents/MacOS/claude

VM 启动器在 2.1.149/ 根目录下寻找 rootfs.img 及相关文件，但由于文件被错误地套在了一层 claude.app/ 子目录中，导致：

1. rootfs.img 被判定为缺失
2. VM 无法启动
3. 工作空间连接失败（ERR_CONNECTION_CLOSED）

这是一个 Claude 桌面版 v1.8555.2 的已知 bug：安装流程在解压 .tar.zst 时没有正确处理内部目录结构，导致安装"成功"但路径错误。

---

四、解决方法

4.1 手动下载 CCD Bundle

由于应用内自动下载安装流程存在 bug，需要手动干预：

步骤 1：创建目标目录

mkdir -p ~/Library/Application\ Support/Claude/claude-code/2.1.149

步骤 2：下载 Bundle
由于终端下载可能被拦截，建议通过浏览器下载：

https://downloads.claude.ai/claude-code-releases/2.1.149/darwin-arm64/claude.app.tar.zst

文件大小约 213MB，下载后通常位于 ~/Downloads/。

4.2 解压并修正路径

步骤 3：解压文件

# 使用 zstd 解压（macOS 需先安装：brew install zstd）
zstd -d ~/Downloads/claude.app.tar.zst -o /tmp/claude.app.tar

# 再使用 tar 解压到目标目录
tar -xf /tmp/claude.app.tar -C ~/Library/Application\ Support/Claude/claude-code/2.1.149/

步骤 4：修正路径结构（关键！）

解压后会发现文件被放在了一个多余的 claude.app 子目录中：

2.1.149/
└── claude.app/
    └── Contents/
        └── MacOS/
            └── claude

需要将 claude.app 的内容提升到 2.1.149 根目录：

# 移动内容
mv ~/Library/Application\ Support/Claude/claude-code/2.1.149/claude.app/* \
   ~/Library/Application\ Support/Claude/claude-code/2.1.149/

# 删除空目录
rmdir ~/Library/Application\ Support/Claude/claude-code/2.1.149/claude.app

修正后的正确结构：

2.1.149/
└── Contents/
    ├── _CodeSignature/
    ├── MacOS/
    │   └── claude
    └── Info.plist

4.3 重启验证

步骤 5：重启 Claude 应用
完全退出 Claude（Cmd + Q），然后重新打开。

步骤 6：测试工作空间
创建新会话，执行任意 Bash 命令验证：

echo "Workspace connection test"

如果返回正常输出，说明工作空间已恢复。

---

五、清理临时文件

修复完成后，删除过程中产生的临时文件以释放磁盘空间（约 640MB）：

# 删除下载的压缩包
rm -f ~/Downloads/claude.app.tar.zst
rm -f /tmp/claude.app.tar.zst
rm -f /tmp/claude.app.tar

# 删除备份（如果之前创建了备份）
rm -rf ~/Library/Application\ Support/Claude/claude-code/2.1.149.backup

---

六、总结

项目	内容
问题	Cowork 工作空间无法启动，报 ERR_CONNECTION_CLOSED
根因	CCD Bundle 解压路径错误，rootfs.img 被放置在错误的子目录中
解决	手动下载 bundle → 解压 → 修正路径结构 → 重启应用
释放空间	清理临时文件后释放约 640MB

建议

1. 遇到工作空间启动失败时，首先检查日志定位真实原因，不要仅依赖重启。
2. 如果确认是 CCD 安装问题，可以手动下载并修正路径，这是最直接有效的方案。
3. 关注 Claude 版本更新，此问题在后续版本中可能已修复。

---

七、相关日志路径速查

# 主应用日志
~/Library/Logs/Claude/main.log

# VM / 工作空间日志
~/Library/Logs/Claude/cowork_vm_node.log

# SSH 连接日志
~/Library/Logs/Claude/ssh.log

# Swift 运行时日志
~/Library/Logs/Claude/swift.log

# CCD Bundle 安装目录
~/Library/Application\ Support/Claude/claude-code/

# 应用缓存
~/Library/Caches/claude-cli-nodejs/

---

如果本文对你有帮助，欢迎点赞收藏！如有其他 Claude Cowork 使用问题，欢迎在评论区交流。