Codex用Meshyプラグイン

Codex にMeshyプラグインをインストールして、チャットから3Dモデルを生成・テクスチャリングし、ファイルをプロジェクトに保存しましょう。


概要

MeshyプラグインはChatGPTとCodexが共有するPluginsディレクトリにあり、WorkとCodexで動作しますが、Chatでは動作しません。ChatGPTのチャットでモデルを作成したり、Meshyのウェブサイトで作成したモデルを扱ったり、インストールを省略したりするには、同じディレクトリにあるMeshyのもう一つのプラグイン、Meshy 3Dを使用してください。両者の比較については、どのMeshyプラグインを使うかを参照してください。

Meshyプラグインには2つのスキルがあります。

  • Meshy 3D Generation:テキストから3D、画像から3D、マルチ画像から3D、AIテクスチャリングとリテクスチャ、ポリゴン予算へのリメッシュ、UV展開、ヒューマノイドキャラクター向けの自動リギングとアニメーション、GLB、FBX、OBJ、STL、USDZへのエクスポート。
  • Meshy 3D Printing:プリント可能性の分析と修復、単色および多色の3MF、実寸サイズへのサイズ調整、フィギュア、ランプ、キーホルダー、冷蔵庫マグネットなどのCreative Lab製品、インストール済みスライサーへの引き渡し。

どちらのスキルも、お使いのコンピューター上でMeshy CLIを実行します。このCLIは、npm上のmeshy-cliパッケージです。ブラウザで一度サインインすれば、チャットにAPIキーを貼り付ける必要はありません。

プラグインは、指定したフォルダーにファイルを保存し、レンダリングされたプレビューと、Codexが後続の編集に必要とするタスクIDも一緒に保存します。これらのスキルは、GitHub上のmeshy-3d-agentリポジトリでオープンソースとして公開されています。


始める前に

  • Codexが必要です。これは、ChatGPTデスクトップアプリまたはCodex CLIで使用できます。MeshyプラグインはウェブブラウザのChatGPTでは動作しません。職場または学校のワークスペースでは、管理者がプラグインを許可する必要がある場合があります。

  • Node.js 22.12以降と、npmが必要です。バージョンを確認するには、node --versionを実行してください。Node.jsがインストールされていない、または古い場合は、Node.jsのウェブサイトから最新のLTSリリースをインストールしてください。

  • モデルを生成するには、有料のMeshyプランが必要です。生成タスクを実行するたびにMeshyクレジットが消費されます。モデルの再スケーリングやスライサーでの読み込みなど、ローカルでのプリント処理にはサインインは不要です。


プラグインのインストール

ChatGPTデスクトップアプリにプラグインをインストールするには、以下の手順に従ってください。

  1. ChatGPTデスクトップアプリでCodexに切り替えます。

  2. Pluginsを開きます。

  3. Meshyを検索し、Meshyプラグインを開きます。

  4. Install pluginをクリックします。

    Install plugin ボタンと3つのプロンプト例が表示されたCodex PluginsディレクトリのMeshyプラグインページ

  5. 新しいチャットを開始します。Codexは、インストール後に開いたチャットでのみプラグインを読み込みます。

Codex CLIにプラグインをインストールするには、以下の手順に従ってください。

  1. /pluginsを実行します。

  2. Meshyをインストールします。

  3. 新しいセッションを開始します。

インストールを確認するには、新しいチャットで@と入力してMeshyを探すか、Codexにどのようなスキルが使用できるか尋ねてください。

手順を追ったチュートリアルについては、Codex でMeshyプラグインを使う方法を参照してください。


サインイン

モデルをリクエストすると、プラグインは初回時にMeshy CLIと保存済みのMeshyセッションを確認します。セッションが見つからない場合、CodexはMeshyサインインリンクとワンタイムコードを表示します。

サインインするには、以下の手順に従ってください。

  1. リンクを開きます。

  2. コードの入力を求められた場合は、Codexに表示されたコードをそのままDevice codeに入力し、Continueをクリックします。

  3. Meshyからサインインを求められた場合は、Meshyアカウントにサインインします。

  4. Connect Meshy CLIページでConnectをクリックします。ページにMeshy CLI authorizedと表示されます。

    サインイン済みのアカウント、CLIが取得するアクセス権限、Cancel と Connect ボタンが表示されたConnect Meshy CLI ページ

  5. Codexに戻ります。Codexはリクエストした内容の処理を続行します。

コードの有効期限は10分です。期限が切れた場合は、Codexに新しいコードを依頼してください。Meshy CLIはセッションをコンピューターに保存し、以降のチャットでそれを再利用します。環境変数にMESHY_API_KEYが設定されている場合、CLIはブラウザセッションの代わりにそのAPIキーを使用します。

Codex CLIでは、初回実行時にネットワークアクセスを求められる場合があります。Meshy CLIがMeshy APIにアクセスできるよう、許可してください。


プロンプト例

