Codex 版 Meshy 插件

Meshy 官方 Codex 插件，让你在对话中直接得到 3D 资产。描述想要的模型或附上一张照片，Codex 就会生成模型、添加纹理，并把文件保存到你的项目中。

概述

Meshy 现已上架 ChatGPT（Codex）插件目录，包含两个技能：

  • Meshy 3D Generation：文生 3D、图生 3D 和多视图生 3D，AI 纹理生成与重新贴图，按面数预算重拓扑，UV 展开，人形角色自动绑定骨骼与动画，并导出 GLB、FBX、OBJ、STL 或 USDZ。
  • Meshy 3D Printing：可打印性分析与修复，单色和多色 3MF，按真实尺寸缩放，Creative Lab 产品（手办、灯具、钥匙扣、冰箱贴），以及在已安装的切片软件中打开。

两个技能都通过你电脑上的 Meshy CLI 运行。只需在浏览器中登录一次，无需在对话中粘贴 API 密钥。文件会保存到你指定的文件夹，并附带渲染预览图，以及 Codex 后续编辑所需的任务 ID。

使用要求

  • Codex：ChatGPT 桌面应用或 Codex CLI。浏览器中的 ChatGPT 对话无法加载插件。工作或学校工作区可能需要管理员先允许使用插件。
  • Node.js 22.12 或更高版本，并带有 npm。可以用 node --version 检查；如果未安装或版本过旧，请从 nodejs.org 安装当前的 LTS 版本。
  • Meshy 付费套餐：生成功能需要付费套餐，每个生成任务都会消耗 Meshy 积分。本地打印步骤（例如缩放模型或在切片软件中打开）无需登录。

安装

在 ChatGPT 桌面应用中：

  1. 切换到 Codex，打开 Plugins（插件）。
  2. 搜索 Meshy，点击 Install plugin（安装插件）。
  3. 新建一个对话。插件只会在安装之后新开的对话中加载。

Codex 插件目录中的 Meshy

在 Codex CLI 中： 运行 /plugins，安装 Meshy，然后开启一个新会话。

要确认是否安装成功，可以在新对话中输入 @，看看列表里有没有 Meshy；也可以直接问 Codex 有哪些可用的 Meshy 技能。

登录

第一次请求生成模型时，插件会检查 Meshy CLI 和已有的登录状态。如果尚未登录，Codex 会给出一个 Meshy 登录链接和一次性验证码：

  1. 打开链接并登录 Meshy。
  2. 按显示内容准确输入验证码，然后点击 Connect。
  3. 回到 Codex，它会继续执行你之前的请求。

Connect Meshy CLI 页面

验证码 10 分钟后失效，过期了让 Codex 重新生成即可。Meshy CLI 会把登录状态保存在你的电脑上，之后的对话会直接复用。如果环境变量中设置了 MESHY_API_KEY，它会优先于浏览器登录。

在 Codex CLI 中首次运行时，可能会请求网络访问权限。请允许，以便 Meshy CLI 访问 Meshy API。

示例提示词

提到 @Meshy，或者直接描述任务：

  • 为我的游戏做一个低多边形宝箱，目标 2,000 个三角面，添加 PBR 纹理，以 GLB 格式保存到 ./assets。
  • 把这张照片转成带纹理的 3D 模型，保持原有比例。（附上图片）
  • 给这个带纹理的人形角色绑定骨骼，添加行走动画，并导出为 FBX。
  • 把 ./assets/chest.glb 重新贴图成做旧青铜质感，保存在原文件旁边。
  • 把这张照片做成 75 mm 高的手办，检查可打印性，并为兼容的切片软件准备多色 3MF。

后续请求会沿用上一次的结果：做一个 1,500 面的 LOD、换成 FBX、缩放到 150 mm。没有指定文件夹时，文件会保存到 ./meshy_output。

积分

生成、纹理、重拓扑、骨骼绑定、动画和修复都会按 API 价格 消耗你 Meshy 账户中的积分。可打印性分析免费。Codex 会在付费步骤前预估费用，超出你已同意的额度前会先询问你。在请求中加上 花积分前先问我，即可逐个确认付费步骤；也可以随时问 我还有多少 Meshy 积分？

问题排查

现象解决方法
输入 @ 后看不到 Meshy请使用 ChatGPT 桌面应用或 Codex CLI，而不是浏览器中的对话。重启 Codex 并新开一个对话。
Codex 要求提供 API 密钥拒绝，并让它改用浏览器登录。不要在任何对话中粘贴 API 密钥。
找不到 node 或 npm从 nodejs.org 安装 Node.js 22.12 或更高版本，然后重启 Codex。
登录验证码已过期让 Codex 重新发起登录。验证码有效期为 10 分钟。
因套餐或积分不足无法生成生成需要付费套餐和足够的积分。请在 meshy.ai 查看你的套餐和余额。
登录了错误的 Meshy 账户让 Codex 运行 meshy auth logout，然后重新登录。

常见问题

Codex 版 Meshy 插件免费吗？
插件可以免费安装。生成 3D 模型需要 Meshy 付费套餐，并按 API 价格消耗 Meshy 积分。可打印性分析免费，缩放模型、在切片软件中打开等本地步骤无需登录。
需要 Meshy API 密钥吗？
不需要。插件通过浏览器和一次性验证码登录，Meshy CLI 会把登录状态保存在你的电脑上。不要在对话中粘贴 API 密钥。如果环境中已经设置了 MESHY_API_KEY，会优先使用它，而不是浏览器登录。
模型保存在哪里？
保存在你在请求中指定的文件夹；没有指定时保存到 ./meshy_output，并附带预览图和任务 ID。文件保存在你的电脑上，而不是 Meshy 网页版的工作区中。
插件支持导出哪些格式？
3D 资产支持 GLB、FBX、OBJ、STL 和 USDZ；3D 打印支持单色或多色 3MF。
插件能在浏览器版 ChatGPT 对话中使用吗？
不能。插件在 Codex 中运行，需要使用 ChatGPT 桌面应用或 Codex CLI。
能在 Claude Code 或 Cursor 中使用同样的 Meshy 技能吗？
可以。这些技能开源在 GitHub 的 meshy-3d-agent 仓库中，可以安装到 Claude Code、Cursor、Gemini CLI 等智能体。让你的智能体按照 https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md 操作即可。

相关链接