클로드 코드 /design 사용법, 시안을 손으로 고치고 코드로 옮기는 순서
클로드 코드의 /design 명령은 한 줄 설명만으로 앱 화면이나 포스터 시안을 그려 공유 페이지로 발행해 줍니다. 이 글은 클로드 코드 /design을 쓰기 위한 조건, 시안을 마우스로 고치는 방법, 고친 시안을 터미널에서 코드로 옮기는 순서를 단계별로 정리했습니다. 기준은 2026년 11월 공식 문서입니다.

/design 명령이 하는 일
/design은 클로드 코드에 들어 있는 기본 스킬(미리 만들어진 작업 방법)입니다. /design 뒤에 만들고 싶은 화면을 적으면 UI 시안, 화면 흐름, 랜딩 페이지, 포스터를 한 캔버스 위에 아트보드(시안 한 장씩을 담는 틀)로 펼치고, 이를 클로드 디자인 아티팩트(claude.ai에 올라가는 공유 페이지)로 발행합니다. 2026년 8월 연구 미리보기로 처음 나왔습니다.
다른 AI 디자인 도구도 시안은 뽑아 줍니다. 차이는 받은 다음입니다. 발행된 페이지를 열어 마우스로 직접 고치고, 그 결과를 같은 터미널의 클로드에게 다시 넘겨 코드로 만들게 이어 갑니다.
사용 조건은 다음과 같습니다.
- 클로드 코드 v2.1.265 이상
/login으로 claude.ai 계정에 로그인한 세션. Pro, Max, Ultra, Team, Enterprise 요금제에서 쓰고 무료 요금제는 제외입니다. - API 키나 Amazon Bedrock 같은 클라우드 사업자 경로로만 접속한 세션은 아티팩트를 발행할 수 없어 /design도 쓸 수 없습니다.
- 조직이 Design 템플릿을 꺼 둔 경우(Enterprise는 관리자가 켜야 합니다)에는 시안을 그리지 않습니다.
시안 만들기부터 코드 반영까지
1. 시안 만들기
- 클로드 코드 입력창에
/design과 원하는 화면을 한 줄로 입력합니다. 확인: 시안이 그려지고 아티팩트 주소가 나옵니다.
/design 모바일 은행 앱의 설정 화면
2. 공유 페이지에서 고치기
- 발행된 아티팩트를 데스크톱 브라우저에서 엽니다. 확인: 아트보드가 놓인 캔버스가 열립니다.
- 아트보드에서 고칠 요소를 선택해 직접 바꿉니다. 글자는 그 자리에서 고치고, 색이나 크기는 속성 패널에서 바꿉니다. 확인: 고친 요소가 화면에서 바로 바뀝니다.
- 저장 상태를 확인합니다. 공식 문서는 수정이 자동으로 저장된다고 안내하고, 초기 미리보기에는 저장 버튼이 따로 있었습니다. 확인: 화면에 저장 버튼이 보이면 눌러 둡니다. 링크를 다른 사람에게 공유했다면 저장이 공유 대상에게도 새 버전으로 보일 수 있습니다.
프롬프트로 설명하면 말이 길어지던 미세 조정, 예를 들어 버튼을 줄여 오른쪽에 붙이거나 섹션 순서를 바꾸거나 제목을 조금 키우는 일을 손으로 끝낼 수 있다는 점이 핵심입니다.
3. 터미널에서 바뀐 내용 확인하기
- 터미널의 클로드 코드로 돌아옵니다. 확인: 같은 세션이 그대로 열려 있습니다.
- 아래 문장을 입력합니다. 확인: 클로드가 어떤 요소를 줄이고 옮겼는지 짚습니다.
뭐 바꿨는지 맞춰 봐.
손으로 고친 디자인이 통째로 클로드에게 넘어온다면 이런 질문에 구체적으로 답할 수 있습니다. 다만 수정 내용이 어떤 형태로 전달되는지는 공식 문서에 설명이 없어서, 짚은 내용이 실제 수정과 맞는지는 시안을 보며 직접 대조해야 합니다.
4. 코드로 옮기기
- 코드로 만들 아트보드 이름을 말해 구현을 요청합니다. 확인: 클로드가 그 아트보드를 기준으로 화면 코드를 작성합니다.
설정 화면 아트보드를 지금 프로젝트 컴포넌트로 만들어 줘.
- 코드 변경을 확인합니다. 확인: 터미널에서
git diff를 실행하면 바뀐 파일과 색, 글자 크기 값이 보입니다.
여기서 주의할 점이 있습니다. 캔버스에서 고치는 것만으로 프로젝트 코드가 저절로 바뀌지는 않습니다. 공식 문서가 안내하는 흐름은 "아트보드를 골라 터미널에서 만들어 달라고 요청"하는 것입니다. 코드를 바꾸는 단계는 7번 요청이 시작점입니다. 프로젝트 안에서 /design을 쓰면 클로드가 먼저 기존 색, 컴포넌트, 비슷한 화면을 찾아 그것으로 시안을 그리려고 합니다.
쓰기 전에 알아 둘 한계
- 연구 미리보기 단계라 웹의 클로드 디자인보다 기능이 적습니다. 정식 출시 전이므로 동작과 조건이 바뀔 수 있습니다.
- 시안은 PNG(아트보드별)나 PDF로 내보낼 수 있습니다.
- 처음 만든 아티팩트는 나만 볼 수 있고, 페이지 메뉴에서 공유를 정해야 다른 사람이 봅니다.
- 사용량은 일반 채팅과 클로드 코드와 같은 한도를 씁니다.
막힐 때
/design이 입력창 자동완성에 나오지 않는다: 클로드 코드를 최신 버전으로 올립니다( claude update). 그래도 없으면 계정이나 조직에서 아직 켜지지 않은 것입니다.Artifacts need a claude.ai login이 나온다: /login으로 claude.ai 계정에 로그인합니다. - 아티팩트 주소 없이 로컬 HTML 파일만 만들어진다: 세션이 API 키나 클라우드 사업자 경로로 연결돼 있으면 발행이 안 됩니다.
/login으로 claude.ai 계정에 로그인했는지 확인합니다.
자주 묻는 질문
클로드 코드 /design은 무료로 쓸 수 있나요?
무료 요금제에서는 쓸 수 없습니다. Pro, Max, Ultra, Team, Enterprise 요금제에서 쓰고, 별도 사용량 없이 일반 채팅과 클로드 코드와 같은 한도에서 차감됩니다. 요금과 조건은 바뀔 수 있어 공식 안내를 확인해야 합니다.
캔버스에서 고치면 코드도 자동으로 바뀌나요?
자동으로 바뀌지 않습니다. 캔버스는 시안을 고치는 곳이고, 코드는 터미널에서 클로드에게 해당 아트보드를 만들어 달라고 요청해야 바뀝니다. 요청 뒤에는 git diff
/design은 어디서 실행하나요?
클로드 코드에서 실행합니다. 터미널이나 클로드 데스크톱 앱의 코드 탭에서 /design 뒤에 만들 내용을 적으면 됩니다. 시안을 편집하는 화면은 데스크톱 브라우저에서 엽니다.
웹 버전 클로드 디자인과 같은 기능인가요?
같지 않습니다. 클로드 코드의 /design은 연구 미리보기이고 웹 버전보다 기능이 적다고 안내돼 있습니다. 내 디자인 시스템의 컴포넌트로 시안을 그리게 하려면 /design-sync 같은 별도 명령이 필요합니다.
이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.
원본 영상 보러가기 ↗