1. 安装前检查
确认电脑为 Windows 10 或 Windows 11 64 位 x86_64，至少 8GB 内存，系统盘建议保留 15GB 空间。当前安装包尚未购买代码签名证书，首次运行时 Microsoft Defender SmartScreen 可能显示“Windows 已保护你的电脑”或“无法识别的应用”提示。这是当前真实的未签名安装包状态，不代表已经取得可信代码签名；请只从智域科技网站的正式下载页面获取安装包并核对页面公布的文件校验值。
2. Claude Code Bridge v0.1.19 安装前检查
Claude Code Bridge v0.1.19 用户需要准备 Windows 10/11 64 位电脑、可访问国内依赖源和 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。首次出现主题选择时，按数字选择一个主题即可。
关闭 VS Code 后不需要重新部署。请按 再次打开 Claude Code 教程，从桌面启动 Visual Studio Code，在集成终端输入 claude。
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 Bridge 安装工具中点击“导出诊断报告”，再通过原购买或获客渠道联系，并提供订单号、错误截图和诊断报告；收到完整材料后 2 个工作日内反馈。报告不包含聊天内容、文件内容、DeepSeek API Key、项目文件、shell 历史或原始硬件序列号。请勿发送完整授权码或 DeepSeek API Key，核对授权记录时只需要授权码或下载凭证后四位。