1. 安装前检查
确认电脑为 Windows 10 22H2 或 Windows 11 64 位 x86_64，至少 8GB 内存，系统盘建议保留 15GB 空间。演示安装包尚未购买代码签名证书，Windows 可能显示安全提醒；正式售卖前必须替换为已签名安装包。
2. Claude Code DeepSeek 安装前检查
Claude Code DeepSeek 用户需要准备 Windows 10/11 电脑、可访问国内依赖源和 DeepSeek API 的网络、DeepSeek 账号以及用户自备 DeepSeek API Key。DeepSeek API 费用由用户自行向 DeepSeek 支付；ModelDock 不提供共享 Key、不代充值，也不保存用户的 API Key。
安装工具会检查 VS Code、Node.js 18+、Git for Windows、WinGet 和 Claude Code，并引导把 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 写入本机用户环境变量。若你不确定某一步是否完成，请先查看 下载与首次使用指南，再导出不含 API Key 的诊断报告。
部署完成后，桌面端会显示“打开 VS Code 使用 Claude Code”。点击后会打开 ModelDock 工作区，并在底部集成终端自动启动 Claude Code。首次出现主题选择时，按数字选择一个主题即可。
3. 授权码无法激活
检查授权码是否完整、网络是否可用以及电脑日期时间是否正确。一份授权只绑定一台电脑。不要连续反复尝试，激活服务会在十分钟窗口内限制过多请求。若提示已绑定另一台电脑，请通过原订单渠道核对订单与授权记录。
4. 模型下载中断
程序支持断点续传。网络中断后重新点击安装即可继续；主动取消也会保留分片。若提示磁盘不足，请释放空间后重试。下载完成后程序会校验固定 SHA-256，校验失败的文件不会被当作可用模型。
5. API Key、Claude Code 与镜像源问题
若提示 DeepSeek API Key 无效、额度不足、账号受限或账单异常，请在 DeepSeek 官方平台检查 Key、余额、额度和账号状态。请勿发送 DeepSeek API Key 给客服；支持人员无法查看、重置、代管或代付用户的 DeepSeek API Key。
Claude Code、DeepSeek API、Node.js、Git、WinGet、npm registry 和国内镜像源属于第三方或上游依赖。ModelDock 支持可以帮助阅读诊断报告、确认本机配置和建议替代安装方式，但不能保证第三方上游长期保持同一版本、同一价格或同一可用状态。
6. 本地模型无法启动
先关闭占用大量内存的程序，再点击启动本地模型。推理进程只监听本机回环地址，防火墙不应要求开放公网端口。若安全软件隔离了运行时文件，请从正式下载页重新安装，不要从第三方网盘单独下载 DLL。
7. 提交最小诊断信息
在“设备与模型”页面或 Claude Code DeepSeek 安装工具中点击“导出诊断报告”，连同软件版本、错误截图和订单号发送到正式支持入口：[待填写]。报告不包含聊天内容、文件内容、DeepSeek API Key、项目文件、shell 历史或原始硬件序列号。请勿发送完整授权码或 DeepSeek API Key，客服只需要授权码或下载凭证后四位。