클로드 데스크탑 실행 안 될 때: 설치 실패와 구분해 점검

클로드 데스크탑을 받아서 열려고 하는데 아무 일도 일어나지 않을 때가 있습니다. 검색해 보면 설치 방법을 알려 주는 글은 많은데, 설치는 이미 끝냈고 앱이 안 열리는 상황에 답하는 글은 드뭅니다. 공식 문서에도 설치 안내는 있지만 안 열릴 때 무엇을 봐야 하는지는 따로 정리돼 있지 않습니다.

그래서 이 글은 원인을 단정하지 않습니다. 대신 무엇부터 확인하면 범위가 좁아지는지를 순서대로 놓았습니다. 첫 단계에서 대부분이 걸러집니다.

두 증상의 구분: 설치 실패와 실행 실패

먼저 가를 것이 있습니다. 검색어로는 둘이 붙어 있지만 확인할 것이 다릅니다.

설치 파일이 아예 안 받아지거나 실행 중에 오류가 뜨면 앞엣것이고, 응용 프로그램 폴더나 시작 메뉴에 앱이 들어 있는데 눌러도 창이 안 뜨면 뒤엣것입니다. 아래 순서는 앞엣것부터 갑니다.

상태 페이지에 데스크탑 항목이 없습니다

내 컴퓨터를 뜯기 전에 확인할 것이 하나 있습니다. Anthropic의 상태 페이지(status.claude.com)에 장애가 올라와 있는지입니다. 서비스 쪽 문제라면 무엇을 해도 안 열립니다.

다만 이 페이지를 볼 때 알아 둘 것이 있습니다. 항목이 claude.ai, Claude Console, Claude API, Claude Code, Claude Cowork, Claude for Government으로 나뉘어 있고 데스크탑 앱은 따로 없습니다. 실제로 2026년 9월 29일 장애 기록에는 영향 범위를 적은 문장에 데스크탑과 모바일 앱이 함께 들어가 있는데, 항목 이름은 claude.ai입니다.

그래서 전부 초록색으로 보여도 데스크탑 앱이 안 될 수 있습니다. claude.ai 항목과 과거 장애 기록(Past Incidents)의 본문까지 읽어야 내 증상이 그 장애에 해당하는지 갈립니다. 웹 화면(claude.ai)도 같이 안 되면 서비스 쪽일 가능성이 높고, 웹은 되는데 앱만 안 되면 아래 항목들로 넘어갑니다.

시스템 요구사항: 맥 11, 윈도우 10, 우분투 22.04

가장 먼저 볼 항목이고 여기서 걸리는 경우가 가장 많습니다. 공식 문서가 적어 둔 최소 사양은 이렇습니다.

여기서 한 가지 주의할 것이 있습니다. 검색 결과에 클로드 데스크탑의 요구사항이 macOS 13 이상이라고 적힌 안내가 돌아다니는데, 그 값은 데스크탑 앱이 아니라 터미널에서 쓰는 Claude Code(클로드 코드)의 요구사항입니다. 두 제품은 요구사항이 다릅니다. 맥 11이나 12를 쓰고 계시다면 데스크탑 앱은 지원 범위 안입니다.

리눅스는 배포판과 버전을 같이 봐야 합니다. 우분투 20.04나 데비안 11처럼 한 세대 이전이면 목록에 없습니다.

설치가 멈출 때: 파일과 네트워크

요구사항을 넘겼는데 설치가 안 된다면 받은 파일 자체를 봅니다. 설치 파일을 눌렀을 때 아무 반응이 없거나 알 수 없는 형식이라고 나오면, 다운로드가 중간에 끊겨 파일이 온전하지 않은 경우가 있습니다. 파일 크기가 비정상적으로 작으면 다시 받는 편이 빠릅니다.

받는 것부터 막힌다면 네트워크 쪽입니다. 다음 절을 보세요.

지역 제한과 회사 네트워크: 확정이 아닌 점검 항목

설치 파일을 받으려는데 파일이 아니라 웹 페이지나 오류 번호가 돌아오는 경우가 있습니다.

같은 회사의 다른 제품인 Claude Code(클로드 코드)의 문서에 이 상황을 가르는 안내가 있습니다. 받은 내용에 해당 지역에서 이용할 수 없다는 안내가 있으면 그 나라에 아직 제공되지 않는 것이고, 안내 없이 403만 돌아오면 대개 프록시나 네트워크 필터가 주소를 막고 있는 것이라고 적혀 있습니다. 회사 프록시 뒤에서는 프록시 주소를 환경 변수로 지정하고 설치하라는 안내도 함께 있습니다.

다만 그 문서는 설치 스크립트 이야기이고 데스크탑 앱 설치 파일에도 같은 조건이 적용된다는 서술은 제가 확인하지 못했습니다. 그래서 이 항목은 원인 확정이 아니라 점검할 것으로만 둡니다. 개인 네트워크에서 같은 주소로 받아 보면 회사 네트워크 쪽인지 아닌지는 갈립니다. 회사 네트워크 쪽이라면 개인 설정으로 우회하지 말고 담당 부서에 요청하는 것이 맞습니다.

창이 뜨는데 화면이 비어 있을 때

공식 문서가 이 증상에 이름을 붙여 두었습니다. **「시작 시 빈 화면 또는 정지된 화면」**입니다. 앱은 열리는데 아무것도 안 보이거나 반응이 없는 경우이고, 문서가 확인할 것 넷을 순서로 줍니다.

