설계를 화면으로 옮기는 도구 사용법

여러 AI 코딩 도구로 디자인을 코드로 옮깁니다

설계 문서와 Figma 디자인이 준비되면, AI 코딩 도구에 이를 전달해 화면을 만듭니다. 이 교안은 Antigravity IDE, Cursor, Codex, Claude Code 같은 도구의 설치, Figma MCP 연결, 구동 방법을 도구마다 정리합니다.

대상: 설계를 마친 학습자준비물: 설계 문서·Figma 디자인결과물: 도구로 만든 화면
전체 흐름부터 보기

먼저 이해하기

도구는 달라도 흐름은 같습니다

도구는 달라도 순서는 같습니다. 도구를 설치하고, Figma MCP를 연결하고, 설계 문서를 읽게 한 뒤, 화면을 요청하고 검수합니다. 이 교안은 그중 도구마다 다른 설치와 연결 방법에 집중합니다.

공통으로 먼저 준비합니다

설계 문서

설계 교안에서 만든 디자인 분석표·PRD·규칙 문서를 프로젝트 폴더에 둡니다.

Figma 디자인

구현할 화면이 있는 Figma 파일과, 붙여넣을 프레임의 링크를 준비합니다.

Node.js

버전 18 이상을 설치합니다. 일부 도구는 명령 실행에 Node.js가 필요합니다.

각 도구 계정

사용할 도구의 로그인 계정을 준비합니다. 계정은 도구마다 다릅니다.

도구를 한눈에 비교합니다

도구 비교
항목Antigravity IDECursorCodexClaude Code
만든 곳GoogleAnysphereOpenAIAnthropic
로그인 계정구글 계정(무료)Cursor 계정ChatGPT 계정Claude 계정
실행 방식IDE 앱IDE 앱터미널터미널
Figma 등록설정 파일에 직접 등록설정 파일에 직접 등록터미널 명령으로 등록플러그인 설치(권장) 또는 명령 등록
화면과 명령은 자주 바뀝니다

이 교안의 단계는 현재 공식 문서 기준입니다. 실제 화면이 다르면 각 도구의 공식 문서와 아래 캡처를 함께 확인하세요.

공통 준비

Figma MCP를 이해합니다

이 교안은 설치가 필요 없는 원격 서버를 사용합니다. 세 도구 모두 같은 주소를 등록하고, 도구마다 등록 방법만 다릅니다.

MCP가 가져오는 정보

get_metadata

선택한 화면의 구조와 노드 정보를 가져옵니다.

get_design_context

선택한 화면을 코드로 옮길 때 필요한 맥락을 가져옵니다.

get_variable_defs

색상, 타이포그래피, 간격 같은 디자인 변수를 가져옵니다.

get_screenshot

선택한 화면의 시각 참고 이미지를 가져옵니다.

링크로 화면을 알려줍니다

원격 Figma MCP는 링크 기반입니다. Figma에서 프레임을 선택해 링크를 복사하고, 도구에 그 링크를 붙여넣어 어떤 화면을 볼지 알려줍니다.

화면 캡처 자리Figma에서 프레임 선택 후 링크 복사 화면
사용량 주의

무료(Starter) 계정은 월 도구 호출 수에 제한이 있습니다. 실습용으로는 충분하지만, 많이 사용하면 유료 좌석이 필요할 수 있습니다.

도구 Google

Antigravity IDE로 만들기

구글이 만든 에이전트형 IDE입니다. 에디터 안의 에이전트가 파일을 직접 만들고 수정합니다.

로그인: 구글 계정(무료)Figma 등록: 설정 파일에 직접 등록

설치와 로그인

  1. 1

    공식 사이트 antigravity.google에서 설치 파일을 받아 설치합니다.

  2. 2

    처음 실행하면 구글 계정으로 로그인합니다. 무료 계정으로 시작할 수 있습니다.

  3. 3

    만들 프로젝트 폴더를 엽니다.

화면 캡처 자리Antigravity IDE 설치·구글 로그인 화면

