먼저 spicetify --version을 실행하세요. PowerShell에 버전이 나오면 CLI가 PATH에서 인식됩니다. 명령어를 찾지 못하면 apply나 restore 전에 설치 또는 PATH를 고치세요.
설정 확인은 spicetify config, 일반 변경 적용은 spicetify apply, 첫 설치나 Spotify 리소스 교체 뒤에는 spicetify backup apply, 저장한 깨끗한 리소스로 돌아갈 때는 spicetify restore를 사용합니다. 파일을 바꾸기 전에 Spotify를 종료하세요.
작업별 Spicetify 명령어 빠른 표
원하는 결과에 맞춰 명령어를 선택하세요. 출력, 현재 버전, Spotify 패키지, 공식 복구 절차도 함께 확인해야 합니다.
| 작업 | PowerShell 명령어 | 동작 | 주의 |
|---|---|---|---|
| CLI 확인 | spicetify --version | 활성 버전을 표시 | PowerShell이 찾은 실행 파일 확인 |
| 설정 확인 | spicetify config | 설정과 경로 표시 | 경로 변경 전 확인 |
| 현재 설정 적용 | spicetify apply | 테마와 확장 기능 적용 | Spotify 먼저 종료 |
| 백업 후 적용 | spicetify backup apply | 지원 리소스를 저장하고 적용 | 첫 설치 또는 리소스 교체 뒤 |
| 복원 | spicetify restore | 저장한 깨끗한 기준 복원 | CLI는 삭제하지 않음 |
| 업데이트 | spicetify update | 지원 설치 방식 업데이트 | 원래 설치 방식 확인 |
| 도움말 | spicetify --help | 현재 버전의 명령어와 옵션 표시 | 오래된 목록보다 우선 |
CLI 명령어는 PowerShell, 명령 프롬프트, macOS/Linux 터미널에서 대체로 같습니다. 설치, 경로, 권한, 패키지 관리자는 다릅니다.
PowerShell을 안전하게 열고 Spicetify 확인하기
일반 사용자 계정으로 PowerShell을 여세요. 관리자 모드는 기본값이 아니며 Spotify와 Spicetify 및 일반 데스크톱 세션 사이에 소유권과 접근 권한 차이를 만들 수 있습니다.
복구 전에 spicetify --version을 실행하세요. 이름을 인식하지 못하면 제3자 실행 파일을 받거나 PATH를 무작정 바꾸지 말고 PowerShell을 다시 열어 공식 설치 안내를 확인하세요.
중복 설치가 의심되면 Get-Command spicetify를 사용하세요. PATH 앞쪽의 오래된 실행 파일 때문에 업데이트 뒤에도 다른 버전이 실행될 수 있습니다.
- 1
버전 확인
CLI 인식 여부와 전체 버전을 기록합니다.
spicetify --version - 2
실행 파일 위치 확인
중복되거나 오래된 설치가 있을 때 경로를 확인합니다.
Get-Command spicetify - 3
내장 도움말 읽기
설치된 버전의 명령어와 옵션을 봅니다.
spicetify --help
Spicetify 설정 명령어와 경로 확인하기
인수 없이 spicetify config를 실행하면 현재 설정을 볼 수 있습니다. Spotify 경로, 테마, 색상 구성, 확장 기능, 사용자 앱과 동작 옵션이 포함됩니다.
기본 형식은 spicetify config 키 값입니다. 테마는 current_theme과 color_scheme을 설정한 뒤 spicetify apply를 실행할 수 있습니다. 한 번에 하나만 바꾸면 오류 원인을 찾기 쉽습니다.
prefs_path와 spotify_path는 지원되는 데스크톱 Spotify를 가리켜야 합니다. 웹 플레이어, 임의 캐시, 검증되지 않은 패키지 폴더를 지정하지 마세요.
spicetify config
변경 적용, 백업, 복원하기
정상 설치의 일반 변경은 spicetify apply, 깨끗한 기준이 없거나 Spotify가 리소스를 교체한 경우는 spicetify backup apply, 저장한 기준으로 돌아갈 때는 spicetify restore를 사용합니다.
apply, backup, restore 전에 Spotify를 완전히 종료하세요. 같은 명령어를 반복하지 말고 첫 번째 분명한 오류를 저장해 호환성, 경로, 권한, 확장 기능, 오래된 리소스를 구분하세요.
restore는 제거가 아닙니다. CLI, 설정, 테마와 확장 기능이 남을 수 있습니다. 완전 제거는 제거 안내를 따르세요.
| 상황 | 명령어 | 다음 단계 |
|---|---|---|
| 테마 또는 확장 기능 변경 | spicetify apply | Spotify를 열어 한 항목 확인 |
| 첫 설치 또는 유효한 백업 없음 | spicetify backup apply | 완료될 때까지 기다리기 |
| 깨끗한 상태 비교 | spicetify restore | 사용자 설정 없이 테스트 |
| Spotify 업데이트 뒤 사라짐 | spicetify backup apply | 먼저 CLI 호환성 확인 |
올바른 Spicetify 업데이트 명령어 선택하기
업데이트 방식은 설치 방법에 따라 다릅니다. 지원되는 설치 프로그램 방식은 spicetify update를 쓸 수 있고, 패키지 관리자로 설치했다면 일반적으로 같은 관리자로 업데이트합니다.
업데이트 뒤 spicetify --version을 실행하고 공식 GitHub와 비교하세요. 이 안내에서 확인한 최신 버전은 2026년 7월 4일 UTC에 공개된 v2.44.0입니다. 이후 릴리스로 바뀔 수 있습니다.
Spicetify 업데이트와 Spotify 업데이트는 다릅니다. Spotify가 리소스를 교체하면 새 backup/apply가 필요할 수 있습니다. 제3자 구버전 설치 파일을 사용하기 전에 호환성을 확인하세요.
spicetify update
PowerShell 및 PATH 오류와 관리자·프로세스 문제 해결하기
첫 번째 분명한 오류를 근거로 사용하세요. 명령어 인식 실패는 설치나 PATH, 관리자 경고는 잘못된 권한 상승, 접근 거부는 열린 프로세스나 권한 불일치가 흔한 원인입니다.
| 증상 | 가능한 원인 | 안전한 조치 |
|---|---|---|
| spicetify를 인식하지 못함 | PATH에 없거나 PowerShell이 갱신되지 않음 | 다시 열고 Get-Command로 확인한 뒤 공식 설치 복구 |
| 관리자로 실행하지 말라는 경고 | 관리자 PowerShell | 닫고 일반 권한으로 실행 |
| 접근 거부 | Spotify 실행 중 또는 권한 불일치 | 프로세스를 닫고 관리자 실행 피하기 |
| Spotify를 찾지 못함 | 패키지나 경로 오류 | 데스크톱 앱을 열고 spicetify config 확인 |
| 업데이트 뒤 사용자 설정 사라짐 | Spotify가 리소스를 교체 | 호환성 확인 후 backup/apply |
관리자 또는 호환성 검사를 우회하는 옵션은 검은 화면, 누락된 PATH, 잠긴 파일의 일반적인 해결책이 아닙니다.
Spicetify PowerShell 명령어 자주 묻는 질문
가장 먼저 실행할 Spicetify PowerShell 명령어는 무엇인가요?
spicetify --version으로 PowerShell이 CLI를 찾는지와 활성 버전을 확인하세요.
Spicetify를 관리자로 실행해야 하나요?
일반적으로 아닙니다. 현재 공식 안내가 특정 단계에서 요구하지 않는 한 일반 사용자 권한을 사용하세요.
apply와 backup apply의 차이는 무엇인가요?
apply는 기존 기준을 사용하고 backup apply는 지원되는 깨끗한 기준을 만들거나 갱신한 뒤 적용합니다.
Spotify를 복원하는 명령어는 무엇인가요?
spicetify restore로 저장한 깨끗한 리소스를 복원합니다. CLI 전체는 제거하지 않습니다.
모든 명령어는 어떻게 확인하나요?
spicetify --help와 설치된 버전에 맞는 공식 CLI 참고서를 사용하세요.
spicetify 명령어를 인식하지 못하는 이유는 무엇인가요?
CLI나 PATH 문제 또는 PowerShell 재시작이 필요할 수 있습니다. Get-Command spicetify와 공식 설치 안내를 확인하세요.
사용한 공식 소스
- Spicetify CLI 명령어 참고서 — 명령어와 옵션 공식 문서.
- Spicetify 시작 안내 — 설치, 업데이트, 백업과 적용 공식 절차.
- Spicetify v2.44.0 — 2026년 7월 4일 UTC 공개 확인 버전.