Codex용 Meshy 플러그인

Codex에 Meshy 플러그인을 설치하여 채팅으로 3D 모델을 생성하고 텍스처를 입힌 다음, 파일을 프로젝트에 저장하세요.

개요

Meshy 플러그인은 ChatGPT와 Codex가 공유하는 플러그인 디렉터리에 있습니다. 두 가지 스킬을 제공합니다:

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 리포지터리에 오픈 소스로 공개되어 있습니다.

시작하기 전에

ChatGPT 데스크톱 앱 또는 Codex CLI에서 Codex가 필요합니다. Meshy 플러그인은 웹 브라우저의 ChatGPT에서는 실행되지 않습니다. 회사 또는 학교 작업 공간에서는 관리자가 플러그인을 허용해야 할 수 있습니다.
Node.js 22.12 이상과 npm이 필요합니다. 버전을 확인하려면 node --version을 실행하세요. Node.js가 없거나 버전이 낮다면 Node.js 웹사이트에서 최신 LTS 릴리스를 설치하세요.
모델을 생성하려면 유료 Meshy 플랜이 필요합니다. 생성 작업을 수행할 때마다 Meshy 크레딧이 소모됩니다. 모델 크기 재조정이나 슬라이서에서 모델 열기 같은 로컬 프린팅 단계는 로그인이 필요하지 않습니다.

플러그인 설치

ChatGPT 데스크톱 앱에 플러그인을 설치하려면 다음 단계를 따르세요:

ChatGPT 데스크톱 앱에서 Codex로 전환합니다.
Plugins를 엽니다.
Meshy를 검색한 다음 Meshy 플러그인을 엽니다.
Install plugin을 클릭합니다.
새 채팅을 시작합니다. Codex는 설치 이후에 연 채팅에서만 플러그인을 불러옵니다.

Codex CLI에 플러그인을 설치하려면 다음 단계를 따르세요:

/plugins를 실행합니다.
Meshy를 설치합니다.
새 세션을 시작합니다.

설치를 확인하려면 새 채팅에서 @를 입력하고 Meshy를 찾거나, Codex에 어떤 Meshy 스킬을 사용할 수 있는지 물어보세요.

단계별 튜토리얼은 How to Use Meshy Plugin in Codex를 참고하세요.

처음 모델을 요청하면 플러그인이 Meshy CLI와 저장된 Meshy 세션이 있는지 확인합니다. 세션을 찾지 못하면 Codex가 Meshy 로그인 링크와 일회용 코드를 ��시합니다.

로그인하려면 다음 단계를 따르세요:

링크를 엽니다.
페이지에서 코드를 요구하면 Codex가 보여주는 그대로 Device code에 코드를 입력한 다음 Continue를 클릭합니다.
Meshy가 로그인을 요청하면 Meshy 계정으로 로그인합니다.
Connect Meshy CLI 페이지에서 Connect를 클릭합니다. 페이지에 Meshy CLI authorized가 표시됩니다.
Codex로 돌아갑니다. Codex가 요청했던 작업을 이어서 진행합니다.

코드는 10분 후 만료됩니다. 만료되면 Codex에 새 코드를 요청하세요. Meshy CLI는 세션을 컴퓨터에 저장하고 이후 채팅에서 재사용합니다. 환경 변수에 MESHY_API_KEY가 설정되어 있으면 CLI는 브라우저 세션 대신 해당 API 키를 사용합니다.

Codex CLI에서는 첫 실행 시 네트워크 접근을 요청할 수 있습니다. Meshy CLI가 Meshy API에 접근할 수 있도록 승인하세요.

예시 프롬프트

@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를 사용 중이거나, 플러그인을 설치하기 전에 채팅이 열려 있었습니다.	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 플러그인은 ChatGPT 데스크톱 앱 또는 Codex CLI의 Codex에서 실행됩니다.
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를 따르도록 요청하세요.

Hermes Agent에서 동일한 스킬을 사용하려면 Hermes Agent용 Meshy 스킬을 참고하세요.
OpenClaw에서 동일한 스킬을 사용하려면 OpenClaw용 Meshy 스킬을 참고하세요.
자신의 API 키로 AI 에이전트에서 Meshy API를 호출하려면 AI 연동을 참고하세요.