설치
최초 사용 전 환경 준비
빠른 사용
사용자: 환경 설치
사용자: 초기화
의존성 목록
| 의존성 | 용도 | 설치 명령어 |
|---|---|---|
| Node.js | 스크립트 실행 | brew install node |
| FFmpeg | 비디오 편집 | brew install ffmpeg |
| curl | API 호출 | 시스템 내장 |
API 구성
Volcengine 음성 인식
콘솔: https://console.volcengine.com/speech/new/experience/asr?projectName=default
- Volcengine 계정 등록
- 음성 인식 서비스 활성화
- API Key 획득
프로젝트 디렉토리 .claude/skills/.env에 구성:
# 파일 경로: 편집Agent/.claude/skills/.env
VOLCENGINE_API_KEY=your_api_key_here
설치 과정
1. Node.js + FFmpeg 설치
↓
2. Volcengine API Key 구성
↓
3. 환경 검증
실행 단계
1. 의존성 설치
# macOS
brew install node ffmpeg
# 검증
node -v
ffmpeg -version
2. API Key 구성
# 프로젝트 .claude/skills/ 디렉토리에 .env 파일 생성
echo "VOLCENGINE_API_KEY=your_key" >> .claude/skills/.env
3. 환경 검증
# Node.js 확인
node -v
# FFmpeg 확인
ffmpeg -version
# API Key 확인 (프로젝트 디렉토리에서 실행)
cat .claude/skills/.env | grep VOLCENGINE
자주 묻는 질문
Q1: API Key는 어디서 얻나요?
Volcengine 콘솔 → 음성 기술 → 음성 인식 → API Key
Q2: ffmpeg 명령어를 찾을 수 없습니다
which ffmpeg # 경로가 출력되어야 함
# 없으면 재설치: brew install ffmpeg
Q3: 파일명에 콜론이 포함되어 오류가 발생합니다
FFmpeg 명령어에 file: 접두사를 추가하세요:
ffmpeg -i "file:2026:01:26 task.mp4" ...