Codex에서 Figma 쓰는 법
Codex는 Figma의 MCP 서버를 통해 디자인을 읽고, 캔버스에 다시 쓸 수도 있습니다. 가장 쉬운 방법은 Codex 앱에 공식 Figma 플러그인을 설치하는 것이고, CLI에서는 명령 한 줄이면 됩니다. 설정 방법, 할 수 있는 일, 비용, 그리고 Figma 플러그인이 안 보이거나 쓰기가 안 될 때 확인할 것을 정리했습니다.
2026년 11월 8일 업데이트 · 7분 분량
짧게 답하자면
- Codex 앱: 왼쪽 위의 Plugins를 클릭하고, Figma 옆의 +, Install Figma, Allow access 순서로 클릭하세요. Figma의 스킬도 함께 설치됩니다.
- Codex CLI:
codex mcp add figma --url https://mcp.figma.com/mcp를 실행하고, 요청이 나오면 Figma에 로그인하세요. Figma 스킬은 따로 추가합니다. - 그다음 Figma 링크를 붙여 넣으세요. 프레임이나 레이어 하나를 가리키는 링크를 주고 Codex에게 만들어 달라고 하면 됩니다. 실행 중인 페이지를 편집 가능한 레이어로 Figma에 다시 보낼 수도 있습니다.
- 한도는 Figma 시트에 따라 다릅니다. 유료 플랜의 Dev나 Full 시트는 읽기 호출이 하루 200회 이상, Starter 플랜과 View·Collab 시트는 한 달 20회입니다.
Figma와 OpenAI는 2026년 2월 26일에 Codex 연동을 발표했습니다. 아래 단계는 Figma 도움말 Codex and Figma: Set up the MCP server와 개발자 문서를 기준으로 합니다(2026년 11월 8일 기준).
Codex가 Figma로 할 수 있는 일
Figma에서 읽기(디자인을 코드로). 프레임이나 선택 영역의 디자인 컨텍스트를 가져옵니다. 레이아웃, 컴포넌트, 변수와 스타일, 스크린샷, 에셋, FigJam 다이어그램, Make 리소스입니다. 팀이 Code Connect를 쓴다면 각 Figma 컴포넌트가 어떤 코드 컴포넌트에 대응하는지도 알 수 있어, 새로 만들지 않고 기존 컴포넌트를 재사용합니다.
Figma에 쓰기(코드를 디자인으로). 원격 서버에서는 파일 만들기, 프레임·컴포넌트·변수·오토 레이아웃 만들기와 수정, 이미지와 SVG 넣기, 그리고 실행 중인 웹 페이지를 편집 가능한 Figma 레이어로 바꾸기가 가능합니다.
자주 쓰는 도구:
| 도구 | 하는 일 | 종류 |
|---|---|---|
get_design_context | 레이어나 선택 영역의 디자인 컨텍스트와 코드 | 읽기 |
get_screenshot | 비교용 선택 영역 스크린샷 | 읽기 |
get_variable_defs | 선택 영역에 쓰인 변수와 스타일 | 읽기 |
search_design_system | 라이브러리에서 컴포넌트, 변수, 스타일 검색 | 읽기 |
use_figma | Figma 파일의 내용을 만들고 수정하고 확인 | 쓰기 |
generate_figma_design | 실행 중인 웹 UI를 Figma 디자인 레이어로 변환 | 쓰기 |
create_new_file | 빈 Design, FigJam, Slides 파일 만들기 | 쓰기 |
upload_assets | 이미지와 SVG를 파일에 업로드 | 쓰기 |
use_figma를 포함한 쓰기 도구는 모두 Figma 원격 서버에서만 쓸 수 있고, 데스크톱 서버에는 없습니다.
설정하기
Codex 앱에서(추천)
- Codex 앱을 열고 왼쪽 위의 Plugins를 클릭하세요.
- Figma 옆의 **+**를 클릭한 뒤 Install Figma를 클릭하세요.
- 요청이 나오면 Allow access를 클릭해 ChatGPT가 Figma 계정에 접근하도록 허용하세요.
Codex에 Figma 플러그인이 연결됨으로 표시됩니다. 이 플러그인에는 MCP 서버 설정과 Figma 스킬이 함께 들어 있습니다. 예를 들어 프레임을 구현하는 figma-design-to-code, 캔버스에 쓰는 figma-use, 코드로 Figma에 디자인 시스템을 만드는 figma-generate-library 등입니다. 스킬이 중요합니다. 어떤 도구를 어떤 순서로 부를지 Codex에 알려 주기 때문에, 도구를 직접 부를 때 자주 생기는 오류를 피할 수 있습니다.
Codex CLI에서
codex mcp add figma --url https://mcp.figma.com/mcp
요청이 나오면 Figma에 로그인해 접근을 허용하고 Codex를 다시 시작하세요. 이렇게 하면 서버만 추가되고 스킬은 들어가지 않습니다. 필요한 스킬은 Figma의 mcp-server-guide 저장소에서 ~/.agents/skills로 복사하거나, $skill-installer로 Codex에게 설치를 맡기세요. 스킬을 두는 위치는 Codex 플러그인과 스킬의 차이를 참고하세요.
데스크톱 서버로
데스크톱 서버는 Figma 데스크톱 앱 안에서 돌아가는, 조직용 선택지입니다. Professional, Education, Organization, Government, Enterprise 플랜의 Dev나 Full 시트가 필요하고, 앱이 열려 있을 때만 작동합니다.
- Figma 데스크톱 앱에서 Design 파일을 열고, 아무것도 선택하지 않은 상태에서 Shift D로 Dev Mode로 바꾸세요.
- 오른쪽 사이드바의 MCP server 영역에서 Enable desktop MCP server를 클릭하세요.
- Codex에서 Settings를 열고 MCP servers로 가서 Add server를 클릭하세요.
- 유형을 STDIO에서 Streamable HTTP로 바꾸고, 이름은
figma-desktop, URL은http://127.0.0.1:3845/mcp로 입력한 뒤 저장하세요.
Figma는 대부분의 사람에게 원격 서버를 권합니다. 데스크톱 서버로는 캔버스에 쓸 수 없습니다.
플랜과 한도
Codex가 필요하고, Figma 쪽은 Starter, Professional, Education, Organization, Enterprise 플랜에서 쓸 수 있습니다. 읽기 도구에는 호출 한도가 있습니다.
| Figma 플랜과 시트 | 읽기 호출 횟수 |
|---|---|
| Starter 플랜, 또는 View·Collab 시트 | 한 달 최대 20회 |
| Professional 또는 Education, Dev·Full | 하루 200회, 1분 10회 |
| Organization, Dev·Full | 하루 200회, 1분 15회 |
| Enterprise, Dev·Full | 하루 600회, 1분 20회 |
generate_figma_design, create_new_file, add_code_connect_map처럼 Figma에 쓰는 도구는 한도에 포함되지 않고, Figma AI 크레딧을 쓰는 작업도 마찬가지입니다. Figma는 한도를 언제든 바꿀 수 있다고 하니, 계획을 세우기 전에 한도 페이지를 확인하세요.
한 달 20회라면 페이지 전체가 아니라 프레임 하나의 링크를 주고, 화면은 하나씩 요청하세요.
복사해서 쓰는 프롬프트
프레임을 코드베이스에 구현하기
이 Figma 프레임을 구현해 주세요: [프레임 하나의 링크 붙여 넣기]. src/components의 컴포넌트와 기존 토큰을 사용하세요. 새 색상이나 폰트는 추가하지 말고, 디자인에 우리에게 없는 값이 있으면 지어내지 말고 목록으로 알려 주세요. 간격, 글자 크기, 상태를 맞춰 주세요. 끝나면 결과 스크린샷을 찍어 Figma 스크린샷과 비교하고, 고치지 못한 차이를 모두 적어 주세요.
페이지를 Figma로 다시 보내기
앱은 http://localhost:3000에서 실행 중입니다. /pricing 페이지를 편집 가능한 레이어로 새 Design 파일 "Pricing – from code"에 보내 주세요. 데스크톱과 모바일 너비를 모두 넣어 주세요. 마지막에 새 파일 링크를 알려 주세요.
토큰 맞추기
이 Figma 프레임에 쓰인 변수와 스타일을 읽어 주세요: [링크]. [테마 파일이나 CSS 변수 경로]에 있는 우리 토큰과 비교해, 아무것도 바꾸기 전에 불일치 표(이름, Figma 값, 코드 값)를 먼저 보여 주세요. 제가 확인하면 코드를 Figma에 맞게 업데이트해 주세요.
디자인 시스템을 한 번 문서로 남기기
메인 라이브러리에 Figma의 create_design_system_rules 프롬프트를 사용하고, 결과를 프로젝트 루트에 DESIGN.md로 저장해 주세요. 색상은 hex 값이 있는 토큰으로, 글자 크기 단계, 간격, 모서리, 그리고 버튼·입력창·카드 규칙을 적어 주세요. Figma나 코드에 있는 값만 사용하세요.
저장소에 DESIGN.md가 있으면, Figma를 연결하지 않은 세션에서도 Codex가 디자인 시스템을 지킵니다.
Codex에서 Figma 플러그인이 안 보이거나 작동하지 않나요?
Figma 도움말과 커뮤니티 포럼에서 자주 나오는 원인입니다.
- 플러그인 목록에 Figma가 없거나 설치가 안 됨. ChatGPT Business나 Enterprise 워크스페이스에서는 서드파티 플러그인이 꺼져 있을 수 있습니다. 워크스페이스 관리자에게 서드파티 플러그인을 허용하고 Figma 도구를 승인해 달라고 하거나, 위의 CLI 명령으로 MCP 서버에 직접 연결하세요.
- Figma를 Codex가 아니라 ChatGPT로 연결함. Figma를 ChatGPT 앱으로 연결했다면 그 연결을 지우고 Codex 앱의 Plugins에서 Figma를 설치하세요.
- 401이나 인증 오류. Figma 플러그인을 제거하고 다시 추가한 뒤 다시 로그인하세요.
- 읽기는 되는데 쓰기가 안 됨. 어떤 서버에 연결했는지 확인하세요. 데스크톱 서버에는 쓰기 도구가 없어
use_figma가 나타나지 않습니다. MCP 설정에서 예전 로컬figma서버를 지우고 원격 서버(https://mcp.figma.com/mcp)를 추가한 뒤 Codex를 다시 시작하세요. - 몇 번 쓰고 나서 멈춤. Starter나 View 시트의 한 달 20회 한도를 다 썼을 수 있습니다. 시트별 한도는 위 표를 보세요.
Codex Design은 어디에 쓰나요
팀이 Figma에서 디자인하고 Figma가 기준이라면 Figma 플러그인이 맞는 선택입니다. Codex Design은 그 앞 단계, 또는 Figma 없이 일하는 흐름을 맡습니다. Codex 안에 캔버스를 더해 여러 UI 방향을 라이브 HTML로 나란히 놓으니, 폰트·색상·간격을 고쳐 가며 비교한 뒤 정할 수 있습니다. 고른 것은 generate_figma_design으로 팀의 Figma에 보낼 수 있습니다. Figma 캔버스에서 코드를 돌리는 기능은 Codex Design vs Figma code layers 비교를 보세요.
자주 묻는 질문
Codex용 Figma 플러그인은 무료인가요?
플러그인 설치는 무료입니다. 쓸 수 있는 양은 Figma 시트에 따라 다릅니다. Starter 플랜과 View·Collab 시트는 읽기 호출이 한 달 최대 20회, 유료 플랜의 Dev·Full 시트는 하루 200회 이상입니다. Codex 사용량은 평소처럼 ChatGPT 플랜에서 차감됩니다.
Codex가 제 Figma 파일을 수정할 수 있나요?
원격 서버라면 가능합니다. use_figma 도구와 Figma의 figma-use 스킬로 프레임, 컴포넌트, 변수, 오토 레이아웃을 만들고 수정할 수 있습니다. 데스크톱 서버로는 쓸 수 없습니다.
플러그인과 MCP 서버 중 무엇을 써야 하나요?
Codex 앱에서는 플러그인을 쓰세요. 같은 원격 MCP 서버를 설정하면서 Figma 스킬도 함께 들어옵니다. CLI에서는 codex mcp add로 서버를 추가하고, 필요한 스킬은 직접 설치하세요.