이 글의 목적은 Microsoft Office 클릭투런(Click-to-Run) 서비스 오류를 체계적으로 진단하고 근본 원인별로 복구하는 실무 절차를 제공하여, 기업 IT 관리자와 고급 사용자가 현장에서 즉시 적용할 수 있도록 돕는 것이다.
개요: 클릭투런 아키텍처와 오류의 본질
클릭투런은 스트리밍 기반 가상화 기술로 Office를 빠르게 배포하고 서비스로 관리하는 설치 방식이다. 핵심 구성요소는 ClickToRunSvc(서비스), OfficeC2RClient.exe(클라이언트), 가상화 계층, 업데이트 채널, 캐시 저장소로 구분된다. 오류는 주로 서비스 비정상, 저장소 손상, 권한·프록시·보안 소프트웨어 간섭, 업데이트 채널 불일치, 파일시스템·레지스트리 무결성 저하에서 발생한다.
증상 매핑: 현상별 원인 신속 식별
| 대표 증상 | 가능 원인 | 우선 점검 포인트 |
|---|---|---|
| Office 앱 실행 시 “수리를 준비하는 중” 반복 또는 무한 로딩 | 클릭투런 서비스 지연 시작, 캐시 손상 | 서비스 시작 유형, C:\Program Files\Common Files\Microsoft Shared\ClickToRun 무결성 |
| 오류 코드 0x426-0x0 또는 30068-39 | 서비스 중지, 바이러스 백신 차단 | sc query ClickToRunSvc, 실시간 보호 예외 |
| 업데이트 실패 0x8024002e | WSUS/프록시 정책 충돌 | 업데이트 채널, 프록시 인증 방식, 시스템 계정 통신 |
| 설치 진행 중 99%에서 멈춤 | 네트워크 QoS/프록시 캐싱 이슈, BITS 충돌 | BITS 상태, 프록시 바이패스, 네트워크 캡처 |
| “OfficeC2RClient.exe 응답 없음” | 프로필 경로 권한 문제, 디스크 I/O 지연 | 사용자 프로필 권한, 디스크 SMART, 이벤트 로그 |
1단계: 환경 파악과 안전 조치
진단 전 사용자 데이터 손상을 방지하고 변경 이력을 남겨야 한다. 다음 항목을 사전 수행한다.
- 관리자 권한 PowerShell 세션을 확보한다.
- 모든 Office 앱을 종료하고 백그라운드 프로세스
OfficeClickToRun.exe,OfficeC2RClient.exe가 존재하면 종료한다. - 중요 템플릿·추가 기능 폴더를 백업한다.
# 관리자 PowerShell 권장 시작 whoami /groups Get-Process *office* | Stop-Process -Force
사용자 중요 경로 백업
$dt = Get-Date -Format yyyyMMdd_HHmm
$src = "$env:APPDATA\Microsoft\Templates"
$dst = "C:\Backup\OfficeTemplates_$dt"
New-Item -ItemType Directory -Force -Path $dst | Out-Null
Copy-Item -Recurse -Force $src $dst
주의 : 원격·VDI 환경에서 공용 이미지에 개입할 때는 마스터 이미지와 사용자 프로필 분리를 확인하고 롤백 스냅샷을 준비한다.
2단계: 서비스 상태 진단
클릭투런 서비스는 이름이 ClickToRunSvc, 표시 이름이 “Microsoft Office 클릭-투-런 서비스”이다. 다음 절차로 상태를 확인한다.
sc query ClickToRunSvc sc qc ClickToRunSvc Get-Service ClickToRunSvc | Select-Object Name,Status,StartType - 중지됨이면 시작 유형을
자동으로 변경하고 즉시 시작한다. - 시작 지연이면 “자동(지연 시작)”을 해제하고 표준 자동으로 전환한다.
Set-Service -Name ClickToRunSvc -StartupType Automatic Start-Service -Name ClickToRunSvc 주의 : 제3자 최적화 도구가 서비스 시작 유형을 무단 변경하는 경우가 있으므로 작업 스케줄러와 레지스트리의 불필요한 튜닝 항목을 점검한다.
3단계: 이벤트 로그·설치 로그 분석
이벤트 뷰어에서 다음 로그를 확인한다.
Applications and Services Logs > Microsoft > Office > ClickToRunWindows Logs > Application에서OfficeC2RClient,ClickToRunSvc이벤트
# 최근 200개 클릭투런 이벤트 수집 Get-WinEvent -LogName "Microsoft-Office ClickToRun/Operational" -MaxEvents 200 | Select-Object TimeCreated, Id, LevelDisplayName, Message 설치·업데이트 로그는 기본적으로 C:\ProgramData\Microsoft\ClickToRun\Log에 존재한다. 대용량 로그는 날짜 기준으로 정렬 후 최근 실패 패턴을 우선 확인한다.
4단계: 네트워크·프록시 점검
클릭투런은 서비스 계정 컨텍스트에서 CDN에 접근한다. 인증형 프록시 또는 SSL 검사 기법은 오류를 유발한다. 다음을 점검한다.
- 시스템 계정 통신이 필요한 경우 프록시 우회 또는 장치별 허용 목록을 구성한다.
- SSL 가로채기 기능은 클릭투런 트래픽에 대해 제외한다.
- BITS가 정상 동작하는지 확인한다.
# BITS 상태 bitsadmin /list /allusers /verbose
프록시 구성 확인(시스템 범위)
netsh winhttp show proxy
| 항목 | 권장 설정 | 리스크 |
|---|---|---|
| 프록시 인증 | 장치/서버 측 화이트리스트로 무인 통신 허용 | 인증 프롬프트 미표시로 무한 대기 |
| SSL 검사 | Office CDN 도메인 예외 | TLS 재암호화로 핸드셰이크 실패 |
| BITS 정책 | 전송 제한 완화 또는 시간창 조정 | 대역폭 제한으로 설치 지연 |
5단계: 보안 제품·샌드박스 예외
실시간 보호가 OfficeC2RClient.exe, OfficeClickToRun.exe, AppVIsvSubsystems*.dll를 차단하면 설치·업데이트가 실패한다. 다음 경로를 예외 처리한다.
C:\Program Files\Common Files\Microsoft Shared\ClickToRun\C:\Program Files\Microsoft Office\root\C:\ProgramData\Microsoft\ClickToRun\%LOCALAPPDATA%\Microsoft\Office\
주의 : EDR의 행위 차단 규칙에서 “자기 업데이트”, “프로세스 인젝션” 유사 패턴이 오탐으로 탐지될 수 있다. 벤더 콘솔에서 이벤트를 상관 분석하고 해시 기준 허용 규칙을 추가한다.
6단계: 캐시·구성 복구(빠른 복구)
서비스가 정상이고 네트워크·보안 이슈가 없으면 캐시 및 구성 복구를 시행한다. 빠른 복구는 구성 파일과 로컬 캐시를 치유한다.
# C2R 복구 명령(무인) & "$Env:ProgramFiles\Common Files\Microsoft Shared\ClickToRun\OfficeC2RClient.exe" /update user updatetoversion=latest displaylevel=false forceappshutdown=true 제어판 “프로그램 및 기능”에서 Microsoft 365 항목의 “빠른 복구” 수행도 동일 효과를 낸다. 사용자 프로필별 설정 손실을 최소화하려면 먼저 빠른 복구를 시도한다.
7단계: 심화 복구(온라인 복구)
빠른 복구로 해결되지 않으면 온라인 복구를 통해 바이너리 재배치를 수행한다. 이 과정은 네트워크 대역폭을 많이 사용한다.
- 프록시·방화벽 예외가 선행되어야 한다.
- 중요 플러그인·VSTO 추가 기능은 재배포가 필요할 수 있다.
# 온라인 복구 전 사전 정리(서비스 재시작 및 임시캐시 정리) Stop-Service ClickToRunSvc -Force Remove-Item -Recurse -Force "C:\ProgramData\Microsoft\ClickToRun\Temp" -ErrorAction SilentlyContinue Start-Service ClickToRunSvc 주의 : 온라인 복구는 사용자 개입 없이 장시간 소요될 수 있다. 원격 세션 종료 시 중단될 수 있으므로 전원 정책과 절전 모드를 해제한다.
8단계: 업데이트 채널·제품 구성 점검
채널 불일치 또는 제품 SKU 전환 실패는 반복 수리 루프를 야기한다. configuration.xml 또는 레지스트리 채널 값을 확인한다.
# 설치 채널 조회(레지스트리) Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" | Select-Object UpdateChannel, CDNBaseUrl, VersionToReport, Platform, ProductReleaseIds 조직에서는 configuration.xml을 명시적으로 사용한다. 다음은 표준 예시이다.
<Configuration> <Add OfficeClientEdition="64" Channel="Current"> <Product ID="O365ProPlusRetail"> <Language ID="ko-kr"/> </Product> </Add> <Updates Enabled="TRUE" Channel="Current"/> <Display Level="None" AcceptEULA="TRUE"/> </Configuration> 주의 : MSI 기반 Office 잔존물과 C2R 혼재는 충돌을 유발한다. “Microsoft Office* MSI” 항목이 남아 있으면 제거 후 재설치를 진행한다.
9단계: 파일·권한·무결성 검증
설치 루트 폴더와 ProgramData 캐시의 권한이 손상되면 서비스가 정상이어도 오류가 지속된다.
# 핵심 경로 권한 점검 $paths = @( "$Env:ProgramFiles\Common Files\Microsoft Shared\ClickToRun", "$Env:ProgramFiles\Microsoft Office\root", "C:\ProgramData\Microsoft\ClickToRun" ) foreach ($p in $paths) { Get-Acl $p | Format-List }
시스템 파일 검사
sfc /scannow
DISM /Online /Cleanup-Image /RestoreHealth
디스크 용량 부족도 흔한 원인이다. 최소 수 GB의 여유 공간을 확보하고 임시 폴더를 정리한다.
10단계: 프로필·추가 기능 충돌 분리
새 사용자 프로필 또는 클린 부팅에서 재현 여부를 확인하면 사용자 영역 충돌을 빠르게 분리할 수 있다.
# 안전 모드에서 Office 실행 winword /safe excel /safe outlook /safe - 안전 모드에서 정상 동작하면 COM/VSTO 추가 기능을 하나씩 비활성화하여 범위를 축소한다.
- Enterprise 추가 기능은 배포 도구의 버전 호환성을 검증한다.
11단계: 레지스트리 수리 포인트
클릭투런 핵심 키는 다음과 같다. 수동 편집 전 반드시 백업한다.
reg export "HKLM\SOFTWARE\Microsoft\Office\ClickToRun" C:\Backup\C2R_before.reg reg export "HKLM\SOFTWARE\Microsoft\Office\16.0\Common\Internet" C:\Backup\OfficeNet_before.reg | 키 경로 | 값 | 설명 |
|---|---|---|
| HKLM\SOFTWARE\Microsoft\Office\ClickToRun\Configuration | UpdateChannel, CDNBaseUrl | 업데이트 채널·원본 경로 |
| HKLM\SOFTWARE\Microsoft\Office\ClickToRun\Configuration | VersionToReport | 보고 버전 문자열 |
| HKLM\SOFTWARE\Microsoft\Office\16.0\Common\Internet | UseOnlineContent | 온라인 콘텐츠 액세스 정책 |
주의 : 레지스트리 편집은 조직 정책과 충돌할 수 있다. GPO로 구성된 항목은 로컬 변경이 재부팅 후 원복될 수 있다.
12단계: 완전 제거 후 재배포(최후 수단)
모든 복구가 실패하면 공식 제거 도구 또는 배포 도구로 완전 제거 후 재설치를 진행한다. 사내 표준 구성의 configuration.xml을 사용하여 동일 채널·언어로 재배포한다.
# 서비스 종료 및 잔존 폴더 정리(신중히 사용) Stop-Service ClickToRunSvc -Force taskkill /IM OfficeC2RClient.exe /F
남은 폴더 제거(존재 시)
Remove-Item -Recurse -Force "$Env:ProgramFiles\Microsoft Office\root" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "C:\ProgramData\Microsoft\ClickToRun" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$Env:LOCALAPPDATA\Microsoft\Office" -ErrorAction SilentlyContinue
주의 : 폴더 강제 삭제는 권장되는 정석 절차가 아니다. 제거 전 전용 언인스톨러 사용을 우선 고려하고, 폴더 삭제는 잔존물이 복구를 방해할 때 제한적으로 수행한다.
현장 체크리스트: 15분 내 복구 루틴
- 서비스 자동·실행 상태 확인 및 즉시 시작한다.
- 네트워크 프록시·SSL 검사 예외와 BITS 상태를 검증한다.
- 보안 실시간 보호 예외를 등록한다.
- 빠른 복구를 수행하고 재부팅한다.
- 재현 시 온라인 복구로 전환한다.
- 채널·레지스트리 불일치 점검 및 정정한다.
- 끝까지 실패하면 완전 제거 후 재배포를 시행한다.
성공 판단 기준과 로그 확인 포인트
- 서비스 로그에 최신 “State transition: RepairCompleted” 또는 “UpdateCompleted” 이벤트가 기록되어야 한다.
- Office 앱 최초 실행 시 추가 구성 화면이 1회만 표시되어야 한다.
- 버전 조회 시 채널과 보고 버전이 조직 표준과 일치해야 한다.
# 설치 버전 확인 & "$Env:ProgramFiles\Microsoft Office\root\Office16\winword.exe" /ver
또는 레지스트리 확인
(Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration").VersionToReport
자주 발생하는 코드별 처치
| 오류 코드 | 의미 | 즉시 처치 |
|---|---|---|
| 0x426-0x0 | 클릭투런 서비스 시작 실패 | 서비스 자동 전환 후 시작, 백신 예외 추가, 빠른 복구 |
| 30068-39 | 업데이트 중 서비스 연결 오류 | 프록시/SSL 예외, BITS 확인, 온라인 복구 |
| 30175-4 | 파일 무결성 손상 | SFC/DISM, 캐시 제거, 온라인 복구 |
| 0x8024002e | 업데이트 정책 충돌 | WSUS/채널 정합성 확인, 정책 수정 |
엔터프라이즈 운영 팁
- 배포 파이프라인에서 네트워크·보안 예외를 코드로 선언하고 변경 관리한다.
- 버전 롤백 시 채널 스위치와 조합하지 않는다. 하나씩 적용하여 변수 수를 줄인다.
- VDI·멀티세션 환경은 프로필 컨테이너와 클릭투런 캐시 위치의 I/O 특성을 고려한다.
주의 : 롤백·채널 전환은 조직 내부 테스트 기준으로만 시행한다. 사용자 환경이 이질적이면 예기치 않은 플러그인 호환성 문제가 급증한다.
FAQ
클릭투런 서비스가 자동으로 중지되는 원인은 무엇인가?
보안 제품의 행위 차단, 잘못된 최적화 스크립트, 손상된 캐시가 원인이다. 이벤트 로그에서 서비스 종료 이벤트와 직전 보안 로그를 상관 분석한 뒤 예외를 등록하고 캐시 복구를 시행한다.
빠른 복구와 온라인 복구의 선택 기준은 무엇인가?
구성·캐시 경미 손상은 빠른 복구로 충분하다. 파일 무결성 손상, 버전 전환 실패, 반복 수리 루프는 온라인 복구가 필요하다. 네트워크 예외 구성 후 진행한다.
프록시 환경에서 무인 배포가 자주 실패한다. 대안은?
장치 기반 화이트리스트와 SSL 검사 예외를 사용한다. 시스템 계정 트래픽이 인증 프롬프트를 표시하지 않기 때문이다. 필요하면 배포 서버 캐시를 운영하여 내부 트래픽으로 종속시킨다.
MSI 잔존물이 있으면 어떤 문제가 생기나?
COM 등록 충돌과 파일 연계가 꼬여 Office 앱이 교차 호출 중 실패한다. MSI 항목을 제거하고 C2R만 유지한다.
오류 코드 없이 무한 로딩만 발생한다. 무엇을 보아야 하나?
디스크 I/O, BITS 대기, 보안 예외, 프로필 권한을 순서대로 점검한다. 로그와 자원 모니터를 병행한다.