먼저 앱을 다시 시작합니다. 그다음 보류 중인 업데이트를 확인합니다. 맥과 윈도우는 시작할 때 자동으로 업데이트되지만 리눅스는 apt로 직접 올려야 합니다.

세 번째가 회사 기기에서 걸리는 항목입니다. 관리되는 네트워크에서는 방화벽이 앱이 쓰는 CDN 주소를 막고 있을 수 있어서, 네트워크 요구사항에 적힌 호스트가 허용돼 있는지 봐야 합니다.

마지막은 로그입니다. 윈도우라면 이벤트 뷰어의 Windows 로그 아래 애플리케이션에서 충돌 기록을 볼 수 있습니다.

로그인과 Code 탭에서 막힐 때: 403

창은 떴는데 로그인이나 Code 탭에서 더 나아가지 않는 경우입니다. Error 403: Forbidden이나 인증 실패가 보이면 문서가 넷을 제시합니다.

가장 일반적인 해결은 로그아웃하고 다시 로그인하는 것이라고 문서가 못 박습니다. 그다음 유료 구독이 살아 있는지 확인합니다. Pro, Max, Team, Enterprise 중 하나여야 합니다.

세 번째가 헷갈리기 쉽습니다. 터미널에서 쓰는 Claude Code는 되는데 데스크탑만 안 된다면, 창을 닫는 것이 아니라 앱을 완전히 종료하고 다시 열어 로그인하라고 적혀 있습니다. 맥에서 창만 닫으면 앱은 계속 떠 있습니다.

네 번째는 인터넷 연결과 프록시 설정입니다.

윈도우에서만 걸리는 둘

윈도우에는 문서가 따로 적어 둔 항목이 둘 있습니다.

설치한 뒤 PATH가 반영되지 않는 경우입니다. 이때는 새 터미널 창을 열면 됩니다. PATH 변경은 새로 연 터미널에만 적용됩니다.

다른 설치가 진행 중이라는 오류가 뜨는데 실제로는 없는 경우입니다. 이때는 설치 프로그램을 관리자 권한으로 실행해 보라고 적혀 있습니다.

그 밖에 문서가 이름 붙여 둔 증상들

내 증상이 위에 없으면 이 목록에서 찾아보는 편이 빠릅니다. 공식 문서가 각각에 확인 절차를 붙여 두었습니다.

버전을 확인해야 할 때는 맥에서 메뉴의 Claude에서 About Claude, 윈도우에서 Help에서 About으로 들어가면 됩니다. 버전 번호를 눌러 복사할 수 있어서 문의할 때 붙이기 좋습니다.

리눅스 업데이트: apt와 deb의 차이

리눅스에서는 설치 방식에 따라 이후가 달라지고, 이 차이가 나중에 문제로 돌아옵니다.

공식 문서는 apt 저장소로 설치하는 방식을 권합니다. 이렇게 깔면 업데이트가 시스템의 일반 패키지 업데이트와 함께 옵니다.

sudo apt update && sudo apt upgrade

.deb 파일을 직접 받아서 설치할 수도 있습니다. 다만 공식 문서가 명시하는 것이 하나 있습니다. 그렇게 깔면 정기 업데이트 대상에 들어가지 않습니다. 앱이 스스로 업데이트하지도 않습니다. 그래서 시간이 지나면 버전이 뒤처진 채로 남고, 그 상태에서 생긴 문제는 최신 버전에서 이미 고쳐진 것일 수 있습니다.

리눅스에서 앱이 이상하게 동작한다면 먼저 버전을 확인하고, .deb로 깔았다면 apt 저장소로 옮기는 편이 낫습니다.

윈도우에서 claude 명령이 데스크탑을 열 때

검색으로 오시는 분 중에는 방향이 반대인 경우가 있습니다. 터미널에서 claude를 입력했는데 Claude Code가 아니라 데스크탑 앱이 열리는 증상입니다.

이건 윈도우에서만 생기고 원인도 분명합니다. 예전 버전의 데스크탑 앱을 설치했으면 Claude.exe가 WindowsApps 폴더에 등록되는데, 그 경로가 Claude Code보다 우선순위가 높아서 claude를 쳤을 때 데스크탑이 잡힙니다. 공식 문서는 데스크탑 앱을 최신 버전으로 올리면 해소된다고 안내합니다.

앱이 안 열리는 문제와는 확인할 것이 다르니 섞지 마세요.

그래도 안 될 때

위 항목에 다 해당하지 않으면 남는 것은 문의입니다. 다만 문의할 때 지금까지 확인한 것을 같이 적으면 답이 빨라집니다. 운영체제와 버전, 앱 버전, 설치 방식, 어느 단계에서 멈추는지, 오류 문구가 있으면 그 문구입니다.

데스크탑 앱이 안 되는 동안 급하게 써야 한다면 브라우저에서 claude.ai로 들어가는 방법이 있습니다. 데스크탑 앱과 웹은 같은 계정을 쓰고 대화도 이어집니다. 앱에만 있는 기능이 따로 있지만 급한 일을 처리하는 데는 웹으로도 됩니다. 두 화면이 어떻게 다른지는 클로드, 코워크, 클로드 코드 차이에 정리했습니다.