Claude Code 桌面版常见问题

本页只处理 Claude Code 桌面版的安装、启动和接入问题。CLI 问题见 Claude Code 常见问题。

先按现象判断

现象	优先处理
提示 Missing HCS services	处理 Windows 虚拟机平台组件
看不到 Developer 菜单	重新启用开发者模式
Test connection 失败	检查地址、API Key、鉴权方式和令牌分组
Host Claude Code binary not available	桌面版 Code 组件没下载完整

安装与启动

Windows 提示 Missing HCS services

桌面版提示 Windows 主机 HCS 服务缺失：

1. 按 Win+R，输入 optionalfeatures，回车
2. 在「启用或关闭 Windows 功能」里勾选 虚拟机平台（Virtual Machine Platform）
3. 点「确定」，等待安装完成
4. 重启 Windows，再重开桌面版

注意

Windows 功能装完必须重启，只关掉重开桌面版通常不够。 公司设备可能需要管理员权限。

仍然提示？检查硬件虚拟化

1. 打开任务管理器 →「性能 → CPU」，确认「虚拟化」显示为已启用
2. 如果是已禁用，进 UEFI/BIOS 开启处理器虚拟化
   • Intel：Intel Virtualization Technology / VT-x / VMX
   • AMD：SVM / AMD-V
3. 保存 BIOS 设置并重启

提示 Host Claude Code binary not available

通常是桌面版的 Code 组件没下载完整：

1. 检查当前网络能否访问桌面版所需官方资源；用代理时确认桌面应用也能用
2. 完全退出桌面版
   • Windows：关掉窗口 + 确认托盘无残留进程
   • macOS：菜单栏 Claude → Quit Claude，或 Cmd+Q
3. 重开 Claude，进 Code 标签页等组件下载完成
4. 仍失败则从官方下载页重新下载安装

看不到 Developer 菜单

完全退出桌面版（含托盘进程）→ 重开 → 依次点：

Help → Troubleshooting → Enable Developer Mode

启用后 Claude 会自动重启，重启完成后顶部菜单出现 Developer。

连接与权限

Test connection 失败

测试项	优先检查
Model discovery 失败	Credential kind、Gateway 地址、API Key、鉴权方式
Inference 失败	令牌分组、模型权限、账号额度、网络连接

第三方推理配置应满足：

项	值
Credential kind	Static API key
Gateway base URL	https://187api.com（不带 /v1）
Gateway API key	对应分组的完整 API Key
Gateway auth scheme	bearer

503 / 403 / 无权限

• 503 + get_channel_failed → 该模型暂时没有可用通道，稍后重试
• model_not_found → 检查分组和令牌权限：
  1. Credential kind 是否为 Static API key
  2. Gateway base URL 是否为 https://187api.com
  3. API Key 是否来自正确分组
  4. 「模型可用列表」是否留空（必须包含桌面端实际使用的模型）
  5. 账号是否有可用额度

请求超时或没有响应

1. 确认 Gateway base URL 为 https://187api.com，末尾不要加 /v1 或接口路径
2. 检查本地网络、代理或 TUN 模式
3. 点 Test connection，根据 Model discovery / Inference 结果定位

使用与计费

信息

新建对话后可能出现额外的小额模型调用 —— 桌面版可能调用辅助模型生成会话标题或完成轻量客户端任务。 发送第一条消息后请求记录里偶尔出现与主模型不同的小额调用，通常不代表令牌泄露或模型选错。

如果额外调用金额明显异常或持续大量出现，记录发生时间、模型名称、请求 ID 和消耗情况后联系客服排查。

---

相关：Claude 桌面版配置 · Claude Code 配置 · 常见问题总览