目录一、环境说明二、错误一Host Claude Code binary not available1. 先确认命令行版本是否可用2. 查看 Desktop 下载日志3. 推荐修复方法三、错误二同时打开桌面端后CLI 思考明显变慢1. 检查 Claude Desktop 是否在后台下载2. 其他可能原因3. 处理办法四、如何查看 Cowork 虚拟机镜像下载进度五、错误三VM service not running1. 查看相关服务2. 查看服务退出码3. 查看详细服务日志4. 启动 Cowork 服务六、常用的一键诊断命令七、最终排障顺序最近我在 Windows 上折腾 Claude Code、Claude Desktop、DeepSeek 和 Cowork连续遇到了几个看起来毫无关系的问题Claude Desktop 提示Host Claude Code binary not available同时打开 CLI 和桌面端后CLI 一直处于思考状态Cowork 后台下载了一个 2GB 多的虚拟机镜像镜像下载完成后又提示VM service not running这些问题容易被混在一起但实际上分别属于四层DeepSeek API ↑ Claude Code CLI ↑ Claude Desktop ↑ Cowork Windows VM 服务本文记录完整的诊断和修复过程。相关版本、路径会随安装方式变化执行命令时请以自己的环境为准。一、环境说明本次排查环境操作系统Windows Claude Code2.1.x Claude DesktopMicrosoft Store/MSIX 版本 模型服务DeepSeek Anthropic 兼容接口 终端PowerShellClaude Code 的用户配置通常位于:%USERPROFILE%\.claude\settings.json配置示例{ env: { ANTHROPIC_AUTH_TOKEN: 你的 API Key, ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_MODEL: 你的模型名称, API_TIMEOUT_MS: 300000 } }注意不要把真实 API Key 发到论坛、截图或提交到 Git。模型名称取决于你的 DeepSeek 服务或中转平台不要照抄别人的名称。API_TIMEOUT_MS建议先设置为 5 分钟即300000。设置成几十分钟会让连接故障表现为一直思考。二、错误一Host Claude Code binary not availableClaude Desktop 中出现Host Claude Code binary not available. Check that the download completed.这个提示很容易让人误以为是 DeepSeek 接口出错。实际上消息还没有发送到 DeepSeekClaude Desktop 自己需要的 Claude Code 二进制文件没有准备完成。1. 先确认命令行版本是否可用Get-Command claude where.exe claude claude --version如果 PowerShell 因执行策略拦截claude.ps1可以直接运行claude.cmd --version或者使用完整路径 你的 Claude Code 安装目录\claude.cmd --version需要注意终端中的 Claude Code 能运行并不代表 Claude Desktop 的组件已经就绪。Desktop 会维护自己的版本和缓存不一定直接使用 PATH 中的 CLI。2. 查看 Desktop 下载日志Claude Desktop 第三方模式的日志通常位于%LOCALAPPDATA%\Claude-3p\logs\main.log搜索关键错误Select-String -Path $env:LOCALAPPDATA\Claude-3p\logs\main.log -Pattern Claude Code binary|Downloading|checksum|ERR_NETWORK|All download attempts failed本次遇到的真实错误包括net::ERR_NETWORK_CHANGED net::ERR_CONNECTION_CLOSED Checksum mismatch All download attempts failed根因不是 DeepSeek而是 Claude Desktop 从downloads.claude.ai下载组件时代理节点切换、连接中断或文件只下载了一部分最终导致校验失败。3. 推荐修复方法先彻底退出 Claude Desktop包括系统托盘中的后台进程然后确保downloads.claude.ai能通过稳定网络访问。使用代理时固定节点暂时关闭自动选择和自动切换。重新打开 Claude Desktop让它重新下载。不要在下载过程中反复退出或切换网络。如果对应版本目录是空的可以在完全退出 Claude Desktop 后删除这个空目录再让 Desktop 重建$root $env:LOCALAPPDATA\Claude-3p\claude-code Get-ChildItem $root确认目标版本后再删除避免误删其他文件Remove-Item $root\版本号 -Recurse -Force不要直接复制别人的claude.exe。版本、签名和校验标记不一致时Desktop 仍可能拒绝启动。三、错误二同时打开桌面端后CLI 思考明显变慢当时 CLI 的表现是Misting... (2m 9s) 输入 Token0 输出 Token0这里有个很重要的判断方法如果等待了很久但输入、输出 Token 仍然都是 0通常不是模型已经开始深度推理而是请求还在以下某一层等待DNS / 网络连接 代理队列 TLS 建连 服务端限流 等待首个响应1. 检查 Claude Desktop 是否在后台下载本次问题的主要原因是 Claude Desktop 正在下载 Cowork 虚拟机镜像总大小约 2233.9 MB 平均速度约 1.2 MB/s它占用了网络带宽和代理连接CLI 同时访问 DeepSeek 时首个响应时间就会明显变长。可以用下面的命令查看实时日志Get-Content $env:LOCALAPPDATA\Claude-3p\logs\main.log -Tail 20 -Wait | Select-String download.*%如果看到持续增长的百分比、下载速度和 ETA就说明桌面端仍在下载。2. 其他可能原因如果没有后台下载还要检查CLI 和 Desktop 是否共用同一个 API Key服务商是否限制同一 Key 的并发数代理软件是否限制单连接或总带宽是否频繁切换代理节点API_TIMEOUT_MS是否设置得过大当前模型是否本来就有较长的推理时间3. 处理办法最简单的验证方法是完全退出 Claude Desktop。重新启动 Claude Code CLI。用相同问题测试首字响应速度。如果速度立即恢复基本可以确认是 Desktop 下载或并发占用造成的。不希望关闭 Desktop 时可以等待镜像下载完成或者给downloads.claude.ai和 DeepSeek API 分配不同代理策略。四、如何查看 Cowork 虚拟机镜像下载进度实时查看Get-Content $env:LOCALAPPDATA\Claude-3p\logs\main.log -Tail 20 -Wait | Select-String download.*%只查看最近一次进度Select-String download.*% $env:LOCALAPPDATA\Claude-3p\logs\main.log | Select-Object -Last 1查看 Cowork 专用日志Get-Content $env:LOCALAPPDATA\Claude-3p\logs\cowork_vm_node.log -Tail 100镜像目录通常是%LOCALAPPDATA%\Claude-3p\vm_bundles\claudevm.bundle查看文件大小Get-ChildItem $env:LOCALAPPDATA\Claude-3p\vm_bundles\claudevm.bundle -Force | Select-Object Name, {NameSizeMB;Expression{[math]::Round($_.Length / 1MB, 1)}}, LastWriteTime本次完整下载后能看到类似文件rootfs.vhdx.zst 约 2233.9 MB rootfs.vhdx 约 9016 MB initrd.zst 约 165.7 MB initrd 约 169.1 MB vmlinuz.zst 约 14.1 MB vmlinuz 约 14.3 MB smol-bin.vhdx 约 36 MB压缩文件存在不代表整个流程已完成。还要确认rootfs.vhdx已经解压生成。日志出现All files ready。日志出现download_and_sdk_prepare completed。如果命令行停留在日志监听界面可以按Ctrl C这只会停止Get-Content -Wait不会停止 Claude Desktop、虚拟机服务也不会删除已经下载的镜像。五、错误三VM service not running镜像下载完成后Claude Desktop 又提示无法启动 Claude 的工作区 VM service not running. The service failed to start.此时问题已经不在下载层而在 Windows 服务层。1. 查看相关服务Get-Service CoworkVMService,vmcompute,hns,WslService -ErrorAction SilentlyContinue | Select-Object Name,Status,StartType主要服务CoworkVMService Claude 自己的 Cowork VM 服务 vmcompute Hyper-V 主机计算服务 hns 主机网络服务 WslService WSL 服务本次排查时vmcompute、hns和WslService都正常只有CoworkVMService Stopped因此无需重新下载 2GB 镜像也不用一上来就重装 Hyper-V。2. 查看服务退出码sc.exe queryex CoworkVMService sc.exe qc CoworkVMService当时服务状态为STATE : STOPPED WIN32_EXIT_CODE : 1067错误码1067表示服务进程意外终止。3. 查看详细服务日志Claude VM 服务的详细日志在C:\ProgramData\Claude\Logs\cowork-service.log查看最后 100 行Get-Content C:\ProgramData\Claude\Logs\cowork-service.log -Tail 100Claude Desktop 侧还可能持续出现connect ENOENT \\.\pipe\cowork-vm-service这里的ENOENT不是普通文件丢失而是 Claude Desktop 找不到 Cowork VM 服务创建的 Windows 命名管道。服务没运行自然不会存在这个管道。4. 启动 Cowork 服务使用 PowerShellStart-Service CoworkVMService Start-Sleep -Seconds 3 Get-Service CoworkVMService成功时应看到Status : Running再检查是否会立即退出Start-Sleep -Seconds 5 sc.exe queryex CoworkVMService确认命名管道[System.IO.Directory]::GetFiles(\\.\pipe\) | Where-Object { $_ -match cowork-vm-service }正常输出\\.\pipe\cowork-vm-service服务日志中也应出现Service ready. Listening on \\.\pipe\cowork-vm-service Client signature verified Persistent RPC: entering loop此时回到 Claude Desktop点击重试或重新打开 Cowork 工作区即可。如果Start-Service提示权限不足请以管理员身份打开 PowerShell。若服务启动后仍立即停止再检查Windows 事件查看器中的Service Control ManagerC:\ProgramData\Claude\Logs\cowork-service.logBIOS 中是否启用 CPU 虚拟化vmcompute和hns是否能正常启动安全软件是否拦截cowork-svc.exeClaude Desktop 是否需要更新或重新安装六、常用的一键诊断命令查看 Claude CLIGet-Command claude -ErrorAction SilentlyContinue where.exe claude claude.cmd --version查看最近的下载和 VM 错误Select-String -Path $env:LOCALAPPDATA\Claude-3p\logs\main.log -Pattern download|checksum|ERR_NETWORK|VM service|binary not available | Select-Object -Last 30查看 Cowork 服务Get-Service CoworkVMService,vmcompute,hns,WslService -ErrorAction SilentlyContinue查看详细 VM 日志Get-Content C:\ProgramData\Claude\Logs\cowork-service.log -Tail 100启动 Cowork 服务Start-Service CoworkVMService查看镜像是否完整Get-ChildItem $env:LOCALAPPDATA\Claude-3p\vm_bundles\claudevm.bundle -Force七、最终排障顺序以后再遇到类似问题建议按下面的顺序处理1. claude.cmd --version 2. 检查 DeepSeek 配置但不要泄露 API Key 3. 查看 Claude-3p\logs\main.log 4. 判断二进制文件或镜像是否仍在下载 5. 检查网络切换、代理中断和 checksum mismatch 6. 检查 CoworkVMService、vmcompute、hns 7. 查看 C:\ProgramData\Claude\Logs\cowork-service.log 8. 启动 CoworkVMService 并验证命名管道 9. 最后才考虑删除缓存或重新安装这次最容易踩的坑是把所有故障都归结为 DeepSeek。实际上Host Claude Code binary not available是 Desktop 组件下载问题。CLI 长时间 0 Token 通常是网络或队列等待。VM service not running是 Windows 服务问题。日志监听窗口不退出并不代表下载还没完成。把问题分层再顺着日志逐层检查比反复卸载重装有效得多。
Windows 下 Claude Code 接入 DeepSeek 与 Cowork 故障排查实录
目录一、环境说明二、错误一Host Claude Code binary not available1. 先确认命令行版本是否可用2. 查看 Desktop 下载日志3. 推荐修复方法三、错误二同时打开桌面端后CLI 思考明显变慢1. 检查 Claude Desktop 是否在后台下载2. 其他可能原因3. 处理办法四、如何查看 Cowork 虚拟机镜像下载进度五、错误三VM service not running1. 查看相关服务2. 查看服务退出码3. 查看详细服务日志4. 启动 Cowork 服务六、常用的一键诊断命令七、最终排障顺序最近我在 Windows 上折腾 Claude Code、Claude Desktop、DeepSeek 和 Cowork连续遇到了几个看起来毫无关系的问题Claude Desktop 提示Host Claude Code binary not available同时打开 CLI 和桌面端后CLI 一直处于思考状态Cowork 后台下载了一个 2GB 多的虚拟机镜像镜像下载完成后又提示VM service not running这些问题容易被混在一起但实际上分别属于四层DeepSeek API ↑ Claude Code CLI ↑ Claude Desktop ↑ Cowork Windows VM 服务本文记录完整的诊断和修复过程。相关版本、路径会随安装方式变化执行命令时请以自己的环境为准。一、环境说明本次排查环境操作系统Windows Claude Code2.1.x Claude DesktopMicrosoft Store/MSIX 版本 模型服务DeepSeek Anthropic 兼容接口 终端PowerShellClaude Code 的用户配置通常位于:%USERPROFILE%\.claude\settings.json配置示例{ env: { ANTHROPIC_AUTH_TOKEN: 你的 API Key, ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_MODEL: 你的模型名称, API_TIMEOUT_MS: 300000 } }注意不要把真实 API Key 发到论坛、截图或提交到 Git。模型名称取决于你的 DeepSeek 服务或中转平台不要照抄别人的名称。API_TIMEOUT_MS建议先设置为 5 分钟即300000。设置成几十分钟会让连接故障表现为一直思考。二、错误一Host Claude Code binary not availableClaude Desktop 中出现Host Claude Code binary not available. Check that the download completed.这个提示很容易让人误以为是 DeepSeek 接口出错。实际上消息还没有发送到 DeepSeekClaude Desktop 自己需要的 Claude Code 二进制文件没有准备完成。1. 先确认命令行版本是否可用Get-Command claude where.exe claude claude --version如果 PowerShell 因执行策略拦截claude.ps1可以直接运行claude.cmd --version或者使用完整路径 你的 Claude Code 安装目录\claude.cmd --version需要注意终端中的 Claude Code 能运行并不代表 Claude Desktop 的组件已经就绪。Desktop 会维护自己的版本和缓存不一定直接使用 PATH 中的 CLI。2. 查看 Desktop 下载日志Claude Desktop 第三方模式的日志通常位于%LOCALAPPDATA%\Claude-3p\logs\main.log搜索关键错误Select-String -Path $env:LOCALAPPDATA\Claude-3p\logs\main.log -Pattern Claude Code binary|Downloading|checksum|ERR_NETWORK|All download attempts failed本次遇到的真实错误包括net::ERR_NETWORK_CHANGED net::ERR_CONNECTION_CLOSED Checksum mismatch All download attempts failed根因不是 DeepSeek而是 Claude Desktop 从downloads.claude.ai下载组件时代理节点切换、连接中断或文件只下载了一部分最终导致校验失败。3. 推荐修复方法先彻底退出 Claude Desktop包括系统托盘中的后台进程然后确保downloads.claude.ai能通过稳定网络访问。使用代理时固定节点暂时关闭自动选择和自动切换。重新打开 Claude Desktop让它重新下载。不要在下载过程中反复退出或切换网络。如果对应版本目录是空的可以在完全退出 Claude Desktop 后删除这个空目录再让 Desktop 重建$root $env:LOCALAPPDATA\Claude-3p\claude-code Get-ChildItem $root确认目标版本后再删除避免误删其他文件Remove-Item $root\版本号 -Recurse -Force不要直接复制别人的claude.exe。版本、签名和校验标记不一致时Desktop 仍可能拒绝启动。三、错误二同时打开桌面端后CLI 思考明显变慢当时 CLI 的表现是Misting... (2m 9s) 输入 Token0 输出 Token0这里有个很重要的判断方法如果等待了很久但输入、输出 Token 仍然都是 0通常不是模型已经开始深度推理而是请求还在以下某一层等待DNS / 网络连接 代理队列 TLS 建连 服务端限流 等待首个响应1. 检查 Claude Desktop 是否在后台下载本次问题的主要原因是 Claude Desktop 正在下载 Cowork 虚拟机镜像总大小约 2233.9 MB 平均速度约 1.2 MB/s它占用了网络带宽和代理连接CLI 同时访问 DeepSeek 时首个响应时间就会明显变长。可以用下面的命令查看实时日志Get-Content $env:LOCALAPPDATA\Claude-3p\logs\main.log -Tail 20 -Wait | Select-String download.*%如果看到持续增长的百分比、下载速度和 ETA就说明桌面端仍在下载。2. 其他可能原因如果没有后台下载还要检查CLI 和 Desktop 是否共用同一个 API Key服务商是否限制同一 Key 的并发数代理软件是否限制单连接或总带宽是否频繁切换代理节点API_TIMEOUT_MS是否设置得过大当前模型是否本来就有较长的推理时间3. 处理办法最简单的验证方法是完全退出 Claude Desktop。重新启动 Claude Code CLI。用相同问题测试首字响应速度。如果速度立即恢复基本可以确认是 Desktop 下载或并发占用造成的。不希望关闭 Desktop 时可以等待镜像下载完成或者给downloads.claude.ai和 DeepSeek API 分配不同代理策略。四、如何查看 Cowork 虚拟机镜像下载进度实时查看Get-Content $env:LOCALAPPDATA\Claude-3p\logs\main.log -Tail 20 -Wait | Select-String download.*%只查看最近一次进度Select-String download.*% $env:LOCALAPPDATA\Claude-3p\logs\main.log | Select-Object -Last 1查看 Cowork 专用日志Get-Content $env:LOCALAPPDATA\Claude-3p\logs\cowork_vm_node.log -Tail 100镜像目录通常是%LOCALAPPDATA%\Claude-3p\vm_bundles\claudevm.bundle查看文件大小Get-ChildItem $env:LOCALAPPDATA\Claude-3p\vm_bundles\claudevm.bundle -Force | Select-Object Name, {NameSizeMB;Expression{[math]::Round($_.Length / 1MB, 1)}}, LastWriteTime本次完整下载后能看到类似文件rootfs.vhdx.zst 约 2233.9 MB rootfs.vhdx 约 9016 MB initrd.zst 约 165.7 MB initrd 约 169.1 MB vmlinuz.zst 约 14.1 MB vmlinuz 约 14.3 MB smol-bin.vhdx 约 36 MB压缩文件存在不代表整个流程已完成。还要确认rootfs.vhdx已经解压生成。日志出现All files ready。日志出现download_and_sdk_prepare completed。如果命令行停留在日志监听界面可以按Ctrl C这只会停止Get-Content -Wait不会停止 Claude Desktop、虚拟机服务也不会删除已经下载的镜像。五、错误三VM service not running镜像下载完成后Claude Desktop 又提示无法启动 Claude 的工作区 VM service not running. The service failed to start.此时问题已经不在下载层而在 Windows 服务层。1. 查看相关服务Get-Service CoworkVMService,vmcompute,hns,WslService -ErrorAction SilentlyContinue | Select-Object Name,Status,StartType主要服务CoworkVMService Claude 自己的 Cowork VM 服务 vmcompute Hyper-V 主机计算服务 hns 主机网络服务 WslService WSL 服务本次排查时vmcompute、hns和WslService都正常只有CoworkVMService Stopped因此无需重新下载 2GB 镜像也不用一上来就重装 Hyper-V。2. 查看服务退出码sc.exe queryex CoworkVMService sc.exe qc CoworkVMService当时服务状态为STATE : STOPPED WIN32_EXIT_CODE : 1067错误码1067表示服务进程意外终止。3. 查看详细服务日志Claude VM 服务的详细日志在C:\ProgramData\Claude\Logs\cowork-service.log查看最后 100 行Get-Content C:\ProgramData\Claude\Logs\cowork-service.log -Tail 100Claude Desktop 侧还可能持续出现connect ENOENT \\.\pipe\cowork-vm-service这里的ENOENT不是普通文件丢失而是 Claude Desktop 找不到 Cowork VM 服务创建的 Windows 命名管道。服务没运行自然不会存在这个管道。4. 启动 Cowork 服务使用 PowerShellStart-Service CoworkVMService Start-Sleep -Seconds 3 Get-Service CoworkVMService成功时应看到Status : Running再检查是否会立即退出Start-Sleep -Seconds 5 sc.exe queryex CoworkVMService确认命名管道[System.IO.Directory]::GetFiles(\\.\pipe\) | Where-Object { $_ -match cowork-vm-service }正常输出\\.\pipe\cowork-vm-service服务日志中也应出现Service ready. Listening on \\.\pipe\cowork-vm-service Client signature verified Persistent RPC: entering loop此时回到 Claude Desktop点击重试或重新打开 Cowork 工作区即可。如果Start-Service提示权限不足请以管理员身份打开 PowerShell。若服务启动后仍立即停止再检查Windows 事件查看器中的Service Control ManagerC:\ProgramData\Claude\Logs\cowork-service.logBIOS 中是否启用 CPU 虚拟化vmcompute和hns是否能正常启动安全软件是否拦截cowork-svc.exeClaude Desktop 是否需要更新或重新安装六、常用的一键诊断命令查看 Claude CLIGet-Command claude -ErrorAction SilentlyContinue where.exe claude claude.cmd --version查看最近的下载和 VM 错误Select-String -Path $env:LOCALAPPDATA\Claude-3p\logs\main.log -Pattern download|checksum|ERR_NETWORK|VM service|binary not available | Select-Object -Last 30查看 Cowork 服务Get-Service CoworkVMService,vmcompute,hns,WslService -ErrorAction SilentlyContinue查看详细 VM 日志Get-Content C:\ProgramData\Claude\Logs\cowork-service.log -Tail 100启动 Cowork 服务Start-Service CoworkVMService查看镜像是否完整Get-ChildItem $env:LOCALAPPDATA\Claude-3p\vm_bundles\claudevm.bundle -Force七、最终排障顺序以后再遇到类似问题建议按下面的顺序处理1. claude.cmd --version 2. 检查 DeepSeek 配置但不要泄露 API Key 3. 查看 Claude-3p\logs\main.log 4. 判断二进制文件或镜像是否仍在下载 5. 检查网络切换、代理中断和 checksum mismatch 6. 检查 CoworkVMService、vmcompute、hns 7. 查看 C:\ProgramData\Claude\Logs\cowork-service.log 8. 启动 CoworkVMService 并验证命名管道 9. 最后才考虑删除缓存或重新安装这次最容易踩的坑是把所有故障都归结为 DeepSeek。实际上Host Claude Code binary not available是 Desktop 组件下载问题。CLI 长时间 0 Token 通常是网络或队列等待。VM service not running是 Windows 服务问题。日志监听窗口不退出并不代表下载还没完成。把问题分层再顺着日志逐层检查比反复卸载重装有效得多。
雷达仿真（Matlab代码实现）)
