VoxyFlow
홈으로 이동
Setup Guide

VoxyFlow 시작하기 가이드

설치법부터 맞춤 설정, 다양한 AI 모델 연동까지 VoxyFlow의 핵심 기능을 자세히 알아봅니다.

1

원클릭 확장 설치

Chrome 웹스토어에서 VoxyFlow를 바로 받아 설치할 수 있습니다. 가볍고 별도의 가입은 필요하지 않습니다.

이메일을 등록해 주시면 확장 프로그램 설치 링크와 2분 가이드라인을 보내드립니다.

2

번역 AI 고르기

VoxyFlow는 완전 무료이며 개인 키를 등록하는 'Bring-Your-Own-Key' 방식으로 철저한 프라이버시 보호를 원칙으로 합니다.

DeepL API (권장)

Recommended

매우 빠르고 문맥 파악이 우수합니다. 무료 API 플랜을 활용해 한 달에 50만 자를 비용 없이 번역할 수 있어 매일 기사를 읽기에 이상적입니다.

Get DeepL API Key
OpenRouter (클라우드 AI 대형 모델)
Advanced

Gemini 2.5 Flash, Claude 3.5, DeepSeek 등 클라우드 지능 모델들을 이용해 긴 문장을 섬세하게 읽어낼 수 있습니다.

Get OpenRouter API Key
Ollama (로컬 기기 내장 AI)
Offline

컴퓨터에 모델(예: translategemma:2b)을 설치해 오프라인으로 100% 사생활을 지키며 기기 단독으로 작동하게 해줍니다.

기본 설정의 Ollama는 확장 프로그램 통신(CORS)을 차단하므로 터미널에서 다음을 꼭 세팅해 주세요:

macOS

macOS: 터미널을 열고 `launchctl setenv OLLAMA_ORIGINS "*"` 명령을 넣은 다음 Ollama 앱을 완전히 껐다 켭니다.

launchctl setenv OLLAMA_ORIGINS "*"
Windows

Windows: 시스템 환경 변수(또는 사용자 환경 변수) 목록에 이름은 `OLLAMA_ORIGINS`, 값은 `*`로 넣어 추가하고 재시작합니다.

Variable: OLLAMA_ORIGINS
Value: *
Linux (systemd)

Linux: `sudo systemctl edit ollama.service`를 입력하고 `[Service]` 영역 아래에 `Environment="OLLAMA_ORIGINS=*"`를 추가해 주고 재시작합니다.

[Service] Environment="OLLAMA_ORIGINS=*"
3

상시 노출 핀 고정

편안하게 꺼내기 위해 Chrome의 퍼즐 아이콘 🧩을 누르고 VoxyFlow 우측의 핀 마크 📌를 켜서 툴바에 고정시킵니다.

툴바에 고정된 VoxyFlow를 누르면 빠른 설정 팝업이 뜹니다. 복사한 API 연결 키를 넣고 AI 엔진을 정한 뒤 '저장'하세요.

4

세 가지 비주얼 뷰

기사의 형태나 읽는 습관에 따라 화면에 알맞은 방식으로 활용할 수 있습니다:

  • 호버 뷰: 세팅한 단축키를 누른 상태로 모르는 단어에 마우스를 올리기만 하면 그 자리에 빠르게 번역이 뜹니다.

  • 선택 뷰: 구문이나 단락을 마우스로 긁어 선택하고 단축키를 누르면 발음 오디오 및 저장 메뉴가 포함된 팝오버 창이 뜹니다.

  • PDF 문서 및 우클릭: 마우스 우클릭 후 'Translate with VoxyFlow'를 선택합니다. 정형화된 PDF 문서를 읽을 때 요긴합니다.

5

원활한 키보드 제어

키보드에서 손을 뗄 필요 없이 매끄럽게 조작해 생각과 읽기의 흐름을 방해하지 않습니다.

시스템 구동 단축키

Alt + Shift + V (⌥⇧V) — 호버 번역 켜기 또는 선택 영역 번역하기Alt + Shift + V
Alt + Shift + D (⌥⇧D) — Flow 사이드바(전체 복습 및 단어장) 열기Alt + Shift + D
Alt + Shift + S (⌥⇧S) — 빠른 설정 팝업 열기Alt + Shift + S

번역 팝업 창 안에서의 조작키

FF — 단어를 Flow 단어장에 저장하거나 저장 해제
CC — 번역 결과 텍스트를 바로 클립보드로 복사
GG — 저장된 단어장의 텍스트를 수동으로 바로 편집
SpaceSpace / P — 단어 발음 사운드 재생하기
EscEsc — 창 닫기
6

생산성 대시보드: Flow와 단어장

읽은 발자취를 나만의 어휘 저장소로 활용해 사이드바를 통해 단어들을 관리하세요:

Translator

수동 사전 입력: 텍스트를 직접 넣어 조회할 수 있으며 'Flow로 전송'을 활성화하면 히스토리에 같이 남습니다.

Flow Stream

Flow 타임라인: 내가 조회한 어휘와 문맥 예문들이 시간별로 기록되어 한눈에 흐름을 파악하기 좋습니다.

Word Bank

자동 분류 기능: 단어와 긴 구문들을 구분하여 탭을 나눠 정렬해 주므로 체계적으로 복습할 수 있습니다.

Anki

Export to Anki: 단어와 문맥 예문이 담긴 CSV 파일을 내려받아 사용 중인 Anki 덱에 바로 올릴 수 있습니다.

Quizlet

Import to Quizlet: 복사 전용 텍스트를 클립보드로 받아 Quizlet 세트 생성 화면에서 붙여넣기만 하면 간편하게 끝납니다.

7

쾌적한 성능

확장 프로그램의 아키텍처는 불필요한 트래픽이나 API 소모를 막아줍니다:

3중 스마트 캐시 구조

메모리 및 IndexedDB에 14일간 번역 결과 보존. 동일 구문은 재요청 시 통신 없이 즉시 무료 조회됩니다.

안전 차단 기능

네트워크가 원활하지 않을 땐 무의미한 연속 통신을 막아 API 계정의 스패머 의심 제재를 방지합니다.

맥락 언어 감지

짧은 단어 검색 시 페이지 자체의 `html lang` 속성을 비교 보완하여 번역 정밀도를 보장합니다.

LLM 효율 조절

무거운 AI 구동 시 사용량 관리와 응답 지연을 방지하기 위해 호버 번역을 차단하고 넉넉한 타임아웃을 지정합니다.