Claude Desktop on Linux (beta)
기준일: 2026-07-26
공식 기준: Claude Desktop on Linux (beta)
개요
Linux용 Claude 데스크톱 앱은 beta입니다. Chat, Cowork, Code 탭을 모두 사용할 수 있습니다. macOS·Windows와 같이 병렬 세션, visual diff, 통합 터미널·에디터, live app preview를 제공합니다. 전체 기능은 Use Claude Code Desktop을 참고하세요.
핵심 개념
| 항목 | 내용 |
|---|---|
| 상태 | beta |
| 지원 OS | Ubuntu 22.04+, Debian 12+ (기타 Debian 계열은 비공식 테스트) |
| 아키텍처 | x86_64, arm64 |
| 설치 경로 | Anthropic apt 저장소 → 시스템 패키지 업데이트로 갱신 |
| 로그인 | claude.ai 구독 또는 조직 SSO (Console API 키 직접 입력 불가) |
상세
요구 사항
- Ubuntu 22.04 이상, 또는 Debian 12 이상
- x86_64 또는 arm64
요건을 만족하는 다른 Debian 계열은 동작할 수 있으나 공식 테스트 대상이 아닙니다.
설치 (apt 저장소)
시스템 일반 패키지 업데이트로 갱신이 오도록 Anthropic apt 저장소에서 설치합니다.
1. Anthropic apt 저장소 추가
curl이 없으면 먼저 설치합니다.
sudo apt install curl
서명 키 다운로드:
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
2. 패키지 설치
sudo apt update && sudo apt install claude-desktop
3. 실행 및 로그인
앱 런처에서 Claude를 실행하거나 터미널에서 claude-desktop을 실행한 뒤 Anthropic 계정으로 로그인합니다.
Linux 앱 로그인 방식은 macOS·Windows와 같습니다: claude.ai 구독 또는 조직 SSO. Desktop은 Claude Console API 키를 직접 받지 않습니다. API 키 인증은 CLI를 사용하세요. Desktop을 Google Cloud Agent Platform 또는 LLM gateway로 라우팅하는 엔터프라이즈 배치는 Claude Desktop on 3P와 network configuration을 참고하세요.
서명 키 검증
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc
지문은 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE 여야 합니다.
.deb 파일로 설치
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 차단, 또는 지원하지 않는 아키텍처일 수 있습니다. dpkg --print-architecture가 amd64 또는 arm64인지 확인하세요.
다운로드 후 GNOME Software 등으로 열거나:
sudo apt install ./claude-desktop_*.deb
E: Unsupported file ./claude-desktop_*.deb는 현재 디렉터리에 매칭 .deb가 없을 때입니다.
이 방식으로 설치한 .deb는 자동 업데이트를 받지 않습니다. apt 업데이트를 받으려면 저장소 등록 단계를 따르세요. 패키지는 /etc/apt/sources.list.d/claude-desktop.list에 주석 처리된 저장소 항목도 쓰며, deb 줄 주석을 해제하면 동등합니다.
업데이트
Linux에서는 데스크톱 앱이 스스로 업데이트하지 않습니다. 시스템 패키지 업데이트로 옵니다.
sudo apt update && sudo apt upgrade
배포판 GUI 소프트웨어 업데이터도 새 버전을 가져옵니다.
제거
sudo apt remove claude-desktop
서명 키와 앱이 함께 제거됩니다. 설치 때 저장소 항목을 넣었다면:
sudo rm /etc/apt/sources.list.d/claude-desktop.list
트러블슈팅: Unable to locate package claude-desktop
cat /etc/apt/sources.list.d/claude-desktop.list에 설치 단계의deb줄이 있는지 확인. 비어 있거나 없으면 저장소 추가를 다시 실행.dpkg --print-architecture가amd64또는arm64인지 확인.sudo apt update출력에서downloads.claude.ai관련 오류 확인.
저장소가 정상이어도 패키지를 못 찾으면 다운로드 파일 설치를 사용하세요.
Linux 베타에 아직 없는 것
- Computer Use: 앱·화면 제어는 Linux에서 불가
- Dictation: Linux 데스크톱 앱에 음성 입력 없음. CLI voice dictation 사용
- Quick Entry 전역 핫키: X11에서 동작. 네이티브 Wayland는 데스크톱 환경 GlobalShortcuts portal 필요
- Fedora / RHEL: 현재 Debian 계열만 지원. 추가 배포판 지원 예정
데스크톱 앱에 아직 없는 기능은 CLI가 같은 Claude Code 엔진으로 더 넓은 Linux 배포판을 지원합니다. 시스템 요구 사항 참고.
체크리스트
- Ubuntu 22.04+ 또는 Debian 12+, amd64/arm64이다
- apt 저장소·서명 키를 등록했다
-
claude-desktop설치 후 구독 또는 SSO로 로그인했다 - API 키 전용 워크플로는 CLI로 분리했다
- Computer Use 등 베타 미지원 항목을 인지했다
다음 단계
기준일
- 문서 작성·동기화 기준일: 2026-07-26
- 원문: https://code.claude.com/docs/en/desktop-linux