Figma MCP 연결

에이전트 사이드 패널의 "…" 메뉴에서 MCP Servers, Manage MCP Servers, View raw config 순서로 설정 파일을 엽니다.

mcp_config.jsonmcp_config.json
{
  "mcpServers": {
    "figma": {
      "serverUrl": "https://mcp.figma.com/mcp"
    }
  }
}
연결 확인

Antigravity IDE는 원격 MCP 주소에 url이 아니라 serverUrl 키를 사용합니다. 저장한 뒤 Installed MCP Servers에서 새로고침하면 figma가 연결됩니다. MCP 서버 목록에 figma가 연결됨으로 표시되면 성공입니다.

화면 캡처 자리Antigravity IDE MCP 설정 파일(View raw config) 화면

구동

에이전트 패널에 설계 문서를 먼저 읽게 한 뒤, Figma 링크와 함께 화면을 요청합니다. 에이전트가 파일을 만들면 브라우저에서 결과를 확인합니다.

도구 Anysphere

Cursor로 만들기

AI 기능이 들어간 코드 에디터입니다. 설정에서 MCP 서버를 추가해 사용합니다.

로그인: Cursor 계정Figma 등록: 설정 파일에 직접 등록

설치와 로그인

  1. 1

    공식 사이트 cursor.com에서 설치 파일을 받아 설치합니다.

  2. 2

    Cursor 계정으로 로그인합니다.

  3. 3

    만들 프로젝트 폴더를 엽니다.

화면 캡처 자리Cursor 설치·로그인 화면

Figma MCP 연결

Settings의 MCP에서 새 서버를 추가하거나, 프로젝트의 .cursor/mcp.json 파일을 직접 엽니다.

mcp.jsonmcp.json
{
  "mcpServers": {
    "figma": {
      "url": "https://mcp.figma.com/mcp"
    }
  }
}
연결 확인

Cursor는 원격 MCP 주소에 url 키를 사용합니다. Antigravity IDE의 serverUrl과 키 이름이 다르니 주의합니다. MCP 설정에서 figma 옆에 초록색 상태 점이 보이면 성공입니다.

화면 캡처 자리Cursor Settings의 MCP 설정 화면

구동

설계 문서를 먼저 읽게 한 뒤, Figma 링크와 함께 화면 구현을 요청합니다. 한 번에 전체가 아니라 화면 단위로 나눠 요청합니다.

도구 OpenAI

Codex로 만들기

OpenAI의 코딩 에이전트입니다. 터미널에서 명령으로 실행하고 설정합니다.

로그인: ChatGPT 계정Figma 등록: 터미널 명령으로 등록

설치와 로그인

  1. 1

    공식 안내에 따라 Codex를 설치합니다.

  2. 2

    ChatGPT 계정으로 로그인합니다.

  3. 3

    작업할 프로젝트 폴더에서 실행합니다.

Figma MCP 연결

프로젝트 폴더의 터미널에서 아래 명령을 실행합니다.

Codex에 Figma 등록
codex mcp add figma --url https://mcp.figma.com/mcp
연결 확인

명령을 실행하면 인증을 요청합니다. 안내에 따라 Figma 계정으로 인증합니다. 등록한 뒤 Codex의 MCP 목록에 figma가 보이면 성공입니다.

화면 캡처 자리Codex codex mcp add 실행·인증 화면

구동

설계 문서를 먼저 읽게 한 뒤, Figma 링크와 함께 화면 구현을 요청합니다. 한 번에 전체가 아니라 화면 단위로 나눠 요청합니다.

도구 Anthropic

Claude Code로 만들기

Anthropic의 코딩 에이전트입니다. 터미널에서 실행하며, 플러그인으로 Figma 연결과 작업 스킬을 함께 설치할 수 있습니다.

로그인: Claude 계정Figma 등록: 플러그인 설치(권장) 또는 명령 등록

설치와 로그인

  1. 1

    공식 안내에 따라 Claude Code를 설치합니다.

  2. 2

    Claude 계정으로 로그인합니다.

  3. 3

    작업할 프로젝트 폴더에서 실행합니다.

