speak

Claude의 답변을 소리 내어 읽어 달라고 요청하세요.

원본 답변을 텍스트 음성 변환으로 그대로 읽는 것이 아닙니다. "그냥 간단히 다시 읽어줘"라고 말하면 Claude가 자신이 말한 내용을 짧은 음성 대본으로 다시 쓴 다음 재생합니다. 대본은 채팅에 표시되지 않습니다. 모델과의 대화이며, 텍스트는 방해가 되지 않게 처리됩니다.

현재 Claude Code에서 작동합니다. 재생 부분은 일반 MCP 서버이므로 Claude Desktop, Cursor 또는 모든 MCP 클라이언트에서도 사용할 수 있습니다.

제공 기능

• speak MCP 서버: speak, stop, pause, resume, back, skip, add_pronunciation, list_pronunciations, list_voices, set_default 도구 제공

• macOS에서 Claude가 말하는 동안 떠 있는 오버레이: 모든 창 위에 작은 알약 모양으로 표시되며, 실시간 파형, 한 문장 뒤로, 한 문장 건너뛰기, 정확한 지점에서 일시 정지 및 재개, 중지 기능을 제공합니다.

• Claude Code용 /speak 스킬: simple(기본값), brief, decisions, full, eli5 스타일 제공

• 자동 음성 읽기: 모든 답변 후 brief 대본을 읽어 주는 Stop 훅(기본적으로 꺼져 있음)

• speak CLI: echo "hello" | speak

• Raycast 스크립트 명령: Speak는 선택한 텍스트를 그대로 읽고, Speak Simply는 먼저 claude -p로 짧은 음성 요약으로 다시 쓴 다음 읽으며, Speak Translated는 먼저 번역합니다(기본값은 영어, 명령 인수로 다른 언어를 입력하거나 SPEAK_TRANSLATE_LANGUAGE를 설정하여 기본값을 변경할 수 있음). 영어가 아닌 번역은 일치하는 설치된 macOS 음성으로 읽으며, 가장 좋은 음성부터 사용합니다(Premium, Enhanced, compact 순). 영어는 일반 음성을 그대로 사용합니다. 언어에 대한 Premium 음성을 다운로드하려면 시스템 설정 > 손쉬운 사용 > 읽기 및 말하기 > 시스템 음성 > 음성 관리에서 다운로드하면 좋은 음성을 얻을 수 있습니다. Speak Stop은 중지합니다. 선택 영역을 시뮬레이션된 Cmd+C로 복사하므로 Raycast에 손쉬운 사용 권한이 필요합니다.

Related MCP server: MCP Audio Server

엔진

macOS에서 음성 선택

기본 say 엔진은 Mac의 시스템 음성을 사용하므로 macOS에서 한 번만 설정하면 모든 읽기에 적용됩니다.

1. 시스템 설정 > 손쉬운 사용 > 읽기 및 말하기(이전 버전에서는 음성 콘텐츠)를 엽니다.

2. 시스템 음성에서 음성을 선택합니다. Apple은 언어별로 큰 라이브러리를 제공하며, Premium 및 Enhanced 음성은 요청 시 다운로드되며 기본 compact 음성보다 훨씬 좋습니다. Siri 음성도 여기에서 선택할 수 있습니다.

3. 말하기 속도를 취향에 맞게 설정합니다.

발음

채팅에서 Claude에게 말하세요:

• "지금부터 fancyapp을 fan-see-app으로 발음해 줘"

• "저장한 발음이 뭐야"

발음은 ~/.config/speak/pronunciations.json에 저장되며(폴더는 SPEAK_CONFIG_DIR로 재정의 가능), 단어 전체 일치 및 대소문자 구분 없이 적용되며 모든 읽기에 적용됩니다:

{
  "fancyapp": "fan-see-app",
  "OAuth": "oh auth"
}

링크와 이메일은 말하는 방식으로 읽습니다: https://example.com/login은 "example dot com slash login"이 되고, jane@example.de는 "jane at example dot d e"가 됩니다. de, io, co.uk와 같은 짧은 끝부분은 문자 하나씩 철자로 읽습니다. "de"를 단어로 읽으면 "duh"처럼 들리기 때문입니다.

