Codex Design 설치하기.
프롬프트 하나면 시작할 수 있습니다. 새 Codex 대화에 붙여넣으면 에이전트가 플러그인을 설치합니다.
/goal https://codexdesign.io/install.md 문서를 읽고 Codex에 Codex Design을 설치해 줘.에이전트용 텍스트 설치 안내 ↗01 / 설치 전에
플러그인을 지원하는 Codex, Codex CLI, Git, 그리고 MCP 프로세스 PATH에 Node.js 22.12 이상이 있어야 합니다. 설치 전에 다음을 확인하세요.
codex plugin --help git --version node --version
기본 패키지는 macOS와 Linux를 대상으로 합니다. Windows 네이티브 환경을 위한 PowerShell 런처와 .mcp.windows.json이 포함되어 있지만, Windows에서는 처음부터 끝까지 검증되지 않았습니다. 플랫폼별 변경을 하기 전에 이 제한 사항을 먼저 설명하세요.
02 / 에이전트를 위한 안내
플러그인은 main 브랜치의 공개 Git 마켓플레이스 ummydev/codexdesign을 통해 배포됩니다. GitHub 계정이나 비공개 저장소 접근 권한은 필요하지 않습니다.
이 원격 저장소의 Git 마켓플레이스에서 설치하세요. 다음 명령어를 순서대로 실행합니다.
codex plugin marketplace add ummydev/codexdesign --ref main codex plugin add codexdesign@codexdesign-github codex plugin list
공개 저장소는 ummydev/codexdesign입니다. 플러그인 식별자는 codexdesign, 마켓플레이스 이름은 codexdesign-github입니다. 릴리스는 main 브랜치의 plugins/codexdesign/에 있습니다.
마켓플레이스가 이미 있다면 codex plugin marketplace list를 확인해 저장소와 브랜치가 일치하는지 확인한 뒤 다음을 사용하세요.
codex plugin marketplace upgrade codexdesign-github codex plugin add codexdesign@codexdesign-github codex plugin list
이전에 ummydev/codexcanvas의 비공개 프리뷰를 설치했다면 텍스트 가이드의 마켓플레이스 마이그레이션 절차를 따르세요. 플러그인이 설치되어 활성화되었는지 확인하고, 가능하면 버전을 알려 주세요. 필요한 명령어가 실패하면 성공했다고 하지 말고 해당 명령어와 오류를 알려 주세요.
- 로컬 개발용 체크아웃이나 개인 마켓플레이스가 아니라 원격 Git 마켓플레이스를 사용하세요.
- 작업 공간, 마켓플레이스 스냅샷, 플러그인 캐시에서 npm install, npm ci 등 빌드 명령어를 실행하지 마세요.
- React Flow 등 의존성을 직접 설치하지 마세요. 플러그인에는 미리 빌드된 MCP 서버와 프런트엔드가 포함되어 있습니다.
- 오류를 우회하려고 개인 마켓플레이스에 클론하거나 소스에서 빌드하지 마세요.
- 필수 요소가 없으면 무엇이 빠졌는지 설명하세요. 다른 런타임을 몰래 설치하지 마세요.
- 사용자의 캔버스 프로젝트와 설정은 그대로 유지하세요.
03 / 다시 시작하고 만들기
설치가 끝나면 Codex를 완전히 종료한 뒤 다시 시작하세요. 플러그인의 스킬과 도구가 로드되도록 새 대화를 열고 다음을 입력해 보세요.
Codex Design으로 로그인 페이지 디자인 방향 3가지를 탐색하고 캔버스를 열어 줘.
에이전트: 사용자에게 다시 시작하라고 알려 주세요. 현재 대화에서 새 도구를 바로 쓸 수 있다고 가정하지 마세요. 별도 작업은 사용자가 명시적으로 요청하고 호스트가 지원할 때만 만드세요.
작업 공간을 최신 상태로 유지하기
캔버스 데몬은 Codex와 별개로 실행됩니다. 업데이트 전에 이전 Codex Design 데몬이 실행 중이라면, 설치된 플러그인 위치를 찾아 해당 디렉터리에서 node scripts/start.cjs stop을 실행하세요. 마켓플레이스를 새로고침하고 위 명령어로 다시 설치한 다음, Codex를 다시 시작하고 새 대화를 여세요.
추가 API 키 없이. 작업물은 온전히 내 것으로.
플러그인 전용 토큰 충전은 없습니다. Codex 이용 권한, 요금제 한도, 해당되는 사용 요금은 그대로 적용됩니다. 모델을 무제한 무료로 쓸 수 있다는 뜻은 아닙니다.
캔버스 프로젝트와 에셋은 로컬에 저장되며, 기본 위치는 ~/.codex-design-plugin/projects입니다. Codex에 공유한 컨텍스트나 파일을 Codex가 처리하는 방식은 바뀌지 않습니다. 플러그인을 업데이트해도 프로젝트 데이터를 지울 필요는 없습니다.