음성으로 코드 변경을 브레인스토밍하는 방법 (Claude Code 또는 Codex 세션용)

참고: 기능 매트릭스 (영어)에 따르면 로컬 음성(기기 내 전사와 합성)은 실험적 기능입니다. 음성 기능은 0.2.x에서 다시 만들어졌으며 Local, OpenAI Realtime, Codex Live(실험적), Grok Realtime을 지원합니다.

제대로 된 지시를 쓰는 데는 타이핑이 잘 맞습니다.

하지만 휴대폰에서 "30초밖에 없는" 순간에 확실히 통하는 건 음성입니다.

"하던 걸 멈추고 무엇을 바꿨는지 설명해."
"계속하기 전에 마이그레이션을 건드릴 것 같으면 물어봐."
"계획을 요약하고 3단계 체크리스트로 줘."

목표는 "음성 레이어"가 따로 노는 두 번째 대화가 되지 않게 하면서, 음성으로 실제 코딩 세션을 브레인스토밍하고 방향을 잡는 것입니다.

흔한 방법(받아쓰기, 메모, 그냥 타이핑)은 각각 무언가를 잃습니다.

Happier는 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하기 위한 오픈 소스 앱으로, 음성을 실제 대상 세션에 고정하고 음성 프로바이더가 볼 수 있는 것을 명시적으로 제어하게 해 줍니다.

요약

정말 원하는 걸 정합니다:
- 음성 브레인스토밍(먼저 말하기), 또는
- 음성 받아쓰기(모든 걸 바로 세션에 보내기)
리포지토리/워크스페이스를 가진 머신에 Happier를 설정하고 휴대폰을 연결합니다.
Settings → Voice에서 음성 모드를 고릅니다:
- Happier Voice(설정이 빠름)
- Use my ElevenLabs(내 계정 + 결제)
- Local voice(기기/셀프 호스팅 엔드포인트/기기 내 음성)
개인 정보를 조입니다: 먼저 파일 경로와 도구 인수 공유를 끕니다.
말하기 시작하면 스레드가 두 개라는 걸 기억하세요:
- 숨겨진 음성 대화(내가 한 말 + 그 응답)
- 대상 세션(실제로 작업하려는 Claude Code/Codex 세션)

문제

키보드에서 떨어져 있어도 코딩 세션은 계속 움직이게 하고 싶습니다. 휴대폰 타이핑이 느리다고 설익은 지시를 보내고 싶지는 않습니다.

음성은 "빠른 방향 잡기"와 "빠른 확인"에 그걸 해결해 줍니다.

놓치기 쉬운 부분: 음성 프로바이더는 외부 서비스입니다. 개인 정보 토글을 보지 않으면 의도보다 더 많이 공유할 수 있습니다.

일반적인 방법과 트레이드오프

휴대폰으로 그냥 타이핑: 짧은 메시지엔 되지만 뉘앙스가 빠집니다.
메시지 창에 바로 음성 받아쓰기: 빠르지만 잘못된 걸 보내기 쉽습니다(게다가 모든 발화를 세션에 쏟아붓는 경향이 있습니다).
스스로에게 전화 / 메모 남기기: 의외로 효과적이지만 세션과 연결되지 않습니다.
Happier 음성: 말의 속도를 원하면서도 실제 대상 세션과 실제 제어를 유지하고 싶을 때 통합니다.

Happier가 처음이라면 (무엇이고 어디서 받는지)

Happier를 처음 본다면: Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트를 위한 오픈 소스 컴패니언 앱(모바일/웹/데스크톱)입니다.

여기서의 워크플로: 리포지토리와 에이전트 런타임은 워크스페이스를 가진 머신에 두고, 휴대폰에서 Happier로 세션을 모니터링하고 방향을 잡고 이어갑니다.

설정하기:

휴대폰에서 Happier 사용하는 방법
GitHub: https://github.com/happier-dev/happier
설치/다운로드: https://github.com/happier-dev/happier#how-it-works
Discord (커뮤니티 + 지원): https://discord.gg/W6Pb8KuHfg

실제로 쓸 수 있는 워크플로 (단계별)

1) 제약에 맞는 음성 모드 고르기

Settings → Voice를 엽니다.

Happier는 네 가지 음성 모드를 지원합니다.

Off
Happier Voice(관리형 실시간 ElevenLabs)
Use my ElevenLabs(내 API 키 + 에이전트를 쓰는 실시간 ElevenLabs)
Local voice(설정 가능한 STT/TTS 파이프라인)

결정 규칙:

