본문 바로가기
AI 코딩 어시스턴트를 위한 스크린샷

AI 코딩 어시스턴트에 딱 맞는 크기의 스크린샷

Claude Code, Codex CLI, Gemini CLI에 말로 설명하지 말고 보여 주세요. Maxisnap은 Windows에서 화면 영역이나 화면 녹화를 캡처하고, 클릭 한 번으로 AI 최적화 사본을 내보냅니다. 모델이 어차피 축소해 버릴 4K 픽셀에 토큰을 쓰지 않으면서도 내용은 또렷하게 읽히는 적정 크기입니다.

Windows 10(1903 이상) / 11 · 무료 요금제 · macOS는 아직 제공되지 않음

터미널에서 AI 어시스턴트와 코딩하다 보면, 생각보다 훨씬 자주 "보여 줘야 하는" 순간이 옵니다. 대화 상자에 뜬 스택 트레이스, 잘못 렌더링된 레이아웃, 그대로 구현하고 싶은 Figma 프레임, 모델이 읽어야 할 차트 — 이런 것들을 가장 빠르게 설명하는 방법은 그림입니다. 그런데 커맨드라인 에이전트에 그림을 건네는 일은 생각보다 번거롭고, 원본 4K 캡처는 애초에 건넬 그림으로 적절하지도 않습니다.

Maxisnap이 해결하는 건 연결 과정이 아니라 그림 자체입니다. 에이전트를 자동으로 조작하거나 대신 붙여넣어 주지는 않습니다. 대신 키 하나로 깔끔하고 크기가 알맞은 이미지(또는 짧은 녹화 영상)를 만들어 주어, 뒤따르는 붙여넣기나 드래그, 파일 경로 지정이 빠르고 안정적으로 끝나게 합니다. 아래에 주요 CLI 세 가지가 지금 이미지를 어떻게 받는지, 그리고 전용 내보내기가 어디서 값을 하는지 정리했습니다.

토큰 문제

그냥 전체 해상도 스크린샷을 붙여넣으면 안 되나요?

전체 해상도 스크린샷은 비용이 크고 오히려 역효과인 경우가 많기 때문입니다. 비전 모델은 이미지를 패치로 나눠 패치마다 토큰을 매기므로, 4K 캡처 한 장에 이미지 토큰 1,000개를 훌쩍 넘길 수도 있습니다. 반면 적당한 너비로 줄인 사본은 보통 수백 토큰이면 되고, 어차피 모델이 큰 이미지를 내부적으로 축소하기 때문에 읽히는 정도는 똑같습니다. 크기가 지나친 이미지는 이미지당 용량 제한에 걸리거나 조용히 거부되기도 합니다. 코딩 에이전트에 스크린샷을 보내기 전에 크기를 알맞게 맞추는 것, 이것이 가장 효과가 큰 조치입니다.

보내는 것 일반적인 이미지 토큰 비용 CLI에서의 결과
원본 4K / 모니터 전체 캡처 1,000 토큰 이상 느리고 비싸며, 용량 제한에 걸리거나 어차피 축소됨
Maxisnap AI 최적화 사본(너비 1600 px) 수백 토큰 또렷하게 읽히고, 비용이 적고, 업로드가 빠름

토큰 수치는 비전 모델의 일반적인 범위이며 Maxisnap의 벤치마크가 아닙니다. 정확한 값은 모델과 이미지 내용에 따라 달라집니다.

도구별 요약표

각 CLI에 스크린샷을 어떻게 전달하나요?

세 도구 모두 이미지를 받고, 파일 경로도 받습니다. Windows에서는 터미널 클립보드 붙여넣기가 조용히 실패하는 일이 있어(특히 WSL 환경) 파일 경로가 가장 확실합니다. Maxisnap의 역할은 바로 그 "바로 쓸 수 있는 파일"을 만들어 주는 것입니다. 도구별 현황은 다음과 같습니다.