@Meshyとメンションするか、自分の言葉で作業内容を説明してください。例えば次のようになります。

  • ゲーム用のローポリの宝箱を作成し、ターゲットを2,000三角形にして、PBRテクスチャを追加し、GLBとして./assetsに保存して。
  • この写真をテクスチャ付きの3Dモデルに変換し、比率を保って。(画像を添付)
  • このテクスチャ付きヒューマノイドキャラクターをリギングし、歩行アニメーションを追加して、FBXとしてエクスポートして。
  • ./assets/chest.glbを風化したブロンズにリテクスチャして、元のファイルの隣に保存して。
  • この写真を75mmのフィギュアに変換し、プリント可能性を確認して、対応するスライサー用の多色3MFを準備して。

フォローアップのリクエストでは前回の結果を再利用します。例えば、1,500面のLODを作って、今度はFBXで、150mmにスケールしてなどです。フォルダー名を指定しない場合、プラグインは./meshy_outputにファイルを保存します。


クレジット

生成、テクスチャリング、リメッシュ、リギング、アニメーション、修復は、APIレートでMeshyアカウントからクレジットを消費します。プリント可能性の分析は無料です。各タスクのコストについては、料金を参照してください。

有料ステップの前に、Codexはそのコストを見積もり、承認した額を超えて消費する前に確認を求めます。各有料ステップを自分で承認したい場合は、リクエストにクレジットを使う前に確認してと付け加えてください。残高をいつでも確認するには、Meshyクレジットはいくら残っている?と尋ねてください。


トラブルシューティング

次の表は、よくある問題とその原因、解決方法を示しています。

問題原因対処方法
@と入力してもMeshyが表示されないウェブブラウザのChatGPTを使用しているか、プラグインをインストールする前にチャットを開いていた。ChatGPTデスクトップアプリまたはCodex CLIを使用してください。Codexを再起動し、新しいチャットを開いてください。
CodexがAPIキーを求めてくるプラグインにAPIキーは不要です。ブラウザ経由でサインインします。その要求を拒否し、代わりにブラウザ経由でサインインするようCodexに依頼してください。APIキーをチャットに貼り付けないでください。
nodeまたはnpmが見つからないNode.jsがインストールされていないか、Codexが見つけられない。Node.jsのウェブサイトからNode.js 22.12以降をインストールし、Codexを再起動してください。
サインインコードの期限が切れたコードの有効期限は10分です。Codexにサインインをやり直すよう依頼してください。
プランまたはクレジットが原因でCodexが生成できない生成には有料プランと十分なクレジットが必要です。MeshyウェブアプリのSubscriptionページでプランと残高を確認してください。
間違ったMeshyアカウントにサインインしているMeshy CLIはコンピューターに保存されたセッションを再利用します。Codexにmeshy auth logoutを実行するよう依頼し、その後再度サインインしてください。

FAQ

Codex用Meshyプラグインは無料ですか?
プラグインのインストールは無料です。3Dモデルの生成には有料のMeshyプランが必要で、APIレートでMeshyクレジットを消費します。プリント可能性の分析は無料で、モデルの再スケーリングやスライサーでの読み込みなどのローカル処理にはサインインは不要です。
Meshy APIキーは必要ですか?
いいえ。プラグインはワンタイムコードを使ってブラウザ経由でサインインし、Meshy CLIがセッションをコンピューターに保存します。APIキーをチャットに貼り付けないでください。環境変数にMESHY_API_KEYがすでに設定されている場合、Meshy CLIはブラウザセッションの代わりにそれを使用します。
作成したモデルはどこに保存されますか?
リクエストで指定したフォルダー、指定しない場合は./meshy_outputに、プレビュー画像とタスクIDとともに保存されます。プラグインはファイルをMeshyウェブアプリではなく、お使いのコンピューターに保存します。
プラグインはどのファイル形式をエクスポートできますか?
3DアセットについてはGLB、FBX、OBJ、STL、USDZ、3Dプリント用には単色または多色の3MFです。
プラグインはウェブブラウザのChatGPTで動作しますか?
いいえ。MeshyプラグインはWorkとCodexで動作し、ChatGPTデスクトップアプリまたはCodex CLIで使用します。
プラグインはMeshyのウェブサイトで作成したモデルを認識できますか?
いいえ。Meshyプラグインは、自身が作成したものなど、Meshy APIを通じて作成されたタスクのみを扱います。Meshyのウェブサイトで作成したものを含め、Meshyアカウント内のモデルを表示・ダウンロードするには、Meshy 3Dを使用してください。
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 に従うよう依頼してください。

  • ChatGPTのチャットでモデルを作成するには、ChatGPT用Meshy 3Dを参照してください。

  • Hermes Agentで同じスキルを使うには、Hermes Agent用Meshyスキルを参照してください。

  • OpenClawで同じスキルを使うには、OpenClaw用Meshyスキルを参照してください。

  • 自分のAPIキーを使ってAIエージェントからMeshy APIを呼び出すには、AI連携を参照してください。