主题
Claude Desktop
Anthropic 官方桌面客户端，图形界面版的 Claude（跟 Claude Code CLI 是同生态不同产品）。可以通过开发者模式接入第三方 API。
Claude Desktop ≠ Claude Code
- Claude Desktop：GUI 聊天 app，普通用户日常聊天
- Claude Code CLI：终端编码 agent，开发者用
安装
macOS
去 claude.com/download 下 .dmg，直接装。
Windows
下载 Claude Setup.exe。如果直接双击启动失败（认证问题），需要带参数装：
cmd
"Claude Setup.exe"配置 Shuro
1. 启用开发者模式
启动 Claude Desktop → 顶部菜单：
Help → Troubleshooting → Enable Developer Mode重启 Claude Desktop。
2. 配置第三方推理
Developer → Configure third-party inference填表：
| 字段 | 值 |
|---|---|
| Gateway base URL | https://shuro.vip |
| API Key | <您的 API Key> |
| Skip login-mode chooser | ✅ 勾选 |
点 「Apply locally」 保存。
3. 验证
回到主界面，开始新对话，发任意消息。如果走到 Shuro 上游，控制台「日志」页能看到这条请求。
注意事项
跟 Claude Code 的区别
- Claude Desktop 不支持 tool use / file edit / bash 等编码能力
- 只能聊天，无法跑 agent 工作流
- 想要 agent 能力请用 Claude Code 或 AionUI
配置存哪里
| 系统 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/Claude/ |
| Windows | %APPDATA%\Claude\ |
| Linux | ~/.config/Claude/ |
第三方 inference 配置写在该目录下的 config.json 里。
常见问题
Developer 菜单不见了
重启 Claude Desktop。或者在 「Help → About」 里连续点版本号 5 次激活开发者模式（隐藏入口，根据版本可能变）。
配置后还是走官方 API
点了 Apply 但没生效？
- 完全退出 Claude Desktop（不是关窗口，是 Quit）
- 重新启动
- 看 Developer → Network Inspector 确认请求 URL 是 Shuro
Windows 启动闪退
通常是 .NET 运行时缺失。装最新 .NET Desktop Runtime：microsoft.com/dotnet
跟其他客户端的对比
| Claude Desktop | Claude Code | AionUI | |
|---|---|---|---|
| 界面 | GUI | CLI | GUI + WebUI |
| 编码能力 | ❌ | ✅ 完整 | ✅（通过 CLI） |
| Tool use | ❌ | ✅ | ✅ |
| 多 agent 切换 | ❌ | ❌ | ✅ |
| 移动访问 | ❌ | ❌ | ✅ |
| 适合 | 普通对话 | 程序员 | 多 agent 用户 |
如果你想要 GUI + 编码能力，AionUI 更合适。