claude-voice-setup

Claude Code 음성 입력 도구를 한 번의 명령으로 설치·설정·연동까지 자동화해 주는 CLI입니다.

빠른 시작

npx claude-voice-setup

설치 없이 한 줄로 실행됩니다.

무엇을 해 주나요?

1. 플랫폼 감지 (macOS / Windows)
2. 음성 입력 도구 자동 설치 — Homebrew Cask 활용
   • macOS 기본 음성 입력 (가이드)
   • Wispr Flow (클라우드, 정확도 중시)
   • Superwhisper (로컬 Whisper, 프라이버시)
   • VoiceInk (OSS, whisper.cpp 기반)
3. 한국어 개발자용 커스텀 프롬프트 자동 적용
   • "골뱅이" → @, "슬래시" → /, "언더바" → _ 등
   • 한국어로 발음한 기술 용어를 영어 원어로 변환 (깃허브 → GitHub)
4. Claude Code 연동 가이드 출력
   • 터미널 마이크 권한 설정
   • 한국어 IME 충돌 회피법
   • 도구별 단축키 안내

지원 플랫폼

| 플랫폼 | 지원 내용 | |--------|-----------| | macOS (Apple Silicon / Intel) | 자동 설치 + 연동 + 한국어 프롬프트 | | Windows | 대체 도구 제안 + WSL2 연동 가이드 |

Windows 사용자

Claude Code 음성 입력 도구 대부분이 macOS 전용이라, Windows에서는 대체 도구를 제안해 드립니다:

• Windows 기본 음성 입력 (Win + H)
• Whispering (OSS, whisper.cpp 기반)
• Talon (고급 음성 제어)
• WSL2 + Windows 호스트 조합 가이드

사전 요구사항

• Node.js 18+
• macOS 사용 시 Homebrew (없어도 동작하지만 수동 설치 모드로 전환)

직접 실행 (개발 모드)

git clone https://github.com/gaebalai/claude-voice-setup
cd claude-voice-setup
npm install
npm start

라이선스

MIT

제작

Jaewoo Kim by gaebalai · AI-fluent liberal arts Engineer