noisy-coding

Claude Code가 작업하는 동안 말을 걸어보세요 — Jarvis 스타일 음성 코딩. 시끄러운 것은 코드가 아니라 당신의 목소리입니다.

Claude가 짧은 요약을 소리 내어 읽어 줍니다. 항상 켜져 있는 리스너가 당신의 음성을 Claude가 작업 중에, 중단하지 않고 수신하는 메시지로 바꿔 줍니다 — 푸시 전송도, 대화록 복붙도 필요 없습니다. 키보드에서 떨어져서도 에이전트를 계속 조종하세요.

왜 좋아할까요?

• 중단 없는 흐름 — Claude가 작업하는 동안 말하세요. 당신의 말은 텍스트 상자가 아닌 실행 중인 세션에 전달됩니다.

• 핸즈프리 검토 — Claude가 결과를 소리 내어 읽으면, 당신은 방 건너편에서 대답합니다.

• 실시간 "전술 HUD" 대시보드 — 재생/재호출이 가능한 대화 로그, 실시간 오실로스코프, 음소거 버튼, 비용과 대기 시간을 한눈에.

• 에이전트별 캐릭터 — 모든 에이전트의 음성, 속도, 성격 다이얼을 대시보드에서 조정하세요.

• 파일에 설정할 것 없음 — API 키, 기기, 언어, 푸시투토크: 모든 것이 UI에 있으며 유지됩니다.

• 당신의 말을 끊지 않음 — 한 번에 하나의 음성만 나옵니다. 놓친 음성은 듣지 못함 상태로 보관되고 따라잡기 버튼으로 다시 재생됩니다.

음성 인식과 음성 합성은 Grok (xAI) Voice API를 사용합니다 — 실제로 매우 저렴해서 (소액의 일회성 예산으로 수개월 동안 매일 사용할 수 있습니다).

Related MCP server: Elba MCP Server

2분 안에 설치

백엔드는 하드웨어가 필요 없는 Docker 이미지(noisy/noisy-coding)로 제공됩니다. 대시보드 브라우저 탭이 마이크이자 스피커입니다. Docker와 브라우저만 있으면 됩니다 — Python도, git도, 환경 변수도 필요 없습니다.

# terminal: marketplace + plugin in one line
claude plugin marketplace add noisy/noisy-coding && claude plugin install noisy-coding@noisy

# inside Claude Code (new session):
/noisy-coding:setup

설정 명령은 공개된 이미지를 시작하고 첫 연동을 안내합니다. 그런 다음 http://127.0.0.1:8765에서 브라우저로 마무리하세요. xAI API 키(console.x.ai)를 붙여넣고 주황색 탭 오디오 활성화 배너를 클릭하세요. 클릭 한 번으로 탭이 마이크와 스피커가 됩니다. 탭을 열어 두고 그냥 말하면 됩니다.

Claude Code 안에서 더 편하게 작업하고 싶나요? 마찬가지입니다. 네 가지 명령어를 입력하세요: /plugin marketplace add noisy/noisy-coding → /plugin install noisy-coding@noisy → /reload-plugins → /noisy-coding:setup.

다른 설정 — 플러그인 없는 일반 Docker, 하드웨어 마이크/스피커를 사용하는 네이티브 설치, 원격 호스트, 모든 구성 옵션 —은 docs/INSTALL.md에 있습니다.

작동 방식

모든 음성 로직은 하나의 리스너 데몬에 있습니다. 이 데몬은 마이크, 재생 큐, 스피커를 단독으로 소유합니다. MCP 서버는 speak 요청을 전달하는 가벼운 메신저이며, Claude Code 훅이 받아 적은 음성을 세션으로 다시 전달합니다 (docs/hooks.md 참조).

mic (hardware or browser tab via WS :8766)
  -> VAD -> Grok STT -> transcript queue -> HTTP :8765
                              ^ polled by Claude Code hooks
speak (MCP, stdio or HTTP :8767) -> POST /speak -> daemon queue
  -> Grok TTS -> speakers (hardware or browser tab)

도구

문서

• docs/INSTALL.md — 일반 Docker, 네이티브 설치, 원격 호스트, 환경 변수, 개발 명령어

• docs/hooks.md — Claude가 당신의 말을 듣는 방법

• docs/ports.md — 각 포트의 용도

• docs/local-development.md — noisy-coding 자체를 해킹하고 싶다면

라이선스

MIT © Krzysztof Szumny