(사례 작성을 위한) Claude Code CLI 사용 시 스크린샷을 자동으로 찍는 플러그인 개발
2026.01.18

소개
1주차 온오프 토요 모임 뒤풀이에서 Claude Code CLI를 쓸 때, 스크린샷을 제 때 하지 않으면 그냥 화면이 없어져버리는 이슈가 나왔습니다.
지피터스 사례를 쓸 때 불편하다고 하셔서, 자동으로 Claude Code CLI 스크린샷을 찍어주는 hooks를 개발하고 plugin으로 다시 만든 후, marketplace에 배포했습니다.
진행 방법
일단, hooks 설계를 ChatGPT 딥 리서치와 했습니다.

그리고 이 설계 초안을 md, ps1 파일로 만든 후 docs 폴더에 넣고 그 문서를 참고해서 hooks 개발을 Claude Code로 했습니다.

테스트 해보니 잘 동작합니다.
이렇게 동작하게 plugin으로 만들었습니다.
기능 네 가지는 hooks로 만들었고, custom slash command를 두 개 만든 후
전체를 plugin으로 만들었습니다.

그리고 github에 올렸습니다. git 주소는 여깁니다.
https://github.com/LinaYoun/auto-screenshot.git
이 github repo를 이용해서 rose_ai 마켓 플레이스를 만들고, 이 plugin을 배포했습니다.
이 명령어 쓰시면 여러분도 쓰실 수 있어요.
/plugin marketplace add https://github.com/LinaYoun/auto-screenshot.git이렇게 하면 마켓플레이스가 추가되고, /plugin 메뉴로 진입해서
설치된 마켓플레이스를 선택한 후, 그 안의 하나 있는 플러그인을 설치하시면 됩니다.

설치 후 이 slash command를 실행시키면 스크릿샷이 찍힙니다.

경로는 C 밑의 Screenshot 폴더를 만든 후 세션 별로 폴더를 만들어 저장합니다.

이런 스크린샷이 프롬프트를 전송하거나, claude code가 bash를 실행할 때 자동 저장됩니다.

그리고 이 slash command를 실행하면 스크린샷을 찍는 것을 멈춥니다.

결과와 배운 점
은근히 hooks 개발은 쉬웠으나 마켓 플레이스에 배포에서 오래 걸렸습니다.
그래도 같이 쓸 수 있으니 좋네요.
이제 Claude Code CLI 화면 캡처는 이 plugin에 맡겨보세요.
(단, 활성 창을 스크린샷하니 작업을 하시면서 다른 일을 하시면 그 창이 스크린샷됩니다.ㅎㅎㅎ)
로그인하고 댓글을 남겨 주세요

![[맘스맘 개발기] 260201 바이브 프롬프트 엔지니어링으로 UX 개선하기 2 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Ff6ce221cd06e8aa5406e2c43.jpg&w=3840&q=75)


