---
name: opencurrent-code-screenshot-ui
description: "말로 설명하기 어려운 화면 문제를 스크린샷으로 보여 주면, Claude Code가 어디가 어떻게 틀렸는지 보고 바로 코드를 고칩니다. 이럴 때 사용: 스크린샷이나 디자인 시안을 붙여 넣거나 경로로 넘기고, 원하는 모습과 다른 점을 짚게 한 뒤 고치게 합니다. 고친 화면을 다시 찍어 비교하며 맞춰 갑니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-screenshot-ui"
  opencurrent-id: "claude-code-screenshot-ui"
  verification: "pending"
  exported-at: "2026-11-21T11:15:13.189Z"
---

# 스크린샷으로 UI 고치기

말로 설명하기 어려운 화면 문제를 스크린샷으로 보여 주면, Claude Code가 어디가 어떻게 틀렸는지 보고 바로 코드를 고칩니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-screenshot-ui
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-screenshot-ui")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

스크린샷이나 디자인 시안을 붙여 넣거나 경로로 넘기고, 원하는 모습과 다른 점을 짚게 한 뒤 고치게 합니다. 고친 화면을 다시 찍어 비교하며 맞춰 갑니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

## 준비물

- Claude Code 설치와 로그인

## 단계

### 1. 이미지 넣기 (사람이 · Claude Code)

이미지를 Claude Code 창에 끌어다 놓거나, Ctrl+V(iTerm2는 Cmd+V, Windows·WSL은 Alt+V)로 붙여 넣거나, 파일 경로를 적습니다. 붙이면 [Image #1] 표시가 생깁니다.

기대 결과: [Image #1] 표시

확인 방법: 입력창에 이미지 표시가 보이는지 확인

### 2. 다른 점 짚기 (AI에게 · Claude Code)

지금 화면과 원하는 모습을 함께 주고 다른 점부터 목록으로 받습니다.

프롬프트:

```text
[Image #1]은 지금 화면, [Image #2]는 디자인 시안이야. 간격, 글자 크기, 색, 정렬에서 다른 점을 목록으로 알려 줘.
```

기대 결과: 다른 점 목록

확인 방법: 목록이 실제 차이와 맞는지 눈으로 확인

결과 이름: `{{diff_list}}` — 이 결과를 뒤 단계 프롬프트의 같은 자리에 넣을 것.

### 3. 고치기 (AI에게 · Claude Code)

목록에서 고칠 것을 골라 고치게 합니다. 어느 파일의 어느 스타일을 바꿨는지 함께 받습니다.

프롬프트:

```text
{{diff_list}} 중 1~3번을 고쳐 줘. 바꾼 파일과 줄을 알려 줘.
```

기대 결과: 고친 스타일

확인 방법: 브라우저에서 새로 고쳐 시안과 비교

### 4. 다시 찍어 비교 (AI에게 · Claude Code)

고친 화면을 다시 찍어 넣고 남은 차이를 확인합니다. 오류 화면이면 오류 스크린샷을 주고 원인을 묻습니다.

프롬프트:

```text
고친 뒤 화면이야. 시안과 아직 다른 곳만 알려 줘.
```

기대 결과: 남은 차이

확인 방법: 남은 차이가 없을 때까지 반복

## 주의할 점

- 스크린샷에 개인정보·비밀값이 보이면 가리고 넣기
- 이미지는 컨텍스트를 많이 씀. 필요한 부분만 잘라서
- 화면 폭과 확대 비율이 다르면 크기 비교가 틀릴 수 있음. 같은 폭으로 찍기

## 출처

- [Claude Code 문서: 자주 쓰는 작업(이미지)](https://code.claude.com/docs/en/common-workflows)
- [Claude Code 문서: 대화형 모드 단축키](https://code.claude.com/docs/en/interactive-mode)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-screenshot-ui 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
