쓸모 쓸모연구소 · 실전 노트
제 825 호이번 주 새 글 49 편2026 · 11 · 14
클로드 사용법⁠·모델
Impeccable · Claude

Impeccable Live 사용법, 브라우저에서 요소를 집어 디자인 고치기

Impeccable Live는 클로드 코드에서 /impeccable live를 켜 두고, 브라우저에 띄운 내 사이트에서 고치고 싶은 요소를 직접 집어 "이렇게 바꿔 줘"라고 적으면 여러 시안을 화면에서 바로 비교하고 고른 시안을 소스 파일에 반영해 주는 기능입니다. 말로 "헤더 오른쪽 날짜를 좀 더 깔끔하게"라고 설명하는 대신 화면을 가리키며 고칩니다. 이 글은 설치와 초기 설정부터 문구 삭제, 날짜 배치, 이미지 교체, 요소 끼워 넣기, 제목 앵커 추가까지 따라 하는 순서를 정리합니다.

Impeccable Live 사용법, 브라우저에서 요소를 집어 디자인 고치기 삽화
삽화 · 쓸모연구소

Impeccable Live가 하는 일

Impeccable은 AI가 만든 화면의 어색한 디자인을 다듬는 오픈소스 디자인 스킬(Apache 2.0)입니다. 그 안의 Live 모드는 개발 서버로 띄운 화면 위에 조작 바를 얹고, 브라우저에서 한 수정 지시를 클로드 코드 세션으로 자동으로 넘깁니다. 터미널에 따로 입력하지 않아도 세션이 작업을 시작합니다.

흐름은 세 단계입니다.

  1. 집기(Pick): 화면에서 바꿀 요소를 고르고 원하는 결과를 적습니다. 코멘트나 표시를 덧붙여 뜻을 보여 줄 수도 있습니다.
  2. 시안 만들기(Generate): 기본 시안 세 개가 만들어지고, 화면에서 번호를 넘겨 가며 비교합니다.
  3. 적용(Accept) 또는 버리기(Discard): 적용하면 고른 시안이 소스에 들어가고 임시 코드는 지워집니다. 버리면 원래 모습으로 돌아갑니다.

Live 모드는 베타이고 흔치 않은 프로젝트 구성에서는 매끄럽지 않을 수 있다고 안내되어 있습니다. 지원 범위는 Vite 기반 앱, Next.js, SvelteKit, Astro, Nuxt, 정적 HTML입니다. iOS와 안드로이드 앱 화면에는 붙지 않습니다.

준비물

  • 클로드 코드(Claude Code)
  • 로컬에서 개발 서버로 띄울 수 있는 내 사이트 프로젝트. 정적 HTML도 됩니다.
  • 웹 브라우저
  • Node.js. 아래 설치 명령이 npx를 쓰기 때문입니다.
  • 배포된 사이트에는 붙이지 않고, 내 컴퓨터에 받은 코드에서 개발 서버로 띄워 쓰는 것이 원칙입니다.

1. 설치하고 초기 설정하기

1단계. 터미널에서 프로젝트 폴더로 이동합니다.

  • 확인: 프로젝트 파일이 있는 폴더입니다.

2단계. 설치 명령을 입력합니다.

명령어
npx impeccable install --providers=claude --scope=project
  • 확인: 오류 없이 끝납니다. --scope=project는 이 프로젝트에만, global은 모든 프로젝트에 설치합니다. 처음 한 번만 하면 됩니다.

3단계. 클로드 코드를 다시 시작합니다.

  • 확인: 새 세션이 열립니다. /skills 목록에 impeccable이 보이면 설치된 것입니다.

4단계. 클로드 코드에서 아래 명령을 입력합니다.

명령어
/impeccable init
  • 확인: 프로젝트마다 한 번 하는 설정입니다. 코드를 읽고 추론할 수 없는 것만 묻고 PRODUCT.md 파일을 만듭니다.

5단계. 이어서 아래 명령을 입력합니다.

명령어
/impeccable document
  • 확인: 기존 화면의 시각 규칙을 DESIGN.md에 정리해 두어, 이후 수정이 사이트 분위기에서 벗어나지 않게 합니다.

2. Live 켜고 요소 집기

6단계. 터미널에서 내 사이트의 개발 서버를 실행합니다.

  • 확인: 사이트가 localhost 주소로 열립니다.

7단계. 클로드 코드에서 아래 명령을 입력합니다.

명령어
/impeccable live
  • 확인: Live용 도우미 서버가 함께 돕니다. 처음에는 프로젝트와 연결 설정을 묻는 경우가 있습니다. 콘텐츠 보안 정책(CSP)이 조작 바를 막고 있으면 바꿀 내용을 설명하고 허락을 먼저 구합니다.

8단계. 브라우저에서 내 사이트 주소를 엽니다.

  • 확인: 화면 아래에 조작 바가 뜹니다. 도우미 서버 주소가 아니라 내 앱 주소를 열어야 합니다. 작업하는 동안 클로드 코드 세션은 켜 둡니다.