맥에서 오류가 나는거 같아요
에러 원인은 간단해요: 플러그인이 Windows PowerShell 명령(powershell)을 실행하려고 하는데, macOS에는 기본으로 PowerShell이 없어서 command not found가 뜹니다. 즉, 해당 플러그인은 Windows 전용입니다.
해결 विकल्प:
플러그인 사용 중지(가장 간단)
macOS용 스크린샷 플러그인으로 교체
PowerShell 7 설치 후 플러그인에서 powershell 대신 pwsh로 실행하도록 수정(가능하면)
원하는 방향을 알려줘:
플러그인 제거/비활성화
macOS용 대체 플러그인 추천
PowerShell 7 설치하고 계속 쓰기
---
os에 따라 분기 처리가 필요한 듯 합니다.
네, 윈도우 전용입니다. 윈도우 Poweshell 명령어를 이용하거든요. 맥을 샀으니 짬이 나면 맥 용도 개발해볼게요.
@Rose
감사합니다^^
codex와 claude code 명령을 고쳐봐라고 몇가지 했더니 이제 에러 없이 동작하는것 같아요
<코덱스>
User attachment
이 터미널 오류를 어떻게 해결해?
에러 원인은 간단해요: 플러그인이 Windows PowerShell 명령(powershell)을 실행하려고 하는데, macOS에는 기본으로 PowerShell이 없어서 command not found가 뜹니다. 즉, 해당 플러그인은 Windows 전용입니다.
해결 विकल्प:
플러그인 사용 중지(가장 간단)
macOS용 스크린샷 플러그인으로 교체
PowerShell 7 설치 후 플러그인에서 powershell 대신 pwsh로 실행하도록 수정(가능하면)
원하는 방향을 알려줘:
플러그인 제거/비활성화
macOS용 대체 플러그인 추천
PowerShell 7 설치하고 계속 쓰기
3
좋아요. macOS에서 PowerShell 7(pwsh) 설치 후 플러그인 명령을 pwsh로 바꾸면 됩니다.
먼저 설치:
brew install --cask powershell
설치 확인:
pwsh -v
플러그인이 powershell을 호출하고 있다면 pwsh로 수정해야 합니다(설정 파일/스크립트/플러그인 코드).
원하면 제가 바로 설치 명령을 실행할게요. 승인해줄래?
ㅇㅇ
설치가 타임아웃으로 끝나서 pwsh가 아직 없습니다. 다시 설치를 진행해야 해요.
다시 실행해도 될까요?
ㅇㅇ
설치가 실패한 이유는 sudo 비밀번호 입력이 필요했는데, 현재 방식으로는 입력을 받을 수 없어서입니다.
이건 제가 자동으로 해결할 수 없고, 당신이 직접 터미널에서 실행해야 합니다.
다음 명령을 사용해 주세요:
brew install --cask powershell
설치 후 확인:
pwsh -v
확인되면 알려줘. 그 다음에 플러그인에서 powershell 호출을 pwsh로 바꾸는 단계로 이어갈게.
cst@MacBook-Pro claudeProject % pwsh -v
PowerShell 7.5.4
좋아요, pwsh 설치 완료됐어요. 이제 플러그인이 powershell 대신 pwsh를 호출하게 바꾸면 됩니다.
플러그인 위치가 어디인지 알려줄래요?
예) ~/.codex/plugins/auto-screenshot-plugin 같은 경로
모르면 아래 두 개 중 하나를 실행해 위치 찾아줘:
ls ~/.codex/plugins
또는
rg -n "powershell" ~/.codex
경로 알려주면 정확히 수정 단계 안내할게요.
네가 경로를 찾아줄 수 있어?
경로는 찾았고, powershell → pwsh로 교체까지 완료했어요.
수정된 위치는 아래입니다.
start-screenshot.md
stop-screenshot.md
hooks.json
다만 이 플러그인은 Windows 전용이라, macOS에선 pwsh가 있어도 계속 실패합니다.
이유: 스크립트가 C:\Screenshots 경로와 user32.dll 같은 Windows API를 직접 씁니다. (capture_screen.ps1 등)
원하면 제가 macOS용으로 포팅해줄게요.
/start-screenshot 명령과 hooks를 screencapture 기반으로 바꾸면 됩니다.
원하는 방향:
macOS용으로 포팅 진행
이 플러그인 사용 중지하고 대체 플러그인 찾기
1
macOS용으로 플러그인을 포팅했어요. 이제 pwsh가 아니라 bash + screencapture로 동작합니다.
스크립트는 세션 시작/종료, 스크린샷 캡처, 시작/중지 명령까지 모두 macOS 기준으로 바꿨습니다.
변경된 파일:
hooks.json
session_start.sh
capture_screen.sh
session_end.sh
enable_screenshot.sh
disable_screenshot.sh
start-screenshot.md
stop-screenshot.md
동작 방식:
저장 위치: ~/Pictures/ClaudeScreenshots
캡처 방식: 전체 화면 PNG (screencapture -x)
세션별 폴더 + 로그 기록
다음 단계:
Claude Code 세션을 재시작
/start-screenshot 실행
권한 요청이 뜨면 터미널/Claude Code에 화면 기록(Screen Recording) 허용
~/Pictures/ClaudeScreenshots에 파일 생성되는지 확인
원하면 “활성 창만 캡처”로 바꾸는 버전도 만들어줄게.
Auto contex
<클로드 코드>
⎿ SessionStart:startup hook error
❯ /auto-screenshot:start-screenshot
⎿ UserPromptSubmit hook error
⏺ This skill is designed for Windows PowerShell, but you're running on macOS (darwin). The
PowerShell command won't work on your system.
Would you like me to help you set up automatic screenshot capture for macOS instead? I could
create a similar solution using macOS native tools like screencapture.
❯ ㅇㅇ
⎿ UserPromptSubmit hook error
⏺ macOS용 자동 스크린샷 캡처를 설정하겠습니다.
⏺ Bash(mkdir -p ~/Screenshots && echo "enabled" > ~/Screenshots/.screenshot_enabled &&
session_id="session_$(date +%Y%m%d_%H%M%S)" && mkdir -p ~/Screenshots/$session_i…)
⎿ Screenshot capture enabled. Session folder: session_20260121_095144
⎿ PostToolUse:Bash hook error
⏺ 스크린샷 캡처가 활성화되었습니다.
설정 완료:
- 저장 위치: ~/Screenshots/session_20260121_095144/
- 상태 파일: ~/Screenshots/.screenshot_enabled
스크린샷 찍는 방법:
# 전체 화면
screencapture ~/Screenshots/session_20260121_095144/screenshot_$(date +%H%M%S).png
# 선택 영역 (드래그로 선택)
screencapture -i ~/Screenshots/session_20260121_095144/screenshot_$(date +%H%M%S).png
# 특정 윈도우 (클릭으로 선택)
screencapture -w ~/Screenshots/session_20260121_095144/screenshot_$(date +%H%M%S).png
단축키로 빠르게 찍기:
- Cmd + Shift + 3: 전체 화면
- Cmd + Shift + 4: 선택 영역
- Cmd + Shift + 4 후 Space: 윈도우 선택
비활성화하려면 /stop-screenshot을 사용하세요.
───────────────────────────────────────────────────────────────────────────────────────────────
❯
…
@여행자 사이먼
상세 대화로그까지~!! 감사합니다~^^