전체 내역

[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입니다. 설치하고 이미지를 한 장 붙여넣은 화면이 아래입니다.

이미지를 한 장 붙여넣었을 때 입력창 위에 #1 썸네일이 뜬 Claude Code 화면

입력창에는 [Image #1]이 있고, 그 바로 위에 같은 번호 #1이 붙은 썸네일이 떠 있습니다. 여러 장을 붙여넣으면 이 썸네일이 번호순으로 나란히 늘어서므로, 보내기 전에 어느 캡처가 몇 번인지 눈으로 확인하고 "첫 번째 이미지"처럼 번호로 가리킬 수 있습니다. 화면 맨 아래의 한 줄은 다음 글에서 다루는 상태줄입니다.

6. 써 본 소감

이미지를 두 장 이상 다루는 작업에서 값어치가 큰 플러그인입니다. 설치 후 따로 설정할 것이 없다는 점도 부담이 없습니다. 다만 터미널 조건이 있으니, 설치 전에 쓰는 터미널이 kitty 그래픽 프로토콜을 지원하는지 확인하는 단계가 하나 더 있습니다.

Comments (0)