Figma MCP 연결

권장 방법은 Figma 플러그인 설치입니다. 플러그인에는 MCP 연결과 자주 쓰는 작업 스킬이 함께 들어 있습니다.

Claude Code에 Figma 연결
# 권장: 플러그인 설치
claude plugin install figma@claude-plugins-official

# 또는 원격 서버 직접 등록
claude mcp add --transport http figma https://mcp.figma.com/mcp
연결 확인

명령으로 등록했다면 /mcp를 입력해 figma를 선택하고 Authenticate를 누릅니다. 브라우저가 열리면 계정으로 로그인해 접근을 허용합니다. claude mcp list에 figma가 보이거나 /mcp에서 연결됨으로 표시되면 성공입니다.

화면 캡처 자리Claude Code /mcp 인증 화면

구동

설계 문서를 먼저 읽게 한 뒤, Figma 링크와 함께 화면 구현을 요청합니다. 여러 파일을 만드는 작업은 계획을 먼저 세우게 합니다.

공통

도구에 전달할 작업 요청문

도구가 달라도 요청하는 방식은 같습니다. 아래 요청문을 순서대로 사용하면 도구가 설계 문서를 먼저 읽고, 디자인을 확인한 뒤, 화면 단위로 나눠 구현합니다.

프로젝트와 규칙 먼저 확인하기
프로젝트와 규칙 먼저 확인하기
아직 코드를 수정하지 마세요.

현재 프로젝트의 PRD.md와 지침 파일을 읽고 다음을 확인해 주세요.

1. 폴더 구조와 시작 파일
2. 사용 중인 기술과 패키지
3. 공통 CSS 변수와 디자인 토큰
4. 재사용할 수 있는 컴포넌트와 유틸리티
5. 이미지, 아이콘, 폰트 에셋
6. 실행, 빌드, 테스트 명령
7. 이번 작업에 영향을 주는 추가 규칙 파일

확인한 사실과 아직 확인하지 못한 내용을 나눠서 보고해 주세요.
코드는 수정하지 마세요.

공통 작업 규칙:
- PRD.md와 프로젝트 지침 파일을 먼저 읽어 주세요.
- 작업 전 기존 폴더 구조, 공통 스타일, 에셋, 패키지를 확인해 주세요.
- 확인된 사실과 추정을 구분해 주세요.
- 디자인에 없는 기능과 에셋을 임의로 만들지 마세요.
- 기존 코드와 공통 컴포넌트를 우선 재사용해 주세요.
- CSS class와 HTML id는 snake_case, JavaScript 변수와 함수는 camelCase로 작성해 주세요.
- 수정 후 360px, 768px, 1280px 화면과 키보드 포커스, 콘솔 오류를 확인해 주세요.
- 결과에는 변경 파일, 구현 내용, 검증 결과, 확인하지 못한 부분을 구분해 작성해 주세요.
디자인 분석과 구현 계획 만들기
디자인 분석과 구현 계획 만들기
제공한 디자인을 분석하고 구현 계획을 작성해 주세요.

디자인 자료: [Figma 링크 또는 이미지 경로]
이번 작업 화면: [화면 이름]

다음을 확인해 주세요.

1. 페이지와 공통 영역 구조
2. 색상, 폰트, 간격, 라운드, 그림자
3. 모바일, 태블릿, 데스크톱 배치 변화
4. hover, focus, active, disabled 상태
5. 로딩, 빈 상태, 오류 상태
6. 실제로 필요한 이미지, 아이콘, 폰트
7. 기존 코드에서 재사용할 부분
8. 수정할 파일과 수정하지 않을 파일

디자인에서 직접 확인한 내용과 추정한 내용을 구분해 주세요.
모르는 내용을 임의로 결정하지 말고 질문 목록으로 남겨 주세요.
아직 코드는 수정하지 마세요.

