[Claude Code 플러그인] image-view, 붙여넣은 이미지를 프롬프트 위에서 바로 확인하기
스크린샷을 붙여넣어도 번호 태그만 보여서 어떤 이미지인지 헷갈리던 불편을 줄여 주는 플러그인입니다. 설치 방법과 동작 조건, 제 화면에서 본 결과를 정리했습니다.
Claude Code 입력창에 이미지를 붙여넣으면 [Image #1]이라는 글자 태그만 남습니다. 여러 장을 붙여넣어 비교시키려 할 때는 어느 태그가 어느 이미지인지 눈으로 확인할 방법이 마땅치 않습니다. 이 글에서는 이 불편을 줄여 주는 image-view 플러그인과, 쓰기 전에 알아야 할 조건을 다룹니다.
1. 어떤 플러그인인가
Claude Code 입력창에 이미지를 붙여넣으면 입력창 위에 썸네일이 한 줄로 나타납니다. 각 썸네일에는 #1, #2처럼 입력창의 태그와 같은 번호가 붙어서, 글자 태그와 실제 이미지를 바로 짝지을 수 있습니다. 프롬프트를 전송하거나 태그를 지우면 썸네일 줄도 사라집니다.
README가 설명하는 동작 방식은 이렇습니다. Claude Code는 붙여넣은 이미지를 세션 캐시 폴더에 PNG로 저장하고 입력창에 [Image #n] 태그를 넣습니다. 이 플러그인은 0.2초마다 입력창을 읽어 태그를 찾고, 캐시된 PNG의 크기를 파일 머리글에서 읽어 비율에 맞는 썸네일을 그립니다. 이미지 데이터를 플러그인이 직접 다루지 않고 터미널이 파일을 읽어서 그린다는 점이 특징입니다.
2. 출처
| 항목 | 내용 |
|---|---|
| AI 도구 | Claude Code |
| 종류 | 플러그인 (README에서는 Claude Code mod로 소개합니다) |
| 만든 사람 | Jarrod Watts |
| 저장소 | https://github.com/jarrodwatts/claude-image-view |
| 설치 경로 | /plugin marketplace add jarrodwatts/claude-image-view 후 /plugin install image-view |
| 확인한 버전 | 0.1.0 (제 설치본의 plugin.json 기준, 2026년 10월 7일 확인) |
| 라이선스 | MIT |
| 동작 조건 | macOS 또는 Linux, Claude Code v2.1.287 이상, kitty 그래픽 프로토콜을 지원하는 터미널 (README는 Ghostty와 kitty를 예로 듭니다) |
3. 언제 쓰면 좋은가
- 화면 캡처를 여러 장 붙여넣고 비교를 시킬 때
- 디자인 시안이나 오류 화면을 붙여넣고 "이게 맞는 이미지인지" 보내기 전에 확인하고 싶을 때
이미지를 거의 붙여넣지 않는다면 필요 없습니다. 또 터미널이 위 조건을 만족하지 않으면 썸네일이 그려지지 않습니다.
4. 사용법
Claude Code 안에서 세 줄이면 설치가 끝납니다.
/plugin marketplace add jarrodwatts/claude-image-view
/plugin install image-view
/reload-plugins
터미널에서 설치하고 싶다면 아래처럼 하고, 세션 안에서 /reload-plugins를 한 번 실행하거나 새 세션을 엽니다.
claude plugin marketplace add jarrodwatts/claude-image-view
claude plugin install image-view@claude-image-view
설치하고 나면 따로 설정할 것은 없습니다. 이미지를 붙여넣으면 곧바로 썸네일이 뜹니다. 여러 장을 붙여넣어도 한 줄에 맞게 크기가 줄어들고, 가로로 긴 화면은 길게, 세로로 긴 화면은 세로로 길게 비율이 유지됩니다.
5. 적용 예시
제 환경은 macOS입니다. 설치하고 이미지를 한 장 붙여넣은 화면이 아래입니다.
![]()
입력창에는 [Image #1]이 있고, 그 바로 위에 같은 번호 #1이 붙은 썸네일이 떠 있습니다. 여러 장을 붙여넣으면 이 썸네일이 번호순으로 나란히 늘어서므로, 보내기 전에 어느 캡처가 몇 번인지 눈으로 확인하고 "첫 번째 이미지"처럼 번호로 가리킬 수 있습니다. 화면 맨 아래의 한 줄은 다음 글에서 다루는 상태줄입니다.
6. 써 본 소감
이미지를 두 장 이상 다루는 작업에서 값어치가 큰 플러그인입니다. 설치 후 따로 설정할 것이 없다는 점도 부담이 없습니다. 다만 터미널 조건이 있으니, 설치 전에 쓰는 터미널이 kitty 그래픽 프로토콜을 지원하는지 확인하는 단계가 하나 더 있습니다.
Comments (0)