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

如果 Claude Code 桌面版显示下面的提示：

这是 Claude Code 桌面版提示 Windows 主机上的 HCS 服务缺失。请先按下面方法启用虚拟机平台相关组件。

打开 Windows 功能

1. 按 Win+R，输入 optionalfeatures，然后回车。
2. 在“启用或关闭 Windows 功能”窗口中勾选 虚拟机平台（英文界面为 Virtual Machine Platform）。
3. 点击“确定”，等待 Windows 完成安装。
4. 重启 Windows，再重新打开 Claude Code 桌面版。

仍然提示时：检查硬件虚拟化

如果已经勾选“虚拟机平台”但仍然报错：

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

不同电脑进入 BIOS 的按键和选项名称可能不同，可参考 Microsoft：在 Windows 上启用虚拟化 以及设备厂商说明。

提示

Windows 功能安装完成后必须重启；只关闭并重新打开 Claude Code 桌面版通常不够。若公司设备由管理员管理，可能需要管理员权限才能启用该组件。

提示 Host Claude Code binary not available

如果出现 Host Claude Code binary not available 或 Check that the download completed，通常是桌面版的 Code 组件没有下载完整。

1. 检查当前网络能否正常访问 Claude 桌面版所需的官方资源；使用代理时，确认桌面应用也能使用该代理。
2. 按当前系统完全退出 Claude 桌面版：

Windows

先关闭 Claude 窗口，再确认任务栏托盘中没有仍在运行的 Claude 后台进程。

macOS

在菜单栏选择 Claude → Quit Claude，或按下 Command+Q 完全退出应用。

3. 重新打开 Claude，进入 Code 标签页等待组件下载完成。
4. 仍然失败时，从 Claude 官方下载页重新下载并安装桌面版。

看不到 Developer 菜单

请先完全退出 Claude Code 桌面版，确认托盘中的 Claude 也已关闭，然后重新打开。接着依次点击：

Help → Troubleshooting → Enable Developer Mode

启用后 Claude 会自动重启，重启完成后顶部菜单应出现 Developer。详细步骤见 Claude Code 桌面版配置教程。

连接与权限

Test connection 失败

先根据测试结果判断：

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

第三方推理配置应满足：

• Credential kind：Static API key
• Gateway base URL：https://img-api.apinebula.ai
• Gateway API key：来自 Claude Code全球高防 分组的完整 API Key
• Gateway auth scheme：bearer

模型或令牌权限错误

如果出现 503 Service Unavailable、403 Forbidden 或无权限提示，先根据实际错误定位。

当前测试 Key 请求 Claude 模型时返回：

服务暂时不可用，请稍后重试
error.code: get_channel_failed

这表示当前模型没有可用通道，属于服务端模型路由暂时不可用，不是 API Key 格式错误。请稍后重试；如果持续出现，再联系客服并提供请求时间和 request id。

如果接口返回模型不支持或 model_not_found，再检查模型分组和令牌权限：

请依次检查：

• 第三方推理配置中的 Credential kind 是否为 Static API key
• Gateway base URL 是否填写为 https://img-api.apinebula.ai
• API Key 是否来自 Claude Code全球高防 分组
• APINebula 令牌管理中的 模型可用列表 是否留空；若已填写，必须包含桌面端实际使用的模型
• APINebula 账号是否有可用额度

请求超时或没有响应

• 确认 Gateway base URL 为 https://img-api.apinebula.ai，末尾不要添加 /v1 或接口路径
• 检查本地网络、代理或 TUN 模式是否正常
• 点击 Test connection，根据 Model discovery 和 Inference 的结果定位地址、令牌或模型权限问题

完成修改后，完全退出并重新打开 Claude Code 桌面版，再重新发起请求。

使用与计费

新建对话后出现额外的小额模型调用

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

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

继续阅读

• Claude Code 桌面版配置
• Claude Code CLI 配置
• Claude Code 常见问题
• 常见问题总览