Win11解决Cherry Studio 无法启动 Claude Code的问题

2 阅读2分钟

好的!以下是完整的问题解决笔记:


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.

问题根源

  1. Cherry Studio 有独立的 bin 目录C:\Users\zx\.cherrystudio\bin
  2. 该目录中的 claude.exe 是损坏的 Bun 包装器,无法正确链接到 node_modules
  3. 全局安装的 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\binBun 全局 bin 目录,存放全局安装的可执行文件
C:\Users\zx\.cherrystudio\binCherry Studio 专用的 bin 目录,独立管理 CLI 工具
C:\Users\zx\.bun\install\cacheBun 的包缓存目录

常见问题排查命令

# 查看 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"

注意事项

  1. 包名必须正确:官方包名是 @anthropic-ai/claude-code,不是 claude-code
  2. 命令名是 claude:安装后运行的命令是 claude,不是 claude-code
  3. Cherry Studio 独立管理工具:它会使用自己的 bin 目录,而不是系统 PATH
  4. 修复后需重启 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

希望这份笔记对你有帮助!🎉