9단계. 바에서 "Pick"(집기) 단추를 누르고 고칠 요소를 클릭합니다.

  • 확인: 요소가 선택되어 표시됩니다.

3. 문구 지우기와 시안 개수

10단계. 지우고 싶은 설명 문구를 집고 지시 칸에 "이 설명은 지워 줘"라는 뜻으로 적습니다.

  • 확인: 지시 내용이 입력 칸에 보입니다.

11단계. 시안 개수를 1로 바꿉니다.

  • 확인: 지우기는 결과가 하나뿐이라 1이면 충분합니다. 개수 기본값은 3이고, 여러 가지 모양을 보고 싶을 때 숫자를 올립니다.

12단계. 시안 만들기 화살표("Generate variants")를 누르거나 엔터로 보냅니다.

  • 확인: 시안을 만드는 중이라는 표시가 뜨고, 터미널의 클로드 코드가 입력 없이 작업을 시작합니다.

13단계. 작업이 끝나면 브라우저 화면을 봅니다.

  • 확인: 지시한 문구가 사라져 있습니다. 시안 하나만 만들었다면 그것을 적용합니다.

14단계. 같은 방식으로 다른 요소도 집어 "지워 줘"를 보냅니다.

  • 확인: 해당 요소가 삭제됩니다.

4. 날짜 배치 고치기와 액션 고르기

15단계. 어색하게 놓인 날짜 요소를 집습니다.

  • 확인: 요소가 선택됩니다.

16단계. 아래 지시를 입력합니다.

프롬프트
날짜 표시가 애매해서 좀 더 잘 배치해 주고 그리고 뭐 한 달 전 7일 전 이런 식으로 좀 더 유저 친화적으로 텍스트 표시해 줘.
  • 확인: 입력 칸에 보입니다. 구어체 그대로 적어도 작동합니다.

17단계. 액션 목록에서 방향을 고릅니다.

  • 위치: 바의 액션 목록에는 Freeform(자유 지시), Bolder(더 과감하게), Quieter(더 차분하게), Distill(덜어 내기), Polish(다듬기), Typeset(글꼴), Colorize(색), Layout(배치), Adapt(화면 크기에 맞추기), Animate(움직임), Delight(재미 요소), Overdrive(최대로 밀어붙이기)가 있습니다.
  • 확인: 특별히 정할 방향이 없으면 자유 지시를 씁니다.

18단계. 시안 개수를 1로 놓고 보냅니다.

  • 확인: 작업이 시작됩니다.

19단계. 결과를 보고 "Accept"(적용)를 누릅니다.

  • 확인: 소스에 반영됩니다. 같은 스타일의 다른 날짜 요소에도 같은 처리가 적용된 경우가 있습니다. 변경 내용(diff)을 클로드 코드의 다른 수정처럼 한 번 검토합니다.

5. 헤더 개선과 시안 고르기

20단계. 화면 위쪽 헤더를 집습니다.

  • 확인: 헤더가 선택됩니다.

21단계. 지시로 "헤더 개선"을 적고 액션은 자유 지시가 아닌 다른 것을 골라 봅니다.

  • 확인: 선택한 액션이 표시됩니다.

22단계. 시안 개수를 2로 놓고 보냅니다.

  • 확인: 터미널에서 작업 중인 모습이 보입니다.

23단계. 작업이 끝나면 시안 1과 2를 번호로 넘겨 가며 비교합니다.

  • 확인: 두 시안이 나옵니다. 지시를 짧게 적으면 시안끼리 크게 다르지 않을 수 있습니다. 그럴 때는 원하는 느낌을 구체적으로 적어 다시 만들게 합니다.

24단계. 마음에 드는 시안을 골라 "Accept"를 누릅니다.

  • 확인: 고른 시안이 소스에 들어갑니다. 마음에 드는 것이 없으면 "Discard"로 원래 모습으로 돌립니다.

6. 이미지 교체

Live는 클로드 코드 세션과 연결되어 있어서 세션에서 시킬 수 있는 일은 그대로 시킬 수 있습니다. 이미지 생성도 그중 하나입니다. 단, 세션에서 이미지 생성 도구를 쓸 수 있어야 합니다.

25단계. 글 페이지에서 바꿀 이미지를 집습니다.

  • 확인: 이미지가 선택됩니다.

26단계. 아래 지시를 입력합니다.

프롬프트
이미지를 좀 더 제목과 좀 더 연관되게 좀 더 파급력 있는 느낌의 이미지로 코덱스 이미지로 만들어서 이미지를 교체를 해 줘.
  • 확인: 입력 칸에 보입니다. 이미지 생성 도구가 없다면 "코덱스 이미지로" 부분을 쓰는 도구 이름으로 바꿉니다.

27단계. 시안 개수를 3으로 놓고 보냅니다.

  • 확인: "시안 세 개 만드는 중"이 뜹니다.

28단계. 이미지 생성이 끝나면 1, 2, 3 중 마음에 드는 번호를 골라 "Accept"를 누릅니다.

  • 확인: 이미지가 교체됩니다.

7. 요소 끼워 넣기

