Claude Code의 결과를 말해주는 플러그인을 만들었다

작업 중, Claude Code를 알아차리지 못하는 문제

개인 개발에서 goal이나 auto mode를 사용하여 마지막까지 전부 맡겨두고 있으면,

어느새 끝나 있는 경우가 자주 있습니다.

실무에서도 마찬가지로, AI에게 의뢰하고 있는 동안 Slack이나 메일을 확인하다 보면

권한 확인을 놓쳐서 타임아웃(timeout)이 발생하는 일도 있습니다.

회의 중에 백그라운드(background)에서 실행시켜 두고,

끝났는지 신경 쓰이면서 회의에 집중하지 못하는 것도 은근히 괴롭습니다.

화면을 보고 있지 않아도 알아차릴 수 있는 방법이 필요했기에,

목소리와 팝업(pop-up)으로 알려주도록 만들었습니다.

만든 것

Claude Code의 완료·권한 확인·입력 대기를 음성으로 읽어주는 플러그인입니다.

Claude가 "results: 〇〇했습니다"라고 요약한 내용을 그대로 읽어주기 때문에,

화면을 보지 않아도 무엇이 일어났는지 알 수 있습니다.

설치

플러그인 추가는 이 2개의 커맨드(command)만으로 사용할 수 있습니다.

TTS (Text-to-Speech)를 OS 표준 기능으로 구현했기 때문에, 추가 설치가 필요 없습니다.

claude plugin marketplace add https://github.com/qvtec/claude-result-speak.git
claude plugin install claude-result-speak@claude-result-speak

커스터마이즈 (Customization)

~/.claude/settings.json

에서 언어나 읽기 속도를 변경할 수 있습니다.

{
"env": {
"CLAUDE_RESULT_SPEAK_LANGUAGE": "ja",
...

고양이와 조합하기

따로 만든 고양이 플러그인과 병용할 수 있습니다.

음성은 이 플러그인, 시각적 알림은 고양이, 라는 식으로 나누어 사용합니다.

{
"env": {
"CLAUDE_RESULT_SPEAK_NOTIFY_ENABLED": "false"
...

요약

macOS·WSL2 대응입니다.

개인 개발에서도 실무에서도, 화면에서 눈을 떼고 있는 시간이 많은 분께 추천합니다.

Discussion