공통 작업 규칙:
- PRD.md와 프로젝트 지침 파일을 먼저 읽어 주세요.
- 작업 전 기존 폴더 구조, 공통 스타일, 에셋, 패키지를 확인해 주세요.
- 확인된 사실과 추정을 구분해 주세요.
- 디자인에 없는 기능과 에셋을 임의로 만들지 마세요.
- 기존 코드와 공통 컴포넌트를 우선 재사용해 주세요.
- CSS class와 HTML id는 snake_case, JavaScript 변수와 함수는 camelCase로 작성해 주세요.
- 수정 후 360px, 768px, 1280px 화면과 키보드 포커스, 콘솔 오류를 확인해 주세요.
- 결과에는 변경 파일, 구현 내용, 검증 결과, 확인하지 못한 부분을 구분해 작성해 주세요.
Figma MCP로 디자인 확인하기
Figma MCP로 디자인 확인하기
Figma MCP로 아래 디자인을 확인해 주세요.

대상: [Figma 프레임 링크]

다음 순서를 지켜 주세요.

1. metadata로 프레임과 레이어 구조를 확인합니다.
2. screenshot으로 실제 화면을 확인합니다.
3. variable 정의로 색상, 간격, 타이포 토큰을 확인합니다.
4. design context로 구현에 필요한 속성을 확인합니다.
5. 실제 이미지와 아이콘 에셋을 확인하고 제공된 방식으로 가져옵니다.
6. 현재 프로젝트의 HTML, CSS, JavaScript 구조에 맞는 구현 계획을 작성합니다.

MCP가 보여주는 React 또는 Tailwind 예시를 그대로 사용하지 마세요.
디자인 스크린샷을 배경 이미지로 붙이지 마세요.
모든 요소를 absolute로 배치하지 마세요.
확인한 값과 확인하지 못한 값을 구분해서 보고해 주세요.

공통 작업 규칙:
- PRD.md와 프로젝트 지침 파일을 먼저 읽어 주세요.
- 작업 전 기존 폴더 구조, 공통 스타일, 에셋, 패키지를 확인해 주세요.
- 확인된 사실과 추정을 구분해 주세요.
- 디자인에 없는 기능과 에셋을 임의로 만들지 마세요.
- 기존 코드와 공통 컴포넌트를 우선 재사용해 주세요.
- CSS class와 HTML id는 snake_case, JavaScript 변수와 함수는 camelCase로 작성해 주세요.
- 수정 후 360px, 768px, 1280px 화면과 키보드 포커스, 콘솔 오류를 확인해 주세요.
- 결과에는 변경 파일, 구현 내용, 검증 결과, 확인하지 못한 부분을 구분해 작성해 주세요.
공통 구조와 첫 화면 구현하기
공통 구조와 첫 화면 구현하기
[화면 이름]의 공통 구조와 기본 레이아웃을 구현해 주세요.

구현 범위:
- 시맨틱 HTML 구조
- 기존 디자인 토큰을 사용한 기본 CSS
- 360px, 768px, 1280px 반응형 배치
- 실제 로고, 이미지, 아이콘, 폰트 연결
- 기본, hover, focus-visible, disabled 상태

이번 단계에서는 디자인에 없는 인터랙션이나 새 기능을 추가하지 마세요.
기존 헤더, 푸터, 버튼, 카드가 있으면 재사용해 주세요.
구현 후 브라우저 화면을 디자인 시안과 비교하고 차이를 보고해 주세요.

공통 작업 규칙:
- PRD.md와 프로젝트 지침 파일을 먼저 읽어 주세요.
- 작업 전 기존 폴더 구조, 공통 스타일, 에셋, 패키지를 확인해 주세요.
- 확인된 사실과 추정을 구분해 주세요.
- 디자인에 없는 기능과 에셋을 임의로 만들지 마세요.
- 기존 코드와 공통 컴포넌트를 우선 재사용해 주세요.
- CSS class와 HTML id는 snake_case, JavaScript 변수와 함수는 camelCase로 작성해 주세요.
- 수정 후 360px, 768px, 1280px 화면과 키보드 포커스, 콘솔 오류를 확인해 주세요.
- 결과에는 변경 파일, 구현 내용, 검증 결과, 확인하지 못한 부분을 구분해 작성해 주세요.
필요한 인터랙션만 구현하기
필요한 인터랙션만 구현하기
[화면 이름]에 디자인과 PRD에 명시된 인터랙션만 구현해 주세요.

