AI智能体（Codex + WorkBuddy）
安装配置操作手册

这是正常现象。没有 ChatGPT 账号时，Codex 无法通过登录页进入。先关闭 Codex，不要反复尝试登录。

打开 CC Switch → 选择 Codex → 添加 DeepSeek 并粘贴 API Key → 启用当前渠道 → 进入“设置 → 路由”打开 Codex 路由总开关，然后重新启动 Codex。

如果仍停在登录页，回到 CC Switch 确认路由已开启，并检查 DeepSeek 是否为当前供应商。

请从 Microsoft Store 官方 Codex 页面重新安装。如提示“被组织策略禁止”，需要 IT 放行 Microsoft Store、App Installer 或应用旁加载。

如果只需命令行版，请前往 OpenAI Codex 官方 Release 下载 CLI。

这表示解压目录还没有加入 PATH。可以直接双击 Start-Codex.cmd 使用，也可以把该目录加入当前用户 PATH，然后关闭所有旧终端窗口，重新打开 PowerShell。

验证命令：codex --version，预期为 codex-cli 0.163.0。

先尝试右键 Start-Codex.command →“打开”。如果仍被拦截，打开“系统设置 → 隐私与安全性”，在页面下方找到刚被拦截的项目，点击“仍要打开”。

也可以在“终端”进入解压目录后直接执行 ./Start-Codex.command，这样更容易看到具体错误。

多半是芯片和安装包不匹配。苹果菜单 →“关于本机”：显示 M1/M2/M3/M4 就选 Apple Silicon 包；显示 Intel 就选 Intel 包。

不要从另一个安装包目录中复制单独的二进制文件，重新解压对应架构的完整 ZIP。

先确认 CC Switch 当前选中的是 Codex，再确认供应商卡片处于“已启用/当前使用”状态。修改配置后完全退出 Codex，重新启动。

401/403 通常表示 Key 无效、复制时带了空格或权限不足；余额不足一般会有明确提示或 402。先检查账户余额，再重新创建 Key 并在 CC Switch 中完整粘贴。

先升级到本次提供的 CC Switch 4.0.15。仍然找不到时，新建“自定义 / OpenAI 兼容”供应商，接口地址填写 https://api.deepseek.com。

API Key 只粘贴到 Key 字段，模型名按讲师指定的名称填写；保存后记得开启 Codex 路由总开关并重新启动 Codex。

确认电脑可以正常联网，并使用企业提供的可用账号。没有账号时不要反复尝试，请联系管理员或讲师处理。

如果提示安全风险或版本不兼容，确认 Windows 为 10+、macOS 为 12+，并确认 Mac 使用了正确芯片版本。暂时无法登录时，可先用 DeepSeek 网页版完成课堂练习。

退出 WorkBuddy 后重新打开，在系统权限提示中允许访问本次工作目录。不要把整个磁盘都授权给不熟悉的工具。

建议把测试文件单独放进一个文件夹，再让 WorkBuddy 选择该目录。输入文件只用脱敏样例，先确认不会修改原文件。

先关闭旧终端窗口，再从本次解压目录启动。若系统中还安装了旧版 Codex，可能会优先调用旧命令；直接用 Start-Codex.cmd 或 Start-Codex.command 可以避免 PATH 混淆。