SpyBara
Go Premium

desktop-linux.md 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

26 added, 2 removed.

2026
Sat 11 03:59 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

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 저장소에서 설치합니다.

1

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
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 게이트웨이로 라우팅하는 엔터프라이즈 배포의 경우 엔터프라이즈 구성 가이드네트워크 구성을 참조하세요.

서명 키 확인

다운로드한 서명 키가 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-desktopE: Unable to locate package claude-desktop 오류로 실패하면 apt가 추가한 저장소를 찾지 못한 것입니다. 다음을 확인하십시오:

  • 저장소 항목이 작성되었는지 확인하십시오. cat /etc/apt/sources.list.d/claude-desktop.listAnthropic의 apt 저장소 추가 단계의 deb 줄을 표시해야 합니다. 파일이 비어 있거나 없으면 해당 단계를 다시 실행하십시오.
  • 아키텍처가 지원되는지 확인하십시오. dpkg --print-architectureamd64 또는 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 배포판을 지원합니다. 시스템 요구 사항을 참조하세요.