29단계. 두 요소 사이에 새 요소를 넣으려면 바에서 끼워 넣기(insert)를 선택합니다.

  • 확인: 위치를 고르는 상태가 됩니다.

30단계. 넣고 싶은 위치(두 요소 사이)를 클릭합니다.

  • 확인: 그 자리가 선택됩니다.

31단계. "디자인 요소가 들어가면 좋겠다"는 뜻으로 지시를 적고 시안 개수를 2로 놓고 보냅니다.

  • 확인: 만드는 동안 화면에서 작업이 진행됩니다. 일부러 애매하게 적어 보면 클로드가 어떤 요소를 제안하는지 볼 수 있습니다.

32단계. 두 시안 중 사이트 스타일에 맞는 쪽을 골라 적용합니다.

  • 확인: 한쪽은 요약 설명을 넣고 다른 쪽은 공간만 차지하는 식으로 갈릴 수 있습니다. 스타일이 맞는 쪽이 들어갑니다.

8. 제목 앵커 추가와 기타 활용

33단계. 앵커(주소 이동 링크)가 없는 제목 요소를 집습니다.

  • 확인: 제목이 선택됩니다.

34단계. "앵커 URL로 바로 갈 수 있도록 수정해 줘"라고 적고 시안 개수를 1로 놓고 보냅니다.

  • 확인: 작업이 끝납니다.

35단계. 제목을 클릭해 봅니다.

  • 확인: 제목 주소로 이동합니다.

Live는 요소를 고르지 않고 페이지 전체에 방향을 줄 수도 있습니다. 예를 들어 "배송 정보를 더 쉽게 찾게 해 줘"처럼 말이나 글로 요청하면 시안 생성 없이 클로드 코드가 처리하는 방식(Steer)입니다. HTML로 쓴 보고서의 문구를 선택해 피드백을 주는 용도로도 쓸 수 있습니다.

끝내고 정리하기

  • 시안 세트를 적용하거나 버린 뒤 바의 종료 단추를 누르거나, 클로드 코드에 "Live 모드를 멈춰 줘"라고 말하면 도우미 서버가 멈추고 임시 연결이 정리됩니다. 중간에 끊겼다면 클로드 코드에 이어서 하라고 하면 남은 작업을 이어받습니다.
  • 소스에 반영된 변경은 모두 코드 수정이니 깃에서 변경 내용을 확인하고 커밋합니다. 다른 파일에서 가져오는 화면은 빌드 결과물이 아니라 원본 소스에 반영되어야 합니다.
  • 스킬을 지우려면 프로젝트의 .claude/skills/impeccable 폴더를 지우고, .claude/settings.local.json에 들어간 impeccable 훅 항목도 지웁니다. 새 버전으로 올리려면 npx impeccable update를 씁니다.

막힐 때

  • 조작 바가 뜨지 않습니다: 개발 서버가 돌고 있는지, 도우미 서버 주소가 아니라 내 앱 주소를 열었는지, 1~8단계를 순서대로 다 했는지 확인합니다.
  • 시안 두 개가 거의 같습니다: 지시를 더 구체적으로 적어 다시 만듭니다.
  • 바가 영어로 나옵니다: 기본 표시는 영어입니다. 내 컴퓨터에 설치된 도구라 직접 고쳐 쓸 수 있지만 기본 기능을 먼저 익히는 편이 안전합니다.

최종 점검

  • 브라우저 하단에 Live 바가 뜬다
  • 집기로 요소를 골라 지시하면 클로드 코드 세션에 작업이 자동으로 들어온다
  • 시안을 고르고 "Accept"를 누르면 소스에 반영된다
  • 문구 삭제, 날짜 배치, 이미지 교체, 끼워 넣기, 앵커를 한 번씩 해 봤다
  • 변경 내용을 깃에서 확인했다

자주 묻는 질문

Impeccable Live는 무료인가요?

Impeccable은 Apache 2.0 라이선스의 무료 오픈소스입니다. 다만 시안을 만드는 데 클로드 코드를 쓰므로 요금제 한도나 API 비용은 듭니다. 시안 개수를 늘릴수록 사용량이 늘어납니다.

배포한 실제 사이트에도 쓸 수 있나요?

권하지 않습니다. 개발 서버로 띄운 로컬 화면이나 내 컴퓨터의 정적 HTML에서 쓰는 도구입니다. 저장소 안내도 배포된 사이트에 붙이는 것을 경고합니다.

시안을 몇 개까지 만들 수 있나요?

기본값은 3개이고 숫자는 조절할 수 있습니다. 문구 삭제처럼 결과가 하나뿐인 일은 1로, 방향을 비교하고 싶을 때는 2~3으로 놓습니다.

설치 명령은 어디서 확인하나요?

Impeccable 깃허브 저장소(pbakaus/impeccable)와 공식 문서(impeccable.style)에서 확인합니다. 명령과 메뉴는 바뀔 수 있으니 설치 전 README를 한 번 읽으세요(2026년 11월 기준).

이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.

원본 영상 보러가기 ↗