[BUG] Windows上安装完无法使用。 desktop server startup failed: desktop server did not start listening on 127.0.0.1:52896 within 10 seconds

[mildwolf]

提交前确认

• 我已经阅读了 README 常见问题
• 我已经升级到最新版本后复现过这个问题
• 我已经搜索过现有 issues，确认没有重复问题
• 我已经隐藏截图和日志中的 API Key、Token、Cookie 等敏感信息

问题描述

1. 我希望安装能够告诉我需要安装哪些依赖。
2. 在我确认后自动安装所有的依赖，如果安装有问题，告知我。
3. 在安装结束后，可以启动ui。 正常工作。

运行环境

• 使用方式: 桌面端 / CLI / 其他:
• 操作系统: Windows / macOS / Linux:
• 系统版本: 例如 Windows 11 23H2 / macOS 15.4:
• 桌面端版本: 例如 v0.1.8（设置页 -> 关于 中可查看）:
• 安装来源: GitHub Release / 源码本地构建 / 其他:
• Bun 版本（CLI 问题填写，bun --version）:
• Node 版本（CLI 问题填写，node --version）:

Provider / 模型配置

• API 提供商: 例如 Anthropic 官方 / OpenRouter / MiniMax / Kimi / Ollama:
• Base URL:
• 使用的模型:
• 相关配置截图:

复现步骤

是否稳定复现: 是 / 否 / 不确定

错误信息与日志

在此粘贴错误信息和日志
desktop server startup failed: desktop server did not start listening on 127.0.0.1:52896 within 10 seconds

Recent server logs:
No server stdout/stderr was captured before the timeout.

截图或录屏

补充信息

---

@dosubot

[dosubot]

Hi @mildwolf! I'm Dosu and I’m helping the cc-haha team.

这是 Windows 上一个比较常见的问题。以下是几个主要原因和对应的解决方案：

1. 安装路径包含空格或中文字符
如果你的安装路径类似 C:\Program Files\... 或包含中文，请卸载后重新安装到一个纯英文、无空格的路径，例如 D:\ClaudeCodeHaha [1]

2. 缺少 WebView2 Runtime
桌面端依赖 Microsoft WebView2 Runtime。请确认已安装，如果没有，从 微软官方页面 下载安装 [2]

3. 防火墙/杀毒软件拦截
Windows Defender 或其他安全软件可能会阻止 localhost (127.0.0.1) 连接。请检查防火墙设置，允许该应用的本地网络通信 [3]

4. 清除配置目录
尝试删除以下目录后重新启动：

• %LOCALAPPDATA%\com.claude-code-haha.desktop\
• %APPDATA%\com.claude-code-haha.desktop\
• ~/.claude/

[4]

5. 升级到最新版本
部分版本存在已知的启动回退问题（如 v0.2.6），建议从 GitHub Releases 下载最新版本重新安装 [5]

---

建议你按以上顺序逐一排查。如果问题仍然存在，请补充以下信息以便进一步诊断：

• 你的安装路径是什么？
• 使用的桌面端版本号？
• 是否安装了 WebView2 Runtime？

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.