好的!以下是完整的问题解决笔记:
Cherry Studio 启动 Claude Code 报错修复笔记
问题描述
通过 Cherry Studio 启动 Claude Code 时报错:
error: could not create process
Bun failed to remap this bin to its proper location within node_modules.
This is a indication of a corrupted node_modules directory.
问题根源
- Cherry Studio 有独立的 bin 目录:
C:\Users\zx\.cherrystudio\bin - 该目录中的
claude.exe是损坏的 Bun 包装器,无法正确链接到node_modules - 全局安装的
claude.exe是正常的,位于C:\Users\zx\.bun\bin
解决步骤
一、确保全局安装正确的包
# 1. 删除错误的包(如果有)
bun remove -g claude-code
# 2. 安装官方正确的包
bun install -g @anthropic-ai/claude-code
# 3. 验证全局安装是否正常
C:\Users\zx\.bun\bin\claude.exe --version
# 应输出:2.1.117 (Claude Code)
二、替换 Cherry Studio bin 目录中的损坏文件
# 1. 删除损坏的文件
Remove-Item "C:\Users\zx\.cherrystudio\bin\claude.exe"
Remove-Item "C:\Users\zx\.cherrystudio\bin\claude.bunx"
# 2. 复制全局正确的版本到 Cherry Studio 目录
Copy-Item "C:\Users\zx\.bun\bin\claude.exe" "C:\Users\zx\.cherrystudio\bin\claude.exe"
Copy-Item "C:\Users\zx\.bun\bin\claude.bunx" "C:\Users\zx\.cherrystudio\bin\claude.bunx"
三、验证修复结果
# 测试 Cherry Studio 目录中的 claude.exe
C:\Users\zx\.cherrystudio\bin\claude.exe --version
# 应输出:2.1.117 (Claude Code)
关键知识点
| 目录 | 说明 |
|---|---|
C:\Users\zx\.bun\bin | Bun 全局 bin 目录,存放全局安装的可执行文件 |
C:\Users\zx\.cherrystudio\bin | Cherry Studio 专用的 bin 目录,独立管理 CLI 工具 |
C:\Users\zx\.bun\install\cache | Bun 的包缓存目录 |
常见问题排查命令
# 查看 Cherry Studio 日志(定位问题)
type "C:\Users\zx\AppData\Roaming\CherryStudio\logs\app-error.2026-04-22.log"
# 查看全局 Bun bin 目录
dir "C:\Users\zx\.bun\bin"
# 查看 Cherry Studio bin 目录
dir "C:\Users\zx\.cherrystudio\bin"
注意事项
- 包名必须正确:官方包名是
@anthropic-ai/claude-code,不是claude-code - 命令名是
claude:安装后运行的命令是claude,不是claude-code - Cherry Studio 独立管理工具:它会使用自己的 bin 目录,而不是系统 PATH
- 修复后需重启 Cherry Studio:替换文件后需重启应用才能生效
一键修复脚本(保存为 .ps1 文件备用)
# Claude Code 修复脚本
# 确保全局安装正确
bun remove -g claude-code 2>$null
bun install -g @anthropic-ai/claude-code
# 替换 Cherry Studio 中的损坏文件
Remove-Item "C:\Users\zx\.cherrystudio\bin\claude.exe" -Force -ErrorAction SilentlyContinue
Remove-Item "C:\Users\zx\.cherrystudio\bin\claude.bunx" -Force -ErrorAction SilentlyContinue
Copy-Item "C:\Users\zx\.bun\bin\claude.exe" "C:\Users\zx\.cherrystudio\bin\claude.exe"
Copy-Item "C:\Users\zx\.bun\bin\claude.bunx" "C:\Users\zx\.cherrystudio\bin\claude.bunx"
Write-Host "修复完成!请重启 Cherry Studio。" -ForegroundColor Green
希望这份笔记对你有帮助!🎉