适用版本 1.2.0 | Apple Silicon M 系列 Mac | macOS 13 及以上

按以下步骤完成官方客户端安装、API 配置、中文和桌面快捷方式。

下载 DD Codex Mac 安装助手 1.2.0

点击链接:打开链接

安装与配置

1 解压并打开助手

双击下载的 ZIP 解压,打开文件夹内的“DD Codex 安装助手.app”。请保留整个文件夹,不要只取出其中的脚本。

2 安装官方 Codex

点击“前往官网下载”,按官网提示安装 Codex。安装完成后,完全退出并重新打开 DD Codex 助手;本版助手通过浏览器引导下载。

3 注册并获取密钥

点击“获取 API 密钥”,登录或注册叮咚账号,创建并复制 API 密钥。

4 填写并开始配置

先保存 Codex 中的任务,使用 Command + Q 完全退出 Codex。回到助手,核对以下内容,然后点击“开始配置”。

API 地址:打开链接

模型:保留默认值,或填写客服提供且当前密钥支持的模型名称。

API 密钥:点击“粘贴密钥”,也可按 Command + V;输入框会隐藏内容。

5 等待完成并测试

验证密钥 → 写入配置 → 启用中文 → 创建桌面快捷方式。进度达到 100% 且日志无失败提示后,点击“打开 Codex”,新建对话发送“你好”测试。

出现报错时,按下一页方法处理;已完成的步骤会保留,可修正原因后重试。

常见问题与处理

助手提示无法验证开发者

方法:确认使用本教程提供的安装包,再按系统提示允许打开。

步骤:先尝试打开助手;进入“系统设置 → 隐私与安全性”,找到该助手的“仍要打开”,再确认“打开”。提示“将损坏电脑”或“已损坏”时,保留截图联系客户支持。

提示尚未安装 Codex

方法:先装官方客户端,再重新启动助手。

步骤:点击“前往官网下载”完成安装;打开官方 Codex 确认有窗口,再退出 Codex 并重开助手。仍未识别时,发送安装位置和错误截图。

密钥验证失败或模型列表为空

方法:核对地址、密钥和对应服务权限。

步骤:重新复制完整密钥;删除多余空格或换行;确认 API 地址是客服提供的 HTTPS 地址、密钥属于同一平台,再重试。仍失败时点击“复制日志”发给客服,不发送完整密钥。

配置中断或进度没有到 100%

方法:查看日志中的失败步骤,处理后重试。

步骤:提示客户端仍运行时,用 Command + Q 完全退出 Codex。中文步骤失败时可单独点“启用中文”;快捷方式失败时点“创建快捷方式”。仍失败时复制日志反馈。

配置完成后仍是英文或无法对话

方法:分别检查中文状态和 API 连接。

步骤:仍英文:完全退出 Codex,点击“启用中文”,再打开验证;无效时点“检查状态”并复制日志。无法对话:核对模型、密钥和平台额度,将完整报错截图发给客服。

反馈时请提供:Mac 芯片、macOS 版本、失败步骤、错误截图和复制日志。