도움말 및 FAQ
녹음, 전사, AI 요약, 통합 기능에 대해 알아보세요.
시작하기
녹음은 어떻게 시작하나요?
메인 화면의 녹음 버튼을 클릭하거나 ⌘R을 누르세요(WaveLog 창이 포커스된 상태에서는 Space도 작동합니다). WaveLog가 즉시 오디오를 캡처하고 실시간으로 전사를 시작합니다. 다시 ⌘R을 누르면 녹음이 중지됩니다.
녹음할 오디오 소스를 어떻게 선택하나요?
설정 → 녹음 탭에서 사용할 마이크 또는 시스템 오디오 소스를 선택하세요. 시스템 오디오 캡처를 활성화하면 Zoom, Teams 등 화상회의 앱의 소리도 녹음할 수 있습니다.
기존 오디오 파일을 전사할 수 있나요?
네. 오디오 파일(MP3, M4A, WAV 등)을 WaveLog 창에 드래그 앤 드롭하거나 파일 → 오디오 가져오기를 사용하세요. 라이브 녹음에서 선택한 것과 동일한 온디바이스 ASR 엔진(Whisper, Qwen3-ASR, SherpaASR)으로 로컬 전사가 실행됩니다.
전사
전사는 어떻게 작동하나요? 내 오디오가 외부로 전송되나요?
절대 아닙니다. 모든 전사는 Metal GPU 가속을 사용하는 선택된 로컬 엔진(Whisper, Qwen3-ASR, SherpaASR)으로 디바이스 내에서 처리됩니다. 녹음과 전사본은 전적으로 내 Mac에만 저장되며 어떤 서버에도 업로드되지 않습니다.
어떤 언어를 지원하나요?
Whisper large-v3-turbo는 자동 감지로 99개 언어를 지원합니다. Qwen3-ASR과 SherpaASR은 지원 언어가 다릅니다. 설정 → 전사에서 언어를 고정하거나 엔진을 변경할 수 있습니다.
인터넷 없이도 전사가 되나요?
네. 녹음, 전사, 화자 구분, 재생 모두 완전 오프라인으로 작동합니다. 인터넷은 계정 로그인, 라이센스 확인, 선택적 클라우드 연동 시에만 필요합니다.
전사 정확도는 어느 정도인가요?
WaveLog는 세 가지 로컬 ASR 엔진을 지원합니다 — Whisper large-v3-turbo(99개 언어, 최고 정확도), Qwen3-ASR(Apple Silicon 최적화 저지연), SherpaASR(경량 SenseVoice). 설정 → 전사에서 엔진을 선택하세요. 심한 배경 소음, 강한 억양, 고도로 전문적인 어휘에서는 정확도가 낮아질 수 있습니다.
화자 구분
화자 감지는 어떻게 작동하나요?
WaveLog는 디바이스에서 실행되는 ONNX 모델로 각 화자의 음성 임베딩을 생성해 전사를 자동 분리합니다. 설정 → 분석에서 두 가지 모델 중 선택할 수 있습니다: ECAPA-TDNN(빠르고 가벼움)과 Sherpa-pyannote(겹쳐 말하는 환경에서 더 높은 정확도). 화자는 화자 1, 화자 2 등으로 자동 레이블됩니다.
화자 이름을 바꿀 수 있나요?
네. 전사문에서 화자 레이블을 클릭하면 이름을 변경할 수 있습니다. 변경된 이름은 해당 세션 전체에서 같은 화자의 모든 발화에 적용됩니다.
잘못 분류된 화자를 수정할 수 있나요?
네. 세션 오른쪽 상단의 Tools 버튼 → Speaker tools를 여세요. 드롭다운으로 두 화자를 선택해 병합하거나, Split 버튼으로 분리 모드에 진입해 메신저 뷰에서 말풍선을 드래그해 세그먼트를 선택한 뒤 확인하면 새 화자로 분리됩니다. 같은 패널에서 화자 분석을 재실행할 수도 있습니다.
몇 명의 화자까지 구분할 수 있나요?
세션당 최대 8명의 화자를 구분할 수 있습니다. 최상의 결과를 위해 화자들이 서로 다른 음성을 가지도록 하고 겹쳐 말하는 상황을 최소화하는 것이 좋습니다.
AI 요약
AI 기반 요약은 어떻게 받을 수 있나요?
완료된 세션을 열고 AI 요약 탭을 클릭하세요. WaveLog가 회의 요약, 액션아이템, 핵심 포인트를 세 가지 모드로 생성합니다. AI 제공자와 모델은 설정 → 분석에서 구성할 수 있습니다.
어떤 AI 제공자를 지원하나요?
WaveLog는 Mac에 이미 설치하고 로그인해 두신 AI CLI에 연결합니다 — Claude CLI(Anthropic), Antigravity CLI(Google), Codex CLI(OpenAI). 설정 → 분석 또는 AI 요약 탭에서 제공자와 모델을 선택하세요. 인증은 각 CLI의 자체 앱이 처리하므로, WaveLog는 API 키를 저장하거나 전달하지 않습니다.
요약은 어떤 언어로 작성되나요?
설정 → 분석 → LLM 설정의 출력 언어 설정을 따릅니다. 기본적으로 전사 언어와 일치하며, 회의 언어에 관계없이 특정 언어로 요약을 생성하도록 재정의할 수 있습니다.
WaveLog는 각 AI CLI를 어떻게 호출하나요?
WaveLog는 회의 전사문과 시스템 프롬프트를 모아 각 AI CLI에 다음 명령으로 한 번씩 전달하고 결과를 받아옵니다 — 인터랙티브 세션 없이 1회 호출(one-shot) 방식입니다.
• Claude CLI:
claude --print --output-format json --model <모델> --system-prompt <시스템>
(사용자 프롬프트는 stdin으로 전달)
• Antigravity CLI (agy):
agy -p "<시스템 + 사용자 프롬프트>"
(positional 인자로 전달)
• OpenAI Codex CLI:
codex exec --json --skip-git-repo-check --model <모델> -
(combined prompt는 stdin으로 전달)
세 CLI 모두 사용자의 Mac에서 사용자 본인의 인증으로 실행되며, WaveLog 서버를 거치지 않습니다.
AI 요약 사용 시 비용이 발생하나요?
프로바이더와 인증 방식에 따라 다릅니다.
• Antigravity (agy) — Google Antigravity 계정 무료 사용에 포함됩니다. 현재 별도 종량제 정책 없음.
• OpenAI Codex — ChatGPT Plus($20/월) 또는 Pro 구독에 포함되어 추가 비용 없이 사용 가능합니다.
• Claude — 2026-06-15부터 Anthropic이 claude --print 같은 비인터랙티브 호출을 인터랙티브 사용량과 분리된 "Agent SDK credit" 풀로 차감합니다 (Pro $20 / Max 5x $100 / Max 20x $200 월간). 크레딧 소진 후엔 종량제 API 요금이 부과됩니다. ANTHROPIC_API_KEY 환경 변수가 설정된 경우에는 시점과 무관하게 항상 종량제로 청구됩니다.
청구는 각 AI 제공자(Google / OpenAI / Anthropic)가 사용자에게 직접 부과하며 WaveLog 서버는 관여하지 않습니다.
내보내기 및 통합
어떤 통합 기능을 사용할 수 있나요?
WaveLog는 다음 서비스로 액션 아이템과 요약을 내보낼 수 있습니다: Jira(이슈 생성), Notion(페이지에 추가), Confluence(페이지 생성), Linear(이슈 생성), Slack(메시지 전송), Google Docs(문서에 추가).
통합 서비스를 연결하려면 어떻게 하나요?
설정 → 통합에서 연결하려는 서비스 옆의 연결 버튼을 클릭하세요. 해당 서비스의 OAuth 로그인 페이지로 이동합니다. 인증이 완료되면 WaveLog가 액세스 토큰을 macOS 키체인에 안전하게 저장합니다.
내보낼 때 데이터는 안전한가요?
내보내기는 OAuth 2.0을 사용하며 토큰은 macOS 키체인에 저장됩니다. WaveLog는 직접 선택한 텍스트 내용만 전송하며, 명시적으로 선택하지 않는 한 원본 오디오나 전체 전사본은 전송하지 않습니다.
키보드 단축키
녹음을 빠르게 시작하거나 중지하려면?
⌘R을 눌러 앱 어디서든 녹음을 켜고 끌 수 있습니다. 메인 창이 포커스된 상태에서는 Space도 작동합니다. (⌘+Space는 macOS Spotlight 단축키로 WaveLog에서는 사용되지 않습니다.)
녹음의 특정 순간으로 이동하려면?
전사 화면에서 원하는 문장이나 세그먼트를 클릭하면 해당 타임스탬프로 즉시 이동합니다. 파형 스크러버로 수동 이동도 가능합니다.
모든 키보드 단축키는 어디서 확인하나요?
언제든지 ⌘/를 눌러 앱의 모든 단축키 목록이 담긴 키보드 단축키 대화상자를 열 수 있습니다.
문제 해결
WaveLog가 마이크에 접근할 수 없다고 합니다.
시스템 설정 → 개인 정보 보호 및 보안 → 마이크에서 WaveLog가 켜져 있는지 확인하세요. 목록에 없으면 WaveLog를 종료했다가 다시 열어보세요. macOS는 앱이 권한을 요청한 이후에만 목록에 표시되는 경우가 있습니다.
AI 모델을 다운로드하는 중인데 얼마나 걸리나요?
Whisper large-v3-turbo 모델은 약 1.6GB로 빠른 연결에서 보통 3~10분 소요됩니다. Qwen3-ASR과 SherpaASR은 별도 다운로드이며 크기가 다릅니다. 각 엔진은 최초 1회만 다운로드하면 이후 완전 오프라인으로 동작합니다.
설정 → 분석에 AI 제공자가 표시되지 않습니다.
사용하려는 AI CLI(Claude CLI, Antigravity CLI, Codex CLI)가 Mac에 설치되어 있고 해당 CLI의 자체 앱에서 로그인된 상태인지 확인하세요. 로그인 후 WaveLog를 재시작하면 제공자가 인식됩니다. 문제가 지속되면 CLI를 재설치하고 요청되는 시스템 권한을 허용해보세요.
키체인 접근 대화상자가 계속 나타납니다.
OS 업데이트나 앱 재설치 후 WaveLog가 저장된 토큰을 처음 읽을 때 이 대화상자가 나타납니다. '항상 허용'을 클릭하면 반복 표시를 방지할 수 있습니다. 같은 항목에 대해 두 번 이상 나타나면 설정에서 해당 통합 서비스를 연결 해제 후 다시 연결해보세요.
전사는 정확한데 화자 레이블이 잘못 표시됩니다.
마이크 간 에코나 음성 혼선으로 화자 구분이 어려울 수 있습니다. 지향성 마이크를 사용하고 동시 발화를 최소화하면 최상의 결과를 얻을 수 있습니다. 전사문에서 화자 레이블을 클릭해 언제든지 수동으로 수정할 수 있습니다.
추가 도움이 필요하신가요?
다음 메일로 연락 주세요: diveai.contact@gmail.com
2영업일 이내에 답변드립니다.