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 桌面應用程式中:
- 切換到 Codex,開啟 Plugins(外掛程式)。
- 搜尋 Meshy,點擊 Install plugin(安裝外掛程式)。
- 新建一個對話。外掛程式只會在安裝之後新開的對話中載入。

在 Codex CLI 中: 執行 /plugins,安裝 Meshy,然後開啟一個新工作階段。
要確認是否安裝成功,可以在新對話中輸入 @,看看清單裡有沒有 Meshy;也可以直接詢問 Codex 有哪些可用的 Meshy 技能。
登入
第一次要求生成模型時,外掛程式會檢查 Meshy CLI 和既有的登入狀態。如果尚未登入,Codex 會提供一個 Meshy 登入連結和一次性驗證碼:
- 開啟連結並登入 Meshy。
- 按顯示內容準確輸入驗證碼,然後點擊 Connect。
- 回到 Codex,它會繼續執行你先前的要求。

驗證碼 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 操作即可。
相關連結
- OpenClaw 版 Meshy 技能
- Hermes Agent 版 Meshy 技能
- AI 工具:MCP server 與 llms.txt:使用你自己的 API 金鑰,在 AI 代理程式中呼叫 Meshy API
- 如何在 Codex 中使用 Meshy 外掛程式:逐步教學
- GitHub 上的 meshy-3d-agent:技能原始碼