필요한 동작:
- [메뉴 열기와 닫기]
- [탭 또는 필터 선택]
- [폼 입력과 오류 표시]
- [슬라이더 또는 스크롤 모션]

먼저 CSS와 기본 JavaScript로 구현 가능한지 확인해 주세요.
외부 라이브러리는 package.json에 이미 있거나 PRD에 명시된 경우에만 사용해 주세요.
모션이 없어도 콘텐츠와 기능을 사용할 수 있어야 하며 prefers-reduced-motion을 반영해 주세요.
키보드 Enter, Space, Tab으로 주요 동작을 확인해 주세요.

공통 작업 규칙:
- PRD.md와 프로젝트 지침 파일을 먼저 읽어 주세요.
- 작업 전 기존 폴더 구조, 공통 스타일, 에셋, 패키지를 확인해 주세요.
- 확인된 사실과 추정을 구분해 주세요.
- 디자인에 없는 기능과 에셋을 임의로 만들지 마세요.
- 기존 코드와 공통 컴포넌트를 우선 재사용해 주세요.
- CSS class와 HTML id는 snake_case, JavaScript 변수와 함수는 camelCase로 작성해 주세요.
- 수정 후 360px, 768px, 1280px 화면과 키보드 포커스, 콘솔 오류를 확인해 주세요.
- 결과에는 변경 파일, 구현 내용, 검증 결과, 확인하지 못한 부분을 구분해 작성해 주세요.
완성 결과 검수하기
완성 결과 검수하기
코드를 수정하기 전에 현재 구현을 검수해 주세요.

검수 기준:
1. 디자인 시안과 레이아웃, 간격, 정렬, 색상, 폰트 비교
2. 360px, 768px, 1280px의 잘림, 겹침, 가로 스크롤
3. 모든 링크, 버튼, 폼, 메뉴의 실제 동작
4. hover, focus, active, disabled 상태
5. 로딩, 빈 상태, 오류 상태
6. 키보드 Tab 순서와 focus-visible
7. 의미 있는 이미지 alt와 폼 label
8. 모션 감소 설정
9. 콘솔 오류와 임시 console.log
10. 임의 기능, 임의 에셋, 존재하지 않는 URL 추가 여부

문제마다 재현 위치, 원인, 영향, 수정할 파일을 적어 주세요.
확인하지 못한 항목은 통과로 표시하지 마세요.

공통 작업 규칙:
- PRD.md와 프로젝트 지침 파일을 먼저 읽어 주세요.
- 작업 전 기존 폴더 구조, 공통 스타일, 에셋, 패키지를 확인해 주세요.
- 확인된 사실과 추정을 구분해 주세요.
- 디자인에 없는 기능과 에셋을 임의로 만들지 마세요.
- 기존 코드와 공통 컴포넌트를 우선 재사용해 주세요.
- CSS class와 HTML id는 snake_case, JavaScript 변수와 함수는 camelCase로 작성해 주세요.
- 수정 후 360px, 768px, 1280px 화면과 키보드 포커스, 콘솔 오류를 확인해 주세요.
- 결과에는 변경 파일, 구현 내용, 검증 결과, 확인하지 못한 부분을 구분해 작성해 주세요.
검수에서 발견한 문제 수정하기
검수에서 발견한 문제 수정하기
방금 검수에서 확인한 문제만 수정해 주세요.

수정 대상:
- [문제 1]
- [문제 2]
- [문제 3]