설정을 최소화하려면: Happier Voice로 시작.
이미 아끼는 ElevenLabs 설정이 있다면: Use my ElevenLabs 사용.
기기 음성, 셀프 호스팅 엔드포인트, 기기 내 음성을 원하면: Local voice 사용.

2) 음성을 "실전"에 쓰기 전에 개인 정보 조이기

음성 설정에는 음성 프로바이더가 볼 수 있는 것에 대한 개인 정보 제어가 있습니다.

기본값은 보수적이며, 특히 두 가지가 중요합니다.

Share local file paths(기본 꺼짐)
Share tool arguments(기본 꺼짐)

음성으로 실제 코딩 작업의 방향을 잡는다면, 이 둘이 다음의 차이를 만듭니다.

"음성 프로바이더가 도울 수는 있지만 파일 시스템/도구 호출의 속은 못 봄"
"음성 프로바이더가 원했던 것보다 훨씬 많이 봄"

더 엄격한 개인 정보를 원하면 다음도 끄세요.

Share recent messages

3) "숨겨진 음성 대화"와 "대상 세션" 이해하기

이게 핵심 사고 모델입니다.

음성이 켜져 있으면 Happier는 숨겨진 음성 대화를 유지합니다.

이 대화가 있어서 다음을 할 수 있습니다.

무엇을 들었는지 검토
음성 응답을 텍스트로 읽기
타이핑으로 이어가기
무엇을 안내했는지 확인

하지만 음성이 작업하려면 여전히 실제 세션이 필요합니다.

그 세션이 대상 세션입니다.

음성이 "말은 하는데 아무것도 안 하는" 것처럼 느껴진다면 보통 다음 때문입니다.

대상 세션이 아니라 음성 대화 트랜스크립트를 보고 있거나
음성이 잘못된 대상 세션을 가리키고 있음

4) "Direct session"과 "Agent" 중 정하기 (Local voice)

Local voice를 쓰면 두 가지 대화 모드가 보입니다.

Direct session: 말을 전사해 대상 세션에 바로 보냄.
Agent: 먼저 전용 음성 에이전트와 대화한 뒤, 그 에이전트가 대상 세션에서 작업하게 함.

고르는 법:

사실상 받아쓰기를 원하면 Direct session.
무언가를 하기 전에 음성 레이어가 질문하고, 요약하고, 다시 확인하길 원하면 Agent 모드.

5) (선택) voice home과 프로젝트 루트로 "의외의 작업 디렉터리" 피하기

Local voice 에이전트 모드는 어디서 시작하느냐에 따라 다른 작업 디렉터리에서 시작할 수 있습니다.

음성을 전역에서 시작(사이드바/전역 화면) → voice home에서 시작
음성을 세션에서 시작 → 그 세션의 프로젝트 루트에서 시작

안전하고 중립적인 동작을 원하면 Stay in voice home을 켜서 음성이 자동으로 프로젝트 루트로 이동하지 않게 할 수 있습니다.

리포지토리 안에서 진짜 코딩 동료처럼 일하길 원한다면, 보통 세션 화면(프로젝트 루트)에서 시작하는 게 맞습니다.

동작하는 이유 (그리고 깨지는 경우)

Happier에서 음성이 잘 동작하는 건 단순한 "음성 인식"이 아니라, 여전히 실제 세션을 가리키고 그 위에서 작업할 수 있는 레이어이기 때문입니다.

실제로 깨지는 두 곳:

개인 정보 불일치: "큰 그림만" 의도했는데 너무 많이 노출하는 공유를 켜 둠.
대상 불일치: 음성은 켜져 있는데 잘못된 세션을 가리킴(또는 대상이 아니라 음성 트랜스크립트를 읽고 있음).

흔한 실수

개인 정보를 확인하기 전에 음성 켜기 → 먼저 "Share recent messages / local file paths / tool arguments"를 빠르게 확인하세요.
음성이 세션을 대체할 거라 기대 → 음성에는 자체 대화 상태가 있습니다. 대상 세션은 여전히 필요합니다.
음성 레이어가 조심스럽길 원하면서 Direct session 사용 → "먼저 물어보기" 동작을 원하면 Agent 모드로 바꾸세요.

FAQ

음성이 Claude Code/Codex 세션을 대체하나요?

아니요. 음성은 자체적인 숨겨진 대화 상태를 유지하고, 작업이 필요할 때 실제 세션을 대상으로 합니다.

어떤 모드로 시작해야 하나요?

기본값을 원한다면 Happier Voice로 시작하고, 특정한 개인 정보/셀프 호스팅/기기 제약이 있을 때만 Local voice로 옮기세요.