跳到正文
下载中心 →

codex 生图工具包下载与安装

下载完整包,按中文向导检查环境、填写 Key、选择模型并检查连接,然后直接在 Codex 中描述想生成的图片。

本页内容

下载一次,在 Codex 里直接生图

跟着中文向导填写 Key、选择模型,完成连接检查后,直接用中文描述你想要的图片。

目标电脑系统默认 Windows,可按实际使用的电脑切换
  1. 下载并解压Windows 右键 ZIP 选择“全部解压”;Mac 双击 ZIP 解压。
  2. 打开安装向导Windows 双击 install.cmd;Mac 双击 install.command。Linux 步骤见下方。按向导检查权限与 Codex 运行状态。
  3. 粘贴 Key没有 Key?先获取 API Key。回到安装窗口粘贴,输入时不会显示。
  4. 选模型,检查连接输入模型选项后回车;直接回车选择 gpt-image-2。连接失败时,向导会提供重新填写和重试选项。
  5. 打开新对话对 Codex 说“帮我生成一张咖啡店开业海报”,按提示选择模型,生成完成后查看输出文件。
还没有安装 Codex?下载 Codex 客户端已安装可以跳过这一步。

本页适用的服务

本页保留现有工具的原有中转服务预设。使用平台账户与平台 Key,请先查看 平台 API 接入,客户端按手动配置指南填写平台地址。原有服务的 Key 与额度继续单独管理。

安装好后怎么用?

安装向导完成后,打开 Codex 新对话,输入“帮我生成一张咖啡店开业海报”即可,不需要输入技能命令。若未自动选中,可说“用生图工具包帮我生成图片”。
查看生图与参考图编辑示例。如果缺少 Key,请先到 中转站控制台 获取。

安装窗口会一步一步带你完成

  • 检查环境:显示当前权限并确认安装目录可写。安装到当前账户,不要求管理员权限。
  • 检查 Codex:Windows 检测当前用户的桌面窗口,默认保持打开。确需关闭时先征求同意;正常退出失败后,会再次询问是否强制关闭。强制关闭可能丢失未保存工作,应先保存。由 Codex 任务启动安装时不会自动关闭当前客户端。Mac / Linux 如未识别新 Skill,请保存工作后手动重开。
  • 安装工具包:自动放到 Codex 可发现的位置,无需手动复制 Skill 或修改配置。
  • 填写 Key:首次必须粘贴 Key,输入隐藏;空白或格式无效会提示重填。没有 Key 时,窗口提供控制台地址。再次安装保留已保存的 Key。
  • 选择模型:按编号选择并记住,回车选择 gpt-image-2;也可选择每次询问。已有模型偏好会保留。
  • 检查连接:只读取模型列表,不生成收费图片。失败时可重填 Key、重试或稍后处理;尚未通过时会明确显示未完成。模型列表检查通过不代表图片生成权限或额度已确认。

Mac 与 Linux 安装步骤

Mac:下载对应芯片的 ZIP 并解压,双击 install.command,按提示粘贴 API Key。
Linux:下载对应架构的 ZIP 并解压,在解压目录打开终端,运行下方命令,再按提示填写 Key。
sh
# 仅 Linux 用户
sh install.sh

更新、重配和卸载

  • 更新:下载新完整包再运行安装,保留原 Key 与模型偏好;也可让 Skill 执行 update,由运行程序完成版本更新。
  • 重配:运行包内 configure.cmd / configure.command / configure.sh。
  • 诊断:运行包内 doctor.cmd / doctor.command / doctor.sh,不会提交收费图片。
  • 卸载:运行包内 uninstall 入口,将 Skill 移出 Codex 发现目录,默认保留 Key 与偏好;需要清除时运行 mosshubs-image uninstall --purge(Windows 为 mosshubs-image.exe)。
  • 不覆盖其他 Skill 或全局模型配置;遇到同名非本工具安装目录时停止并保留原内容。

安装或使用遇到问题

Key 配置与常见错误见 生图工具包问题处理。也可加入 QQ 群 1105046159,说明系统和错误提示,不要发送 Key。