Anthropic의 공식 Linux x86_64 빌드를 기반으로 Fedora 44에 네이티브 RPM 형태로 Claude Desktop을 설치합니다. 수정되지 않은 업스트림 페이로드(payload)를 사용하며, Chromium sandbox가 활성화되어 있고, Claude Code와 Cowork도 작동합니다. KDE Plasma (Wayland) 및 GNOME (Wayland) 환경의 Fedora 44에서 테스트되었으며, Fedora 43 이상에서도 작동해야 합니다.
요약: ./build-official.sh && sudo dnf install build/official/claude-desktop-*.rpm
비공식 패키징입니다. Anthropic이 앱을 배포하며, 이 레포지토리는 단순히 dnf를 위해 재포장(rewraps)하는 역할만 합니다. 패키징 버그가 발생하면 Anthropic에 문의하지 말고 이곳에서 이슈를 여세요.
sudo dnf install rpm-build binutils file xz curl gnupg2
git clone https://github.com/dewzor/claude-desktop-fedora.git
cd claude-desktop-fedora
...
애플리케이션 메뉴에서 Claude를 실행하거나 claude-desktop을 실행하세요. 런처는 또한 두 가지 데스크톱 액션(New Chat 및 New Claude Code Session)도 함께 제공합니다.
빌드는 전적으로 사용자 본인의 계정으로 실행되며, root 권한은 최종 dnf install 시에만 필요합니다.
sudo dnf copr enable dewzor/claude-desktop
sudo dnf install claude-desktop-builder
claude-desktop-builder는 MIT 라이선스 기반의 작은 패키지입니다. 이 패키지 자체에는 Claude Desktop이 포함되어 있지 않으며, 앞으로도 포함되지 않을 것입니다. Claude Desktop은 독점(proprietary) 제품이므로 어떤 레포지토리도 이를 배포할 수 없습니다. 이 패키지가 제공하는 것은 빌드 과정 그 자체(build-official.sh), claude-desktop-update 명령어, 그리고 systemd 타이머입니다.
타이머는 하루에 한 번 실행됩니다. Anthropic의 서명된 apt 인덱스에서 현재 어떤 Linux 빌드가 최신인지 확인하고, 해당 서명을 Anthropic의 릴리스 키와 비교합니다. 만약 그 빌드가 이미 설치되었고 여기서 정확히 같은 서명된 .deb 파일로 빌드되었다면, 더 이상 진행하지 않고 앱을 다운로드하지 않습니다. 더 새로운 빌드가 배포되었다면, 사용자의 기기로 Anthropic의 자체 .deb 파일을 가져와 RPM 형태로 재패키징하고 dnf를 사용하여 설치합니다. 이 과정은 사용자가 기억해서 실행할 필요 없이, build-official.sh가 수동으로 만들어내는 패키지와 정확히 동일한 결과를 얻게 해줍니다.
원하는 때 언제든지 직접 실행해 보세요:
sudo claude-desktop-update --check # 새로운 빌드가 존재하는지 확인
sudo claude-desktop-update # 존재한다면 재빌드 및 설치
패키지를 제거해도 Claude Desktop은 그대로 유지됩니다:
sudo dnf remove claude-desktop-builder
어떤 배포판에서든 사용할 수 있는 Flatpak도 있습니다. 매니페스트는 자체 리포지토리(https://github.com/dewzor/ClaudeDesktop)에 있으며 Flathub에 제출되었습니다 (flathub/flathub#9971). Flathub이 승인할 때까지 해당 리포지토리의 README에 있는 명령어로 직접 빌드하세요. Flatpak 내부에서 Claude Code는 Flatpak 포털을 통해 호스트에서 실행되므로 실제 git, node 및 python에 접근할 수 있습니다. 이 매니페스트는 gordonmessmer의 com.anthropic.Claude에서 시작하여 Flathub에 호스팅될 수 있도록 extra-data로 전환되었습니다.
| 기능 | 상태 |
|---|
| Fedora 44, KDE Plasma (Wayland) | 테스트됨 |
| ... | Claude에서 .mcpb, .dxt 및 .skill 파일 열기 |
| 최신 Claude 자동 다운로드 | 예, Anthropic의 서명된 apt 리포지토리에서 |
| 아키텍처 | x86_64 전용 (FAQ 참조) |
| 자동 업데이트 | 선택 사항, claude-desktop-builder COPR 패키지를 통해 |
Anthropic은 Claude Desktop의 공식 Linux 빌드를 제공하지만, .deb 형식으로만 합니다.
내부 페이로드는 /usr/lib/claude-desktop 아래에 일반적이고 독립적인 Linux 콘텐츠입니다. 래퍼와 의존성 이름 외에는 Debian 전용인 것이 없습니다.
build-official.sh
:
Anthropic의 apt 리포지토리의 InRelease 인덱스를 가져와 Anthropic의 릴리스 키로 서명을 확인합니다. 이 스크립트는 Claude Code 설정 문서에 있는 지문(31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE)으로 키를 고정합니다. Valid-Until 날짜가 지난 인덱스는 거부하므로, 오래된 인덱스는 만료되면 재사용할 수 없습니다 (시스템 시계가 정확한 한).
- 서명된 인덱스의 SHA256과
Packages 인덱스를 확인하고 가장 최신 claude-desktop 항목을 선택합니다. - 해당 .deb를 다운로드합니다.
약 175MB 크기이며, 서명된 인덱스의 SHA256과 비교합니다. 압축을 풀고 제어 파일의 버전이 서명된 인덱스와 일치하는지 확인합니다.
- 다음 항목들이 실제 ELF x86-64 객체인지 검증하고, 그렇지 않으면 명확하게 실패합니다:
@ant/claude-native 및 node-pty - Debian 의존성을 Fedora 패키지 이름으로 매핑합니다.
rpmbuild를 사용하여 RPM을 빌드하며, %attr(4755,root,root)를 통해 chrome-sandbox의 setuid 속성을 보존합니다. - setuid 비트가 패키지 메타데이터에 살아남았는지 확인합니다.
페이로드는 수정되지 않은 원본 콘텐츠입니다. app.asar 패치도 없고, 스텁(stubs)도, 주입된 CSS도, 런처 래퍼도 없습니다.
설치 시점에 원본의 postinst는 또한 resources/에서 세 가지 항목을 복사합니다. Electron-installer-debian이 .deb를 빌드할 때 추가 파일을 포함할 수 없기 때문에 반드시 그래야 합니다. RPM은 이들을 일반 파일로 패키징하므로, dnf remove가 이를 정리합니다:
- GNOME Shell 검색 제공자인
com.anthropic.Claude.search-provider.ini와 그 D-Bus 서비스(활동 검색에
MCP 서버는 다음 위치에 구성됩니다:
~/.config/Claude/claude_desktop_config.json
macOS 및 Windows Claude Desktop과 동일한 형식을 따릅니다. mcpServers 블록을 붙여넣고 앱을 다시 시작하세요.
로그는 ~/.config/Claude/logs/에 있습니다.
(main.log, mcp.log, ssh.log, …).
이전 버전의 이 리포지토리(build-fedora.sh, 트리에 여전히 있음)는 Windows 설치 프로그램에서 Claude Desktop을 다시 빌드했습니다: app.asar를 추출하고, 네이티브 모듈을 JS 스텁으로 교체하며, 타이틀바 상수를 패치하고, Electron 37을 번들링합니다. 이것은 0.14.x 시대까지 작동했습니다. 현재 릴리스는 더 이상 그런 방식으로 제공될 수 없습니다:
is 이제 파일 시스템 격리(filesystem containment)를 위해 필수적으로 요구되며, 앱은 그것 없이는 저하되는 것을 명시적으로 거부합니다: @ant/claude-native
@ant/claude-native는 안전한 파일 시스템 격리를 위해 필요하지만 로드에 실패하여 경로 기반 열기(path-based open)로 폴백하는 것을 거부합니다 (CC-2885).
JS 스텁으로는 이를 충족할 수 없으며, 모듈은 claude-native에서 @ant/claude-native로 이동했으므로 오래된 스텁 경로는 아예 로드되지 않습니다. Windows 리패킹의 경우 실제 모듈은 PE32+ DLL입니다: ERR_DLOPEN_FAILED: invalid ELF header.
Claude Code의 터미널은 node-pty가 필요합니다:
prebuilds/linux-x64/pty.node
Windows 패키지는 prebuilds/win32-x64/conpty.node만 배포합니다.
결과적으로: 앱은 시작하지만, Claude Code 탭이 작동하지 않습니다. 공식 Linux 빌드는 두 모듈을 실제 ELF x86-64 객체로 배포하며, 네이티브 프레임도 이미 정확하므로 오래된 패치 작업은 필요하지 않습니다.
정확한 오류 문자열과 그 의미. 이 모든 것은 build-official.sh로 빌드하여 수정됩니다.
당신은 Windows 리패킹 빌드를 실행하고 있습니다 (build-fedora.sh 또는 이전 Fedora 스크립트 중 하나). 현재 Claude Desktop은 실제 네이티브 모듈을 필수적으로 요구하며, 그것 없이는 Claude Code를 시작하는 것을 거부합니다. 공식 Linux 빌드에서 다시 빌드하세요.
설치된 claude-native-binding.node는 Windows PE32+ DLL이며, Linux ELF 객체가 아닙니다. 위와 같은 원인으로, Windows 리패킹입니다. build-official.sh로 다시 빌드하세요.
; 네이티브 모듈 두 개가 ELF x86-64인지 확인한 후 패키징합니다.
Claude Code의 터미널은 node-pty가 필요합니다.
's prebuilds/linux-x64/pty.node
. Windows 패키지는 win32-x64/conpty.node만 배포합니다.
. 공식 Linux 빌드에서 다시 빌드하고, ~/.config/Claude/logs/main.log에서 [CCD] Initialized를 확인하세요.
.
레거시 스크립트의 제목 표시줄 sed는 더 이상 최신 릴리스와 일치하지 않습니다. 무해하지만, 잘못된 경로에 있다는 신호이기도 합니다. 공식 빌드는 이미 올바른 네이티브 프레임을 그립니다. build-official.sh를 사용하세요.
.
apt 인덱스가 고정 키(pinned key)와 검증되지 않았거나, 만료되거나 취소된 키로 서명되었습니다. --deb 옵션으로 이를 우회하지 마세요.
. 키 변경에 대한 정보는 https://code.claude.com/docs/en/desktop-linux를 확인하고, 키는 https://downloads.claude.ai/claude-desktop/key.asc에서 확인한 후 이슈를 여세요.
마지막 오류를 보려면 journalctl -u claude-desktop-update.service를 실행하세요. 모든 검사는 실패 시 닫힙니다: 아무것도 설치되지 않으며, 이전 버전은 다음 실행이 성공할 때까지 계속 작동합니다.
인덱스가 Anthropic이 서명한 후 일주일이 지난 Valid-Until 날짜를 지났습니다. 이는 리포지토리가 그 시간 동안 재서명되지 않았거나, 시스템 시계가 잘못되었기 때문일 수 있습니다. 먼저 시계를 확인하세요.
Wayland 세션에서 발생하는 Chromium 노이즈. 미관상의 문제이니 무시해도 됩니다.
선택적 VM 스택을 설치하세요: sudo dnf install qemu-system-x86 edk2-ovmf virtiofsd
. RPM에서는 이를 Suggests:로 나열합니다.
.
이것은 aaddrick/claude-desktop-debian의 RPM으로, 런처 래퍼와 --doctor를 추가합니다.
. 두 패키지는 모두 ~/.config/Claude를 공유하므로, 둘 중 하나만 실행하고 둘 다 실행하지 마세요.
현재는 0.14.x 시대의 빌드가 필요한 사람들을 위해 유지됩니다. 더 이상 권장되는 경로는 아니며 최신 릴리스에 맞춰 유지 관리되지 않습니다.
sudo dnf install rpm-build p7zip nodejs npm
sudo ./build-fedora.sh
sudo dnf install build/electron-app/$(uname -m)/claude-desktop-*.rpm
현재 릴리스의 알려진 제한 사항: Claude Code 탭이 작동하지 않습니다(위 참조), 그리고 titleBarStyle는
sed는 더 이상 일치시키지 않습니다 (⚠ titleBarStyle pattern not found). 이전에 어떻게 작동했는지, 그리고 그 이유는 CHANGELOG.md에 나와 있습니다.
네, Fedora 44에서 KDE Plasma (Wayland)와 GNOME (Wayland) 모두 테스트했습니다.
그래야 합니다. 페이로드(payload)는 자체 포함적(self-contained, 번들링된 Electron)이므로, 유일한 실제 제약은 런타임 종속성 목록이며, 이는 43에서 해결됩니다. 적극적으로 테스트되지는 않았습니다. 만약 시도해 보신다면, 발견한 내용을 가지고 이슈를 열어주세요.
네. 이것이 official-build 경로의 목적 전체입니다. ~/.config/Claude/logs/main.log에서 [CCD] Initialized를 찾아보세요.
네. Cowork의 선택적 전체 VM 샌드박스는 qemu-system-x86, edk2-ovmf, 그리고 virtiofsd가 필요합니다. 이들은 RPM에 Suggests:로 나열되어 있으며, 생략해도 무방합니다.
네. 설정은 ~/.config/Claude/claude_desktop_config.json에 있습니다.
현재 스크립트는 x86_64용으로만 빌드합니다. Anthropic의 apt 리포지토리에는 arm64 빌드가 존재합니다. 필요하다면, 해당 .deb 파일을 직접 가져와 --deb PATH로 전달하세요 (스크립트는 현재 non-x86_64 호스트를 거부합니다. 패치는 환영합니다).
'--ozone-platform=wayland' is not compatible with Vulkan는 Chromium의 노이즈입니다. 미관상의 문제입니다.
sudo dnf remove claude-desktop
- @bsneed (Brandon Sneed): 이 프로젝트가 시작된 원래 프로젝트입니다.
- @boujuan (Juan Boullosa): Fedora 43 제목 표시줄 수정 및 레거시 스크립트(v6에서 v8로)의 최신 버전 자동 다운로드 기능에 대한 기여주입니다.
- @arcanistzed: Anthropic이 서명한 apt 리포지토리를 통한 다운로드 검증, GNOME 검색 및 파일 연결 (#6).
- @itsnitinr: 멀티스레드 zstd 페이로드 압축 (#5).
- @sharpandpearl:
build-official.sh
그리고 Windows 재패키징이 작동을 멈춘 이유에 대한 분석 (#4). - @randy-johnson:
레거시 스크립트의 titleBarOverlay 정규식 수정 (#3). - @gordonmessmer: flatpak/에 있는 것의 기반이 되는 com.anthropic.Claude Flatpak 매니페스트입니다.
MIT 및 Apache 2.0으로 이중 라이선스되었습니다. LICENSE-MIT와 LICENSE-APACHE를 참조하세요.
Claude Desktop 애플리케이션은 이 리포지토리에 포함되어 있지 않으며 Anthropic의 소비자 약관(Consumer Terms)의 적용을 받습니다.