관련 없는 리팩터링이나 디자인 변경은 하지 마세요.
각 문제를 재현하는 테스트가 가능하면 먼저 실패하는 테스트를 작성해 주세요.
수정 후 같은 조건으로 다시 검증하고 전후 결과를 비교해 주세요.
남아 있는 문제와 확인하지 못한 부분을 숨기지 말고 보고해 주세요.

공통 작업 규칙:
- PRD.md와 프로젝트 지침 파일을 먼저 읽어 주세요.
- 작업 전 기존 폴더 구조, 공통 스타일, 에셋, 패키지를 확인해 주세요.
- 확인된 사실과 추정을 구분해 주세요.
- 디자인에 없는 기능과 에셋을 임의로 만들지 마세요.
- 기존 코드와 공통 컴포넌트를 우선 재사용해 주세요.
- CSS class와 HTML id는 snake_case, JavaScript 변수와 함수는 camelCase로 작성해 주세요.
- 수정 후 360px, 768px, 1280px 화면과 키보드 포커스, 콘솔 오류를 확인해 주세요.
- 결과에는 변경 파일, 구현 내용, 검증 결과, 확인하지 못한 부분을 구분해 작성해 주세요.

인터랙션

움직임은 필요한 것만 넣습니다

디자인에 실제로 있는 동작만 구현합니다. CSS와 기본 JavaScript로 되는 동작은 라이브러리 없이 만들고, 복잡한 모션이 필요할 때만 아래 라이브러리를 골라 요청문에 적습니다.

인터랙션 라이브러리 선택
라이브러리언제 사용로드 방법
GSAP복잡한 등장·전환 모션이 있을 때공식 CDN script
ScrollTrigger스크롤 위치와 연결된 모션GSAP 플러그인
Lenis부드러운 스크롤이 요구사항일 때공식 CDN script
Swiper실제 슬라이더·갤러리공식 CDN script + CSS
SplitType글자 단위 텍스트 애니메이션공식 CDN script
Lottie디자이너가 준 JSON 모션lottie-web CDN script
Three.js3D 또는 캔버스 배경공식 CDN 또는 모듈
과한 모션은 넣지 않습니다

디자인에 없는 장식용 애니메이션은 만들지 않고, prefers-reduced-motion 설정을 반영합니다.

검수

만든 화면을 디자인과 대조합니다

도구가 만든 코드를 그대로 믿지 않고, 브라우저에서 직접 확인합니다.

구동 후 검수 항목
확인방법
디자인 일치브라우저 화면을 Figma 스크린샷과 나란히 비교합니다.
반응형360px, 768px, 1280px에서 잘림·겹침·가로 스크롤을 확인합니다.
인터랙션실제로 넣기로 한 동작만 동작하는지, 과한 모션은 없는지 확인합니다.
접근성키보드 Tab 순서와 focus-visible, 모션 감소 설정을 확인합니다.
콘솔브라우저 콘솔 오류와 남은 console.log를 확인합니다.

마무리

도구 하나를 골라 끝까지 해봅니다

  1. 1

    도구 하나를 골라 설치하고 계정으로 로그인합니다.

  2. 2

    Figma MCP를 등록하고 연결됨을 확인합니다.

  3. 3

    설계 문서를 읽게 한 뒤 Figma 링크로 첫 화면을 요청합니다.

  4. 4

    결과를 디자인과 대조해 검수합니다.

도구 사용 과정 완료 확인
  • 도구를 설치하고 계정으로 로그인했습니다.
  • Figma MCP를 등록하고 연결됨을 확인했습니다.
  • 설계 문서를 먼저 읽게 한 뒤 화면을 요청했습니다.
  • 화면 단위로 나눠 요청하고 결과를 검수했습니다.
  • 디자인·반응형·인터랙션·접근성·콘솔을 확인했습니다.

다음 과정

도구를 익혔다면 통합 실전으로 이어집니다

다음 과정에서는 디자인만 있는 상태에서 설계·도구·배포를 하나로 이어 GitHub Pages에 사이트를 올립니다.

Antigravity IDE·Cursor·Codex·Claude Code로 배우는 AI 코딩 도구 사용법 | 복붙랩