AI 코딩 도구 이미지를 전달하는 방법 Windows 참고 사항
Claude Code Alt+V로 붙여넣거나, 파일을 터미널로 드래그하거나, 프롬프트에 이미지 파일 경로를 적습니다. Windows/WSL에서는 Ctrl+V가 아무 동작도 하지 않는 경우가 많습니다. Alt+V (v2.1.157에 추가) 또는 파일 경로가 확실한 방법입니다.
Codex CLI Ctrl+V를 인라인으로 쓰거나, 파일을 드래그하거나, 다음처럼 명시적으로 전달합니다: codex --image shot.png "prompt"를 참고하세요. 특히 --image 플래그가 가장 확실합니다.
Gemini CLI Ctrl+V / Alt+V로 붙여넣습니다(자동으로 .gemini-clipboard/ 아래에 저장됩니다). 또는 파일 경로를 지정하면 됩니다. 붙여넣으면 [Image #N] 칩이 삽입되고, 전송할 때 저장된 파일로 연결됩니다.

CLI 동작은 자주 바뀝니다. 현재 키 설정은 각 도구의 공식 문서를 확인하세요. Maxisnap은 이미지를 만들어 줄 뿐, CLI를 수정하거나 자동화하지 않습니다.

작업 흐름

UI 버그를 Claude Code에 가장 빨리 전달하는 방법은?

키 세 번이면 끝납니다. 다시 인코딩할 필요도, 다른 앱을 열 필요도 없습니다.

  • 캡처합니다. 단축키 Ctrl+Alt+5를 누르고 오류 대화 상자나 깨진 레이아웃, 디자인 프레임 주위로 박스를 드래그하세요.
  • 민감한 부분을 가립니다. API 키나 토큰, 고객 데이터가 찍혔다면 모델에 넘어가기 전에 블러 도구로 덮으세요. 특정 지점을 짚어 주고 싶다면 화살표나 번호 핀을 추가하면 됩니다.
  • AI 최적화 사본을 내보냅니다. 클릭 한 번이면 기본 최대 너비 1600 px로 맞춘 사본이 만들어집니다(설정에서 변경 가능). 저장하거나 복사하거나 터미널로 바로 드래그한 뒤, Claude Code, Codex, Gemini에서 붙여넣거나 드롭하거나 경로로 지정하면 됩니다.

내보낸 파일이 이미 알맞은 크기이므로 "붙여넣기가 왜 거부됐지, 왜 이렇게 비싸지" 같은 왕복 과정을 아예 건너뜁니다. 블러는 이미지에 직접 적용되므로, 가려 둔 비밀 정보는 건네는 파일에서 복원할 수 없습니다.

$ diff raw-screenshot ai-optimized

[RAW 4K] paste a full-monitor capture
-- 1000+ image tokens, may be downscaled or rejected
[MAXISNAP] export AI-optimized copy
++ ~1600px wide, a few hundred tokens, reads clean

[RAW 4K] secrets on screen
-- keys and tokens sent as-is
[MAXISNAP] blur before export
++ destructive redaction, unrecoverable from the file

[RAW 4K] terminal clipboard on Windows/WSL
-- Ctrl+V often vanishes silently
[MAXISNAP] saved file + drag-out
++ drop the file or reference its path, every time
        
직접 하기 vs 캡처 도구 vs Maxisnap

전용 도구가 꼭 필요한가요, 그냥 잘라서 붙여넣으면 안 되나요?

물론 직접 잘라서 붙여넣어도 됩니다. 가끔 한 장씩이라면 그걸로 충분합니다. 전용 내보내기가 값을 하는 건 하루 종일 이 작업을 하고, 토큰 비용이 신경 쓰이고, 보내기 전에 가려야 할 것이 있을 때입니다. Invoke 같은 파일 경로 방식 캡처 도구와 비교한 솔직한 장단점은 다음과 같습니다.

필요한 것 캡처 도구 + 붙여넣기 파일 경로 캡처 도구(예: Invoke) Maxisnap AI Mode
토큰에 맞는 적정 크기원본 해상도원본 해상도 파일기본 1600 px, 변경 가능
Windows에서 동작지원지원지원
보내기 전 비밀 정보 가리기미지원환경에 따라 다름블러 + 10가지 도구
AI에 화면 녹화 공유미지원미지원AI 최적화 MP4
전체 스크린샷 + 녹화 기능도 제공기본 수준캡처만 가능앱 하나로 둘 다
가격기본 제공일회성 유료무료 플랜
정지 이미지만이 아닙니다

AI 코딩 에이전트에 화면 녹화도 공유할 수 있나요?

네. 움직임 속에서만 재현되는 버그는 정지 이미지로 설명하기 어렵습니다. Maxisnap은 영역이나 전체 화면을 녹화하고(Ctrl+Alt+3 / Ctrl+Alt+4), 불필요한 구간을 잘라낸 뒤 AI 최적화 MP4로 내보냅니다. 약 1280 px, 24 fps, 모노 오디오로, 동영상을 받는 ChatGPT, Claude, Gemini 앱에 빠르게 올릴 수 있을 만큼 가볍게 만들어집니다. "모델에 맞는 크기"라는 같은 원칙을 영상에 적용한 것입니다. 자세한 내용은 화면 녹화 + 스크린샷 도구 페이지에 있습니다.

자주 묻는 질문

AI 코딩용 스크린샷 — 자주 묻는 질문

Maxisnap이 Claude Code, Codex CLI, Gemini CLI와 함께 동작하나요?

네. 모든 스크린샷과 화면 녹화를 클릭 한 번으로 크기가 알맞은 AI 최적화 사본으로 내보낼 수 있고, 세 CLI 모두에서 붙여넣기, 드래그, 파일 경로 지정으로 쓸 수 있습니다. Maxisnap은 이미지를 만들어 줄 뿐, 에이전트에 대신 붙여넣거나 자동화하지는 않습니다.

AI 최적화 이미지의 크기는 얼마이고, 바꿀 수 있나요?

기본 최대 너비는 1600 px이며 설정에서 변경할 수 있습니다. 어차피 모델이 축소해 버릴 4K 해상도에 토큰을 쓰지 않으면서도 이미지가 또렷하게 읽히도록 정한 값입니다.

원본 스크린샷을 그냥 터미널에 붙여넣으면 안 되나요?

전체 해상도 캡처는 이미지 토큰을 1,000개 넘게 쓸 수 있고, 이미지당 용량 제한에 걸리거나 조용히 축소될 가능성도 큽니다. 크기를 맞춘 사본이 더 저렴하고 업로드도 빠르면서 읽히는 정도는 같습니다. 그래서 대개 더 나은 입력입니다.

Windows 터미널에서 스크린샷 붙여넣기가 자꾸 사라집니다. 이걸로 해결되나요?

Windows와 WSL에서는 터미널 이미지 붙여넣기가 불안정합니다. Maxisnap은 크기가 알맞게 저장된 이미지를 만들어 주므로, 불안정한 클립보드를 거치지 않고 터미널에 드래그하거나 파일 경로로 지정하면 됩니다. 예를 들어 Codex의 --image 플래그나 Claude Code의 Alt+V를 참고하세요.

Windows에서 동작하나요?

네. Maxisnap은 Windows 네이티브 앱입니다(Windows 10 1903 이상, Windows 11). macOS 전용인 다른 AI 코딩용 스크린샷 도구들과 다른 점입니다. macOS 빌드는 개발 중이며 아직 공개 다운로드는 없습니다.

AI 코딩 어시스턴트에 보낼 만한 그림을 건네세요.

캡처하고, 가리고, 알맞은 크기로 내보내기까지 키 세 번. Windows에서 무료로.

무료 다운로드 전체 기능 보기

관련 페이지: 화면 녹화 + 스크린샷 도구 · 개발자를 위한 스크린샷 도구 · 스크린샷 블러 처리 · 전체 기능