Qwen3 Tts Claude Skill

Qwen3-TTS Claude Code Skill

**[Qwen3-TTS-12Hz-1.7B-CustomVoice](https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice)** 및 **[Qwen3-TTS-12Hz-1.7B-Base](https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-Base)** 모델의 설치와 사용을 돕는 Claude Code 스킬입니다.

[한국어](#한국어) | [English](#english)

---

한국어

Alibaba Qwen 팀이 개발한 오픈소스 TTS 모델 [Qwen3-TTS](https://github.com/QwenLM/Qwen3-TTS)를 Claude Code에서 쉽게 설치하고 사용할 수 있도록 도와주는 스킬입니다.

이 스킬이 하는 일

• Qwen3-TTS-12Hz-1.7B-CustomVoice / Qwen3-TTS-12Hz-1.7B-Base 모델 자동 설치
• 시스템 환경 자동 스캔 (GPU, CUDA, Python 버전)
• 환경에 맞는 설치 옵션 제공 (GPU 가속 / CPU 전용)
• WebUI 실행 및 관리

주요 기능

• 음성 클론: 3초 참조 오디오로 어떤 목소리든 복제 (Base 모델)
• 프리셋 음성: 9개의 프리미엄 음성 프로필 (CustomVoice 모델)
• 10개 언어 지원: 한국어, 영어, 중국어, 일본어, 독일어, 프랑스어, 러시아어, 포르투갈어, 스페인어, 이탈리아어

원본 리소스

리소스	URL
HuggingFace (CustomVoice)	https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice
HuggingFace (Base/Clone)	https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-Base
GitHub	https://github.com/QwenLM/Qwen3-TTS
공식 데모 (Clone)	https://huggingface.co/spaces/Qwen/Qwen-TTS-Clone-Demo
공식 데모 (TTS)	https://huggingface.co/spaces/Qwen/Qwen3-TTS-Demo

설치 방법

1. qwen3-tts.md를 Claude Code commands 디렉토리에 복사:

# 다운로드 및 설치
curl -o ~/.claude/commands/qwen3-tts.md \
  https://raw.githubusercontent.com/treylom/qwen3-tts-claude-skill/main/qwen3-tts.md

1. Claude Code에서 설치 명령 실행:

/qwen3-tts install

1. 스킬이 환경을 스캔하고 설치 옵션을 제공합니다:
   • GPU 가속 설치 (NVIDIA GPU 감지 시 권장)
   • CPU 전용 설치
   • 업그레이드 (이미 설치된 경우)

사용법

명령어	설명
/qwen3-tts install	설치 (환경 스캔 → 옵션 선택)
/qwen3-tts clone	음성 클론 WebUI 시작 (Base 모델)
/qwen3-tts custom	프리셋 화자 WebUI 시작 (CustomVoice 모델)
/qwen3-tts stop	WebUI 종료
/qwen3-tts status	상태 확인
/qwen3-tts log	로그 확인
/qwen3-tts uninstall	제거

옵션

/qwen3-tts clone port=7860    # 포트 지정 (기본: 8000)