Codex용 Meshy 플러그인

Codex용 공식 Meshy 플러그인은 채팅을 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 키를 붙여 넣을 필요가 없습니다. 파일은 지정한 폴더에 저장되며, 렌더링된 미리 보기와 후속 편집에 필요한 작업 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로 돌아오면 요청한 작업이 계속 진행됩니다.

Meshy CLI 연결 페이지

코드는 10분 후 만료되며, 만료된 경우 Codex에게 새 코드를 요청하세요. Meshy CLI는 세션을 컴퓨터에 저장해 두고 이후 채팅에서 재사용합니다. 환경에 MESHY_API_KEY가 설정되어 있으면 브라우저 세션보다 우선 적용됩니다.


예시 프롬프트

@Meshy를 언급하거나 작업 내용을 설명해 보세요:

  • 내 게임용 로우폴리 보물 상자를 만들어 줘. 삼각형 2,000개를 목표로 하고 PBR 텍스처를 추가한 다음 ./assets에 GLB로 저장해.
  • 이 사진을 텍스처가 입혀진 3D 모델로 바꾸고 비율을 유지해 줘. (이미지 첨부)
  • 이 텍스처가 입혀진 휴머노이드 캐릭터에 리깅을 적용하고 걷는 애니메이션을 추가한 다음 FBX로 내보내 줘.
  • ./assets/chest.glb를 풍화된 청동으로 리텍스처하고 원본 옆에 저장해 줘.
  • 이 사진을 75mm 피규어로 만들고 프린팅 가능성을 확인한 다음 호환되는 슬라이서용 다색 3MF를 준비해 줘.

후속 요청은 이전 결과를 재사용합니다: 1,500면짜리 LOD를 만들어 줘, 이번엔 FBX로, 150mm로 크기를 조정해 줘. 폴더를 지정하지 않으면 파일은 ./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을 실행하도록 요청한 다음 다시 로그인하세요.

FAQ

Is the Meshy plugin for Codex free?
The plugin is free to install. Generating 3D models requires a paid Meshy plan and spends Meshy credits at API rates. Printability analysis is free, and local steps such as rescaling a model or opening it in a slicer need no sign-in.
Do I need a Meshy API key?
No. The plugin signs in through your browser with a one-time code, and the Meshy CLI stores the session on your computer. Never paste an API key into a chat. If MESHY_API_KEY is already set in your environment, it is used instead of the browser session.
Where are my models saved?
In the folder you name in your request, or ./meshy_output when you don't name one, together with a preview image and the task IDs. Files are saved on your computer, not in your Meshy web workspace.
Which file formats can the plugin export?
GLB, FBX, OBJ, STL and USDZ for 3D assets, and single-color or multicolor 3MF for 3D printing.
Does the plugin work in the ChatGPT chat in a browser?
No. Plugins run in Codex, in the ChatGPT desktop app or the Codex CLI.
Can I use the same Meshy skills in Claude Code or Cursor?
Yes. The skills are open source in the meshy-3d-agent repository on GitHub and install into Claude Code, Cursor, Gemini CLI and other agents. Ask your agent to follow https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md.