두 가지로 읽히는 단어("live", "read", "lead")는 단어 목록으로 고칠 수 없습니다. 스킬은 Claude에게 대본에서 철자를 다시 쓰도록 지시하여 음성이 잘못 추측하지 못하게 합니다: "alive"의 live는 "lyive", 과거형 read는 "red", 금속 lead는 "led"로 씁니다. 스킬에는 일반적인 문제 단어 표가 포함되어 있으며 말하기 전에 대본을 확인합니다.

SPEAK_VOICE를 설정하지 않으면 시스템 음성을 따르고, say -v ?의 음성 이름으로 설정하면 Claude에만 해당 음성을 사용합니다.

SPEAK_ENGINE을 설정하지 않으면 사용 가능한 첫 번째 엔진이 사용됩니다. SPEAK_VOICE는 음성을 설정합니다. 둘 다 set_default 도구("edge 엔진으로 전환")로 세션별로 변경할 수 있습니다.

설치

RAYCAST_SCRIPTS_DIR을 Raycast에서 이미 추가한 디렉터리(설정 > 확장 프로그램 > 스크립트 명령)로 설정하면 명령이 해당 디렉터리에 연결됩니다. 설정하지 않으면 이 저장소의 raycast/를 한 번 수동으로 추가하세요.

RAYCAST_SCRIPTS_DIR=~/raycast-scripts ./install.sh

Node 20+, jq, Claude Code가 필요합니다.

git clone https://github.com/CareyScott/speak
cd speak
./install.sh

이 명령은 서버와 macOS 오버레이 도우미(Xcode 명령줄 도구의 swiftc 필요)를 빌드하고, MCP 서버를 사용자 범위로 등록하고, 스킬을 ~/.claude/skills에 연결하고, Stop 훅을 ~/.claude/settings.json에 추가하고, speak와 speak-auto를 ~/.local/bin에 연결합니다.

Claude Code를 다시 시작하세요.

사용법

Claude에게 말하세요:

• "그거 다시 읽어줘"

• "간단히 말해줘"

• "내가 뭘 해야 하는지 소리 내어 말해줘"

• "/speak decisions"

• "stop"

모든 답변 후 자동으로 말하기:

speak-auto on            # brief style
speak-auto on decisions  # only the questions for you
speak-auto off

말하는 동안 오버레이를 사용하거나 그냥 말하세요:

• "pause", "resume", "go back a sentence", "skip that", "stop"

일시 정지는 정확한 위치를 유지합니다. 재개는 그 위치에서 계속됩니다. 뒤로는 이전 문장을 다시 재생합니다. 건너뛰기는 다음 문장으로 이동합니다. 일시 정지나 재개에 대해 말로 알려주지 않습니다. 그냥 실행됩니다.

엔진 또는 음성 선택:

export SPEAK_ENGINE=edge
export SPEAK_VOICE=en-IE-ConnorNeural

또는 채팅에서: "say 음성 목록 보여줘", "지금부터 Jamie 사용해".

작동 방식

스킬은 Claude에게 귀에 잘 들리도록 쓰는 방법을 알려줍니다: 짧은 문장, 핵심부터 말하기, 코드를 읽지 말고 설명하기, 필요한 결정으로 끝내기. Claude는 이 대본으로 speak 도구를 호출합니다.

서버는 남은 마크다운을 제거하고 대본을 문장으로 분할한 다음, 현재 문장이 재생되는 동안 다음 문장을 합성합니다.

macOS에서는 작은 Swift 도우미(overlay/main.swift)가 AVAudioPlayer로 재생을 담당하고 오버레이를 그립니다: 항상 위에 있고 활성화되지 않는 패널로, 포커스를 빼앗지 않습니다. Node는 stdin을 통해 JSON 라인으로 한 번에 하나의 문장 파일을 보내고, 도우미는 stdout으로 finished, back, 또는 stop을 보고합니다. 일시 정지와 재개는 도우미 내부에서 발생하므로 위치가 정확합니다. 뒤로와 건너뛰기는 서버에 다음에 재생할 문장을 알려줍니다. 다른 곳에서는 서버가 오버레이 없이 afplay 또는 ffplay로 대체합니다.

자동 음성 읽기는 Claude Code Stop 훅입니다. 플래그 파일 ~/.config/speak/auto가 존재하면 훅이 한 번 중지를 차단하고 파일에 지정된 스타일로 대본을 말하도록 Claude에게 요청합니다. stop_hook_active 가드가 루프를 방지합니다.

개발

npm run dev        # run the server with tsx
npm test           # vitest
npm run typecheck

MIT.