문서KwaFlux 1.0.15 기준
무엇을 도와드릴까요?
설치부터 내보내기와 납품까지, 단계별 안내와 자주 묻는 질문을 모았습니다.
§01자주 묻는 질문
빠른 답변
- KwaFlux는 크레딧제인가요?KwaFlux는 크레딧제가 아니며 분당 요금도 없습니다. 모든 플랜에 출시된 로컬 모듈이 전부 포함됩니다.
- 제 영상을 AI 학습에 쓰나요?아니요. KwaFlux는 미디어 파일을 AI 모델 학습에 쓰지 않습니다. 처리는 사용자의 컴퓨터에서 이루어지고, 불러온 파일과 결과물은 모두 사용자의 것입니다.
- 처음 쓸 때 AI 모델을 내려받는 기능은 무엇인가요?KwaFlux 모듈은 대부분 설치 파일에 포함되어 있고, 몇 가지만 처음 쓸 때 모델을 한 번 내려받습니다. 다운로드는 무료입니다.
- 컴퓨터가 멈추거나 내보내기가 중간에 멈추면 어떻게 되나요?작업 센터에서 작업을 일시정지하고 다시 시작할 수 있습니다. KwaFlux나 컴퓨터가 중간에 멈춰도 다음에 “중단됨”으로 표시되어 다시 시도할 수 있습니다.
- KwaFlux를 Premiere Pro, DaVinci Resolve, Final Cut Pro와 함께 쓸 수 있나요?네, 별도의 단계로 씁니다. KwaFlux는 플러그인이 아닌 독립 앱입니다. MOV의 ProRes나 MP4의 H.264/H.265로 내보낸 뒤 편집 프로그램에 가져오세요.
§02블로그에서
사용 방법 가이드
- AI 어시스턴트에게 영상 작업 맡기기: KwaFlux MCP 빠른 시작Cursor, Claude, Codex 등 MCP 앱을 세 단계로 KwaFlux에 연결하고, 내 PC에 있는 영상의 복구, 화질 개선, 압축, 변환을 AI 어시스턴트에게 맡기는 방법입니다.
- 노이즈 제거, 50 MB로 줄이기, 망가진 파일 복구: AI 어시스턴트가 KwaFlux에서 할 수 있는 일채팅으로 시작할 수 있는 KwaFlux 기능 31가지를 정리했습니다. 오디오 정리, 목표 용량 압축, 파일 복구, AI 화질 향상, 그리고 9가지가 앱에 남는 이유까지.
- AI 에이전트가 화면을 클릭하면 안 되는 이유: 데스크톱 앱용 로컬 컨트롤 플레인 만들기화면 자동화는 쉽게 깨지고 권한을 너무 많이 줍니다. KwaFlux는 형식이 정해진 도구와 앱이 다시 구성하는 작업으로 AI 에이전트에게 데스크톱 앱을 맡깁니다.
- 로컬이라고 안전한 것은 아닙니다: AI 어시스턴트와 데스크톱 앱 사이의 채널 지키기로컬 MCP 연결에도 방어가 필요한 이유와 사용자별 명명된 파이프, 첫 인스턴스 소유, 128비트 토큰, 상수 시간 비교, 실패하면 닫히는 설정을 설명합니다.
- AI는 나 대신 확인을 누를 수 없습니다: 어시스턴트가 요청한 다운로드를 KwaFlux가 다루는 방법모델이 '사용자에게 권리가 있다'고 말해도 증명되는 것은 없습니다. KwaFlux의 세 가지 다운로드 모드와 데스크톱 승인으로 다운로드를 내가 결정하는 방법.
- 모델에게 내 드라이브를 보여 주지 마세요: AI가 다루는 데스크톱 앱의 경로·개인정보 규칙AI 어시스턴트가 KwaFlux에 보내는 것과 돌려받는 것: 파일을 열기 전에 거부되는 네트워크 경로, 원본 옆에 저장되는 결과, 매개변수를 남기지 않는 로그.
- 영상 제목이 AI에게 명령을 내린다면: KwaFlux의 프롬프트 인젝션 방어웹 텍스트에는 AI를 향한 명령이 숨어 있을 수 있습니다. KwaFlux의 필드 허용 목록, 숨은 유니코드 제거, 길이 제한, 이미지 링크 제외, 표시 방식을 정리했습니다.
- Cursor에서 KwaFlux 쓰는 법: MCP 설정, 첫 요청, 문제 해결버튼 하나나 mcp.json으로 KwaFlux 로컬 MCP 서버를 Cursor에 추가하고 연결을 확인한 뒤, Cursor 에이전트에게 영상 변환, 복구, 화질 향상을 맡기는 방법입니다.
- Claude Code와 Claude Desktop에서 KwaFlux 쓰는 법(MCP 설정)Claude Code는 명령 하나로, Claude Desktop은 구성 항목 하나로 KwaFlux에 연결하고, 연결을 확인한 뒤 Claude에게 영상 복구와 변환을 맡기는 방법입니다.
- Codex에서 KwaFlux 쓰는 법: MCP 설정, 타임아웃, 승인codex mcp add나 config.toml로 OpenAI Codex에 KwaFlux를 추가하고, 긴 영상 작업에 맞게 도구 타임아웃을 늘리고, 도구 실행 전 승인 방식을 정하는 방법입니다.
- DeepSeek에서 KwaFlux 쓰는 법: MCP로 DeepSeek Harness(DSH) 연결하기cordis.patch.yml에 insert 행 하나로 DeepSeek Harness에 KwaFlux를 추가하고, 알맞은 프로필을 고르고 도구 타임아웃을 늘려 DeepSeek에게 영상 작업을 맡기세요.
- Hermes Agent와 OpenClaw에서 KwaFlux 쓰는 법(MCP 설정)hermes mcp add나 config.yaml로 Hermes Agent에, openclaw mcp set으로 OpenClaw에 KwaFlux를 추가하고, 에이전트를 앱과 같은 컴퓨터에서 실행하는 방법입니다.
- KwaFlux MCP가 안 될 때: 도구 누락, app_not_running, 타임아웃 해결법도구가 안 보이거나, 모든 호출이 app_not_running을 반환하거나, 대기가 타임아웃되거나, 작업이 거부될 때 KwaFlux MCP 증상별 의미와 해결 방법을 정리했습니다.
- '안 열리는 영상'에서 업로드까지: KwaFlux로 끝내는 AI 에이전트 워크플로재생되지 않는 휴대폰 영상 하나를 진단, 복구, 화질 복구, 플랫폼용 내보내기까지 AI 어시스턴트에게 요청하고 KwaFlux로 처리하는 과정을 따라가 봅니다.
- 할로윈 사진이 너무 어둡게 나왔다면? AI로 어두운 밤 사진과 영상 밝게 살리는 법트릭 오어 트릿 사진이 새까맣고 자글자글하게 나왔나요? 할로윈 밤 사진이 어두운 이유와, 촛불 빛은 살리면서 어두운 사진과 영상을 AI로 밝히는 방법.
- 흐릿한 할로윈 사진과 영상, AI로 선명하게 살리는 방법코스튬 사진은 흐릿하고, 메신저로 받은 퍼레이드 영상은 깍두기처럼 깨졌나요? 할로윈 사진과 영상이 흐려지는 이유와 AI 복구로 선명하게 만드는 방법.
- 흔들린 할로윈 영상, 트릭 오어 트릿·퍼레이드·귀신의 집 영상 흔들림 보정하는 법트릭 오어 트릿, 퍼레이드, 귀신의 집에서 찍은 흔들린 영상. AI로 할로윈 영상 흔들림을 잡는 법과 크롭으로 잃는 것, 고칠 수 없는 것을 정리했습니다.
- 할로윈 파티 사진 보정: 코스튬 셀카 리터치부터 AI로 으스스한 메이크업 입히기까지할로윈 파티 셀카를 AI로 보정하세요. 밤샘 뒤 피곤한 눈가는 환하게, 마녀·뱀파이어 메이크업과 보라색 머리는 더하고, 내 얼굴다운 모습은 그대로 지키는 방법.
- 옛날 할로윈 사진 복원: 흑백 사진 컬러 복원부터 가족 코스튬 추억 되살리기까지할머니의 1950년대 마녀 코스튬, 누렇게 바랜 1980년대 사진까지. 옛날 할로윈 사진을 스캔해 복원하고, 바랜 색을 고치거나 컬러를 입히면서 원본은 지키는 방법.
- AI로 만드는 으스스한 할로윈 영상 효과: 슬로 모션, 유령의 숲 배경, 폭풍우 하늘평범한 할로윈 영상을 으스스하게 바꿔 보세요. 망토나 불꽃에는 AI 슬로 모션을, 코스튬 뒤에는 달빛 비치는 호박 배경을, 집 위에는 폭풍 구름을 더하는 법.
- 할로윈 파티 사진·영상 정리: AI로 사진 속 행인과 배경 소음 지우기코스튬 사진에 찍힌 낯선 사람의 다리, 파티 소음에 묻힌 건배사. 할로윈 파티 사진 속 행인을 지우고 영상 소리를 정리하는 방법과 AI로도 안 되는 것을 알아봅니다.
- AI 영상 화질 개선 속도 높이는 법: 작업 순서, 설정, 하드웨어AI 영상 화질 개선이 느린 이유와 빠르게 만드는 방법: 처리할 분량 줄이기, 출력 크기 고르기, 단계 순서 정하기, GPU와 앱 설정 제대로 쓰기를 정리했습니다.
- 화질 저하가 눈에 띄지 않게 동영상 용량 줄이는 법: H.264 vs H.265 vs AV1화질 저하 없이 동영상 용량 줄이기: H.264, H.265, AV1 중 고르고 비트레이트나 CRF를 정한 뒤 결과를 확인하세요. 무료 도구와 데스크톱 방법 포함.
- 720p 영상을 1080p로 업스케일하는 방법 (그리고 1080p에서 멈춰야 할 때)KwaFlux, HandBrake, FFmpeg로 720p 영상을 1080p로 업스케일하세요. 정확한 설정, 내보낼 비트레이트, 4K까지 올릴 가치가 없는 경우를 정리했습니다.
- 저조도·야간 영상을 플라스틱 피부 없이 보정하는 방법어둡고 노이즈 많은 야간 영상을 밀랍 같은 얼굴이나 회색 검정 없이 밝히는 법. AI 야경 복구, 무료 FFmpeg·HandBrake 설정, 촬영 팁.
- AI로 흑백 영상을 채색하는 방법(단계별 안내)AI로 흑백 영상을 채색하는 방법입니다. 영상 정리, 채색 강도 설정, 피부색과 깜빡임 확인, 결과물에 정직하게 표시하는 법까지 다룹니다.
- 깨진 픽셀 영상 고치는 방법: 압축 블록과 낮은 해상도 구분하기영상이 깨져 보이는 원인은 압축 블록과 낮은 해상도 두 가지입니다. 둘을 구분하는 법과 더 나은 원본, 디블로킹, AI로 각각 고치는 법.
- Codex, Claude, OpenClaw, DeepSeek, Hermes, Cursor에서 KwaFlux를 다루기KwaFlux에는 로컬 MCP 서버가 들어 있습니다. 앱을 연 채로 Codex, Claude, OpenClaw, DeepSeek, Hermes 또는 Cursor에 연결하세요. 변환, 복구, 향상, 다운로드는 로그인과 유료 플랜이 필요합니다.
- AI로 동영상 화질 개선: 4K 업스케일링을 자연스럽게 하는 법AI 영상 업스케일 실전 가이드: 되살릴 수 있는 것, 한계, 480p·720p 원본에서 재구성된 프레임을 판단하는 법.
- 오래된 동영상 화질 개선: AI 복원 방법 — 그레인, 색, 디테일AI로 오래된 영상을 복원하는 단계별 가이드: 그레인 제거, 색 바램 수정, 오래되거나 손상된 영상에서 디테일 되살리기.
- 그린스크린 없이 동영상 배경을 지우려면?AI 컷아웃이 프레임마다 피사체를 분리해 합성, 배경 교체, 깨끗한 컷아웃에 쓰는 법. 스튜디오 없이.
- Sora, Kling, Veo 영상을 로컬에서 4K로 올리는 법AI 생성기는 인상적인 클립을 만들지만 해상도는 낮은 편입니다. 생성 영상이 흐릿해 보이는 이유, 스타일별로 맞는 복구 유형, 일괄 처리까지 되는 로컬 작업 흐름.
- 흐린 동영상 화질 개선: AI로 선명하게 만드는 법과 한계흐림, 부드러움, 픽셀화를 고치는 다섯 가지 — 무료 샤픈부터 로컬 AI 흐림 제거까지. 맞는 방법을 고르는 법.
- 동영상 노이즈 제거: AI로 얼굴을 뭉개지 않고 하는 법그레인을 남겨야 할 때, 노이즈 제거가 잘 되는 영상, 무료 1초/3초/5초 미리보기. 미리보기는 계정 없이 됩니다.
- AI로 흔들린 영상을 안정화하는 법 (크롭이 너무 클 때)자동과 피사체 고정이 각각 화면을 얼마나 잘라 내는지, 롤링 셔터 주의점, 무료 5·15·30초 미리보기. 미리보기는 계정 없이 됩니다.
- H.264, H.265, MP4, MOV를 로컬에서 변환 — 업로드 없이보정 후 로컬에서 마스터 납품 — 코덱, 컨테이너, 내장 변환기가 중요한 이유.
- 동영상 소음 제거: 배경 잡음과 울림을 로컬에서 지우는 법시청자는 조금 흐린 화면은 참아도 치직거리는 대사는 참지 못합니다. 노이즈 제거, 방 울림 줄이기, 보컬 분리를 화면과 같은 로컬 작업 안에서 끝내므로 오디오를 따로 뽑아 다시 넣을 필요가 없습니다.
- SDR을 HDR로, AI 프레임 보간까지 — 업스케일 없이 동영상 화질 개선이미 1080p인데 바랬거나 끊기나요? SDR→HDR, AI 색보정, 프레임 보간이 로컬에서 돌아갑니다. 무료 1초/3초/5초 미리보기는 계정 없이 됩니다.
- 합성 프로그램 없이 영상 배경을 바꾸려면?AI 스마트 컷아웃은 인물을 오려 내고 뒤에 단색, 스틸, 블러 플레이트를 까는 일을 로컬에서 한 번에 끝냅니다. After Effects 그래프까지는 필요 없을 때.
- 로컬 AI로 영상의 물체를 교체하는 방법소품이나 차량을 클릭하면 SAM2가 추적하고, 그 주변 배경을 투명·단색·갤러리 이미지·블러로 바꿉니다. 클립을 업로드할 필요가 없습니다.
- 로토스코핑 없이 영상의 하늘을 바꾸는 방법하늘 교체는 칙칙하거나 날아간 하늘을 위한 로컬 도구입니다. 무료 1초/3초/5초 미리보기로 수평선을 확인하세요. 미리보기는 계정 없이 됩니다.
- 영상에서 물체를 제거하는 방법 — 로컬, 클라우드 아님동적 추적 제거는 움직이는 사람이나 차를 따라가고, 정적 물체 제거는 움직이지 않는 물체를 메워 지웁니다. 둘 다 내 영상에서 표시한 물체만 지웁니다.
- 동영상이 재생되지 않거나 열리지 않을 때 복구하는 법비디오 파일 복구는 재생되지 않는 MP4를 로컬에서 진단합니다. Auto, Quick, Deep, Smart 모드와 같은 카메라의 참조 파일(선택)을 지원합니다. 화질 개선 도구는 아닙니다.
- 로컬에서 영상 자막을 편집하는 방법 — SRT/ASS, 번역 아님자막 편집은 SRT/ASS 자막을 다루는 로컬 도구입니다. 스타일, 타이밍, 번인, MKV 소프트 자막을 지원하며 번역과 음성 자막 생성은 이번 버전에 없습니다.
- 데스크톱 AI 이미지 화질 개선: 복구, 4K 업스케일, 컷아웃(업로드 없음)스마트 복구와 특수 장면 복구(1배~4K), 인물 컷아웃, 물체 컷아웃/제거, 폴더 일괄 — GPU에서, 업로드 없음. 미리보기는 계정 없이 무료.
- 480p에서 4K: AI가 복구할 수 있는 것과 없는 것480p로 만든 4K 파일은 플레이어로 늘린 화면보다 낫지만, 처음부터 4K로 찍은 영상에는 못 미칩니다. 재구성되는 것, 깨끗해지기만 하는 것, 이미 사라진 것을 나눠 봅니다.
- 어떤 복구 유형을 고를까: 스마트 복구냐 장면이냐화질 복구에는 얼굴까지 알아서 복구하는 스마트 복구와 애니메·야경·복원용 특수 장면 복구가 있고, 소재를 잘못 고르면 저마다 다르게 망가집니다. 내보내기 전에 고르는 법을 정리했습니다.
- 영상이 열리지 않을 때 파일 복구가 실제로 하는 일재생이 안 되는 건 컨테이너 문제이지 화질 문제가 아닙니다. 진단한 뒤 Quick / Deep / Smart로 복구하며, 같은 카메라로 찍은 참조 파일을 함께 쓸 수도 있습니다. 화질 개선 도구는 아닙니다.
아직 해결되지 않았나요?
support@kwaflux.com로 메일을 보내거나 Discord에서 질문해 주세요.