Linux의 Claude Desktop (베타)
Ubuntu 및 Debian에서 Claude 데스크톱 앱 설치 및 업데이트
Linux의 데스크톱 앱은 macOS 및 Windows와 동일한 Chat, Cowork 및 Claude Code 환경을 제공합니다: 병렬 세션, 시각적 diff 검토, 통합 터미널 및 편집기, 라이브 앱 미리보기. 전체 기능 참조는 Claude Code Desktop 사용을 참조하세요.
요구 사항
- Ubuntu 22.04 이상 또는 Debian 12 이상
- x86_64 또는 arm64
이러한 요구 사항을 충족하는 다른 Debian 기반 배포판도 작동할 수 있지만 공식적으로 테스트되지 않았습니다.
설치
터미널을 열고 각 단계의 명령을 실행하여 시스템의 정기적인 패키지 업데이트를 통해 업데이트가 도착하도록 Anthropic의 apt 저장소에서 설치합니다.
Anthropic의 apt 저장소 추가
이 단계에서는 curl을 사용하여 서명 키를 다운로드합니다. 새로운 Debian 및 Ubuntu 설치에는 curl이 포함되지 않을 수 있습니다. 다운로드 명령이 sudo: curl: command not found 오류로 실패하면 먼저 curl을 설치하세요:
sudo apt install curl
Anthropic의 서명 키를 다운로드합니다:
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
저장소를 등록합니다:
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
패키지 설치
sudo apt update && sudo apt install claude-desktop
실행 및 로그인
애플리케이션 런처에서 Claude를 실행하거나 터미널에서 claude-desktop을 실행한 후 Anthropic 계정으로 로그인합니다.
Linux 앱은 macOS 및 Windows와 동일한 방식으로 로그인합니다: claude.ai 구독 또는 조직의 SSO를 통해 로그인합니다. Desktop은 Claude Console API 키를 직접 허용하지 않습니다. API 키 인증의 경우 CLI를 사용하세요. Desktop을 Google Cloud의 Agent Platform 또는 LLM 게이트웨이로 라우팅하는 엔터프라이즈 배포의 경우 엔터프라이즈 구성 가이드 및 네트워크 구성을 참조하세요.
서명 키 확인
다운로드한 서명 키가 Anthropic에 속하는지 확인할 수 있습니다:
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc
지문은 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE여야 합니다.
다운로드한 파일에서 설치
apt 저장소를 통해 설치할 수 없는 경우 저장소의 패키지 풀에서 .deb 패키지를 직접 다운로드합니다. 이 명령은 저장소 인덱스에서 아키텍처에 맞는 최신 패키지를 찾은 후 현재 디렉터리에 다운로드합니다:
curl -fLO "https://downloads.claude.ai/claude-desktop/apt/stable/$(curl -s "https://downloads.claude.ai/claude-desktop/apt/stable/dists/stable/main/binary-$(dpkg --print-architecture)/Packages" | grep '^Filename: pool/main/c/claude-desktop/claude-desktop_' | sort -V | tail -n 1 | cut -d' ' -f2)"
명령이 Remote file name has no length 오류로 실패하면 조회에서 패키지 경로를 반환하지 못한 것입니다. 이는 예를 들어 네트워크가 downloads.claude.ai를 차단할 때 저장소 인덱스를 가져올 수 없거나 아키텍처에 대한 패키지가 없음을 의미할 수 있습니다. 네트워크가 downloads.claude.ai에 도달할 수 있는지 확인하고 dpkg --print-architecture가 amd64 또는 arm64를 출력하는지 확인합니다. 저장소는 다른 아키텍처에 대한 패키지를 게시하지 않습니다.
그런 다음 GNOME Software와 같은 소프트웨어 설치 프로그램으로 다운로드한 파일을 열거나 다운로드 파일이 포함된 디렉터리에서 apt를 사용하여 설치합니다:
sudo apt install ./claude-desktop_*.deb
apt가 E: Unsupported file ./claude-desktop_*.deb given on commandline 오류를 보고하면 패턴이 현재 디렉터리의 .deb 파일과 일치하지 않은 것입니다. 다운로드가 완료되었는지 확인한 후 파일이 포함된 디렉터리에서 명령을 다시 실행하세요.
이런 방식으로 설치된 .deb는 업데이트를 받지 않습니다. apt를 통해 업데이트를 받으려면 Anthropic의 apt 저장소 추가 단계에서 저장소를 등록합니다. 패키지는 또한 /etc/apt/sources.list.d/claude-desktop.list에 주석 처리된 저장소 항목을 작성합니다. 해당 deb 줄의 주석을 제거하는 것과 동일합니다.
업데이트
데스크톱 앱은 Linux에서 자동으로 업데이트되지 않습니다. 업데이트는 시스템의 정기적인 패키지 업데이트와 함께 도착합니다:
sudo apt update && sudo apt upgrade
배포판의 그래픽 소프트웨어 업데이터도 새 버전을 선택합니다.
제거
sudo apt remove claude-desktop
이렇게 하면 앱과 함께 서명 키가 제거되므로 설치 중에 저장소 항목을 추가한 경우 이것도 제거합니다:
sudo rm /etc/apt/sources.list.d/claude-desktop.list
문제 해결
claude-desktop 패키지를 찾을 수 없음
sudo apt install claude-desktop이 E: Unable to locate package claude-desktop 오류로 실패하면 apt가 추가한 저장소를 찾지 못한 것입니다. 다음을 확인하십시오:
- 저장소 항목이 작성되었는지 확인하십시오.
cat /etc/apt/sources.list.d/claude-desktop.list는 Anthropic의 apt 저장소 추가 단계의deb줄을 표시해야 합니다. 파일이 비어 있거나 없으면 해당 단계를 다시 실행하십시오. - 아키텍처가 지원되는지 확인하십시오.
dpkg --print-architecture는amd64또는arm64를 출력해야 합니다. 저장소는 다른 아키텍처에 대한 패키지를 게시하지 않습니다. sudo apt update를 다시 실행하고downloads.claude.ai와 관련된 오류가 있는지 출력을 확인하십시오. 네트워크 또는 키 오류가 있으면 저장소는 추가되었지만 도달하거나 확인할 수 없다는 의미입니다.
저장소가 제자리에 있고 도달 가능하며 패키지를 여전히 찾을 수 없으면 대신 다운로드한 파일에서 설치하십시오.
Linux 베타에서 아직 제공되지 않는 기능
- Computer Use: 앱 및 화면 제어는 Linux에서 사용할 수 없습니다.
- Dictation: 음성 입력은 Linux 데스크톱 앱에서 사용할 수 없습니다. 대신 CLI에서 음성 받아쓰기를 사용하세요.
- Quick Entry 전역 핫키: X11에서 작동합니다. 기본 Wayland에서는 데스크톱 환경의 GlobalShortcuts 포털이 필요합니다.
- Fedora 및 RHEL: 현재 Debian 기반 배포판만 지원됩니다. 추가 배포판에 대한 지원은 향후 제공될 예정입니다.
데스크톱 앱에서 아직 사용할 수 없는 기능의 경우 CLI는 동일한 Claude Code 엔진을 실행하며 더 넓은 범위의 Linux 배포판을 지원합니다. 시스템 요구 사항을 참조하세요.