Linux의 Claude Desktop (베타)
Ubuntu 및 Debian에서 Claude 데스크톱 앱 설치 및 업데이트
Claude 데스크톱 앱의 Linux 지원은 베타 버전입니다. Chat, Cowork 및 Code 탭을 모두 사용할 수 있습니다.
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 저장소를 사용할 수 없는 경우 claude.com/download에서 아키텍처(x64 또는 arm64)에 맞는 .deb 패키지를 다운로드한 후 소프트웨어 설치 프로그램으로 열거나 다운로드 파일이 포함된 디렉터리에서 apt를 사용하여 설치합니다:
sudo apt install ./claude-desktop_*.deb
apt가 E: Unsupported file ./claude-desktop_*.deb given on commandline 오류를 보고하면 패턴이 현재 디렉터리의 .deb 파일과 일치하지 않은 것입니다. 다운로드가 완료되었는지 확인한 후 파일이 포함된 디렉터리에서 명령을 다시 실행하세요.
이런 방식으로 설치된 .deb는 업데이트를 받지 않습니다. 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 배포판을 지원합니다. 시스템 요구 사항을 참조하세요.