01 / 06
第一步：安装 SDK 引擎
推荐从 SDK 开始，通过“安装与版本”下载和管理引擎，无需复制终端安装命令。
通过界面下载安装
- 打开“设置 → 执行引擎”，找到带 sdk 模式标记的 Codex 或 Claude Code 卡片，分别对应 Codex SDK 和 Claude Agent SDK。第一次只安装你准备使用的一个即可。
- 点击该引擎的“安装与版本”，等待版本列表加载，在“选择版本”中选择适用的版本。
- 点击“安装所选版本”，核对版本；如出现第三方服务条款，先阅读并勾选接受，再点击“确认安装”。
- 等待主安装包下载、引擎及依赖安装、版本校验完成，确认界面显示新版本。
- SDK 版本切换后需要重启后台服务。桌面用户可在当前工作结束后退出并重新打开 WorkStep，然后继续配置。
下载百分比只统计主安装包，依赖下载和解压阶段可能没有百分比；请根据阶段文字判断进度。
收起安装区域后后台安装仍会继续，不要因暂时没有进度变化重复提交。
没有适用版本时先刷新版本列表并检查网络与平台支持。配置了自定义可执行文件路径时，须按界面提示先清除路径配置，才能管理版本。
检查安装结果与版本维护
- 重新打开“执行引擎”，检查 SDK 是否被识别为已安装以及当前版本是否正确。
- 后续升级仍使用“安装与版本”。有回退版本时，可点击“回退到…”并确认；回退会重新下载旧版本。
- 安装失败时先阅读该区域的错误信息，检查网络、磁盘空间和安装路径，再重试。安装成功不等于模型认证成功，继续完成下一章的配置和测试。