Claude Media
Claude Desktop Linux版(beta)のダウンロードとインストール手順
ClaudeClaude Codeチュートリアル

Claude Desktop Linux版(beta)のダウンロードとインストール手順

Claude Desktop LinuxはUbuntu 22.04以降・Debian 12以降が対象。aptと.debの入れ方、Coworkのkvm設定、ログインが保存されない原因、Arch・Fedoraの扱いまで。

読了目安 約18分

Claude DesktopのLinux版はbeta提供のネイティブアプリで、macOS・Windows版と同じChat・Cowork・Codeの3タブ構成を持ちます。3タブの役割やmacOS版・Windows版共通の仕様はClaude Desktopとはで扱っており、本稿はLinux固有の論点に絞ります。対応ディストリビューションの範囲、aptリポジトリでのインストール、Coworkを動かすための仮想化設定は、Linuxならではの確認事項です。

ダウンロードして入れる方法は2つです。Anthropicのaptリポジトリからsudo apt install claude-desktopで入れる方法と、リポジトリのパッケージプールから.debを取得してsudo apt install ./claude-desktop_*.debで入れる方法です。Arch LinuxやFedoraにはデスクトップアプリがなく、Claude Code CLIを使います。

Claude Desktop Linux版で確認する前提条件

対応しているのはUbuntu 22.04以降、またはDebian 12以降で、アーキテクチャはx86_64かarm64です。この条件を満たす他のDebian系ディストリビューションでも動く可能性はありますが、公式にはテストされていません。

自分の環境がどれに当たるかで、進む先が分かれます。

分岐

環境別の進み先

  • Ubuntu・Debian(対象範囲)

    このページの手順に進みます。x86_64かarm64であることをdpkg --print-architectureで確かめておきます。

  • FedoraやArchなど

    デスクトップアプリの代わりにClaude Code CLIを使います。CLIはより幅広いLinuxディストリビューションに対応しています。

  • Windows上のWSL 2

    Linux版ではなくWindows版のデスクトップアプリを入れ、WSL 2のディストリビューション内でセッションを動かします。WSL 1は非対応です。導入はClaude Desktop Windows版のインストールと初期設定にまとめています。

WSL経由の場合、リポジトリがディストリビューション側のファイルシステムにあるときに向いています。Windows側からその中のファイルを扱うとネットワークファイルシステム経由になり、遅くなってファイル監視も壊れるためです。

aptリポジトリからインストールする

Anthropicのaptリポジトリから導入すると、以降の更新がシステムの通常のパッケージ更新に乗ります。ターミナルを開き、次の手順を順番に実行します。

1. 署名鍵をダウンロードして検証する

curlとgpgが入っていない場合は先に導入します。

sudo apt install curl gnupg

Anthropicの署名鍵をダウンロードします。

sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
  https://downloads.claude.ai/claude-desktop/key.asc

成功すると何も出力されません。鍵が間違っていたり欠けていたりすると、後段のapt updateがNO_PUBKEY BAA929FF1A7ECACEで失敗するため、続ける前にフィンガープリントを確認します。

gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

表示されるフィンガープリントは31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACEと一致するはずです。ファイルが開けない、または有効なOpenPGPデータが無いと表示された場合は、ダウンロードが失敗しています。downloads.claude.aiへの到達性を確認してからやり直します。

2. リポジトリを登録する

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

3. パッケージをインストールする

sudo apt update && sudo apt install claude-desktop

4. 起動してサインインする

アプリケーションランチャーからClaudeを起動するか、ターミナルでclaude-desktopを実行し、Anthropicアカウントでサインインします。サインイン方法はmacOS・Windows版と同じで、claude.aiのサブスクリプションか組織のSSOを使います。DesktopはClaude ConsoleのAPIキーを直接は受け付けないため、APIキー認証が必要な場合はCLIを使います。

リポジトリを使わずインストールする(.debファイル)

インストール経路は2つあり、違いは更新の届き方だけです。

くらべる

aptリポジトリと.debファイルの違い

更新が自動で届く

aptリポジトリ

鍵の検証とリポジトリ登録を済ませると、apt upgradeでアプリも更新されます。

リポジトリを登録しない選択もできる

.debファイル

ネットワーク制限などでリポジトリを使えないときの経路です。CLAUDE_DESKTOP_ADD_REPO="false"を設定した場合、更新は自分で入れ直します。

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を返すことを確認します。

Anthropicのaptリポジトリを登録せずにインストールしたい場合は、先に/etc/default/claude-desktopへCLAUDE_DESKTOP_ADD_REPO="false"の行を作成しておきます。この場合、apt経由の更新は届かなくなるため、更新のたびにダウンロードコマンドを再実行して入れ直すか、後からリポジトリを登録します。

ダウンロードした.debファイルは、GNOME Softwareなどのグラフィカルなインストーラーでも開けます。コマンドで入れるときは、ファイルのあるディレクトリで次のようにします。

sudo apt install ./claude-desktop_*.deb

.debからのインストールでも、CLAUDE_DESKTOP_ADD_REPO="false"を設定していない限りAnthropicのaptリポジトリが自動登録されるため、以降は通常のパッケージ更新に乗ります。

Coworkを使うための追加要件(仮想化)

CoworkはDispatchや長時間のエージェント作業を担うタブです。Linux版では、デスクトップアプリがQEMUとKVMでホストする仮想マシンの中でその処理を実行します。Coworkを使うには次の3つが必要です。

  • ハードウェア仮想化: ファームウェア設定で有効にします。無効なままだとCoworkタブに「Cowork requires hardware virtualization (KVM)」と表示されます
  • QEMUとUEFIファームウェア: x86_64ではqemu-system-x86 ovmf virtiofsd、arm64ではqemu-system-arm qemu-efi-aarch64 virtiofsdが必要です。apt install claude-desktopはこれらを推奨パッケージとして既定でインストールします。--no-install-recommends付きでインストールした場合や、推奨パッケージを省く最小構成のイメージでは、Coworkタブが「Cowork requires QEMU」と表示し、実行すべきapt installコマンドを提示します。Ubuntu 22.04にはvirtiofsdパッケージ自体が無く、アプリに同梱されたコピーが使われます
  • /dev/kvmへのアクセス: sudo usermod -aG kvm $USERでユーザーをkvmグループに追加し、ログアウトしてから再ログインします。デスクトップ環境によってはグループなしでもログインユーザーに/dev/kvmへのアクセスを許可していますが、Coworkはkvmグループのメンバーだけが開ける/dev/vhost-vsockも必要とするため、/dev/kvmがすでに使えている場合でもグループへの参加が要ります

これらの要件はアプリ起動時に一度だけチェックされます。パッケージをインストールしたあとはアプリを再起動し、グループに参加したあとはログアウトと再ログインが必要です。/dev/vhost-vsockが見つからず、実行中のカーネルに/lib/modules以下のモジュールディレクトリも無い場合、Coworkタブは必要な仮想化サポートをカーネルが含んでおらず手動での追加もできない旨を表示します。この組み合わせはChromeOSやコンテナベースのLinux環境で見られます。ChromebookのLinuxコンテナ(Crostini)でこの制約に当たる場合の技術的な背景と回避策はChromebookのLinux環境でCoworkが使えない理由と対処法で掘り下げています。

CoworkのVMサンドボックスとComputer Useの違いなど、Cowork全体の仕組みはClaude CoworkのComputer Use・VMサンドボックスで扱っています。

更新とアンインストール

Linux版はアプリ自身が自動更新することはなく、システムの通常のパッケージ更新に乗せます。

sudo apt update && sudo apt upgrade

ディストリビューションのグラフィカルな更新ツールでも新バージョンを拾えます。

アンインストールは次のコマンドです。

sudo apt remove claude-desktop

パッケージのアンインストールと同時に、登録したリポジトリと署名鍵のエントリも削除されます。リポジトリ登録の手順を自分で個別に実行していた場合は、次のコマンドで登録ファイルも削除します。

sudo rm /etc/apt/sources.list.d/claude-desktop.list

組織でmanaged settingsを配布して機能を制御している場合、設定ファイルの書式はClaude Desktop設定ファイルと更新方法にまとめています。

Linux版でよくあるつまずき

  • E: Unable to locate package claude-desktop: リポジトリを追加したあとにsudo apt updateを実行していないと起きます。cat /etc/apt/sources.list.d/claude-desktop.listでリポジトリの登録内容を確認し、dpkg --print-architectureがamd64かarm64を返すかも確認します。それでも見つからない場合は.debファイルからのインストールに切り替えます
  • libc6 (>= 2.34)のunmet dependencies: ディストリビューションが古すぎます。Ubuntu 20.04のlibc6は2.31です。Ubuntu 22.04以降かDebian 12以降にアップグレードします
  • :amd64や:arm64サフィックス付きのnot installableエラー: ダウンロードした.debが自分のアーキテクチャと違います。dpkg --print-architectureで確認し、正しいアーキテクチャの.debを取り直すか、アーキテクチャを自動選択するaptリポジトリ経由のインストールに切り替えます
  • Running as root without --no-sandbox is not supported: rootで起動しています。通常ユーザーでログインし直してから起動します
  • ログインが毎回求められる(「Your sign-in won't be saved on this device」): キーリングへの保存に失敗しています。保存先はGNOME KeyringやKDE Walletです。--no-install-recommendsや最小構成のイメージでキーリングが無いときはsudo apt install gnome-keyringを入れます。KDE PlasmaにGNOME Keyringも入っていると両者が衝突するため、sudo apt remove gnome-keyringで外して再起動します。キーリングがロックされているだけなら解除します。直したらアプリを再起動して再度サインインし、一度終了して起動し直しても残ることを確かめます
  • Coworkタブのエラーメッセージ: 「Cowork requires QEMU」はQEMU/UEFIパッケージの導入、「Cowork requires hardware virtualization (KVM)」はファームウェアでの仮想化有効化、「Claude doesn't have permission to use virtualization (/dev/kvm)」はkvmグループへの参加とログアウト・再ログインで解消します。「Cowork requires the vhost_vsock kernel module」が出た場合はsudo modprobe vhost_vsockを実行し、アプリを再起動します。これは今回の起動だけの一時対応で、毎回のブートで読み込むにはecho vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.confを実行します

Linux betaでまだ使えない機能

Linux版はbeta提供のため、macOS・Windows版にある一部の機能がまだありません。

機能Linux版macOS・Windows版
Computer Use(画面操作)Linux版利用不可macOS・Windows版利用可(研究プレビュー、Pro・Maxプラン対象)
Dictation(音声入力)Linux版利用不可macOS・Windows版利用可
Quick EntryのグローバルホットキーLinux版X11では動作、native Waylandはデスクトップ環境のGlobalShortcuts portal依存macOS・Windows版利用可
対応ディストリビューションLinux版Ubuntu 22.04以降・Debian 12以降のみmacOS・Windows版—

Computer Useが必要な場合や、Fedora・RHELのようなDebian系以外のディストリビューションで使いたい場合は、デスクトップアプリではなくCLIが同じClaude Codeエンジンを、より広いLinuxディストリビューションで動かせます。Dictationが必要な場合も、CLIの音声入力機能で代替できます。FedoraとRHELへの対応は今後追加される予定であることが公式ドキュメントに明記されています。FedoraやArchでの扱いはClaude DesktopはFedora・Archで使えるかにまとめています。

betaで報告されている不具合と切り分け

Linux版はbetaのため、公式のトラブルシュートに載らない不具合がGitHubのanthropics/claude-codeリポジトリに個別に報告されています。以下は報告本文に書かれた環境と症状で、修正済みかどうかは各Issueで確認する必要があります。すべての環境で起きるわけではありません。

  • 起動のたびにクラッシュする: Pop!_OS 24(KDE Plasma 5)のaptインストールで、Desktop 1.17377.2が毎回SIGSEGVで落ちたという報告です(#73421)。gdbで見ると、落ちる位置は/usr/lib/claude-desktop/claude-desktop自身のコード領域内でした
  • ログでディスクが埋まる: NVIDIA搭載のUbuntu 22.04で、GPUプロセスの起動がerror_code=1002で失敗した報告です。再試行のたびにログが1行書かれました(Desktop 1.24012.9、#83453)。報告者の計測は毎秒約9,000回で、/var/log/syslog.1が346GBに達してルートファイルシステムが埋まりました
  • AMDのGPUでセッションが落ちる: Ubuntu 26.04(GNOME・Wayland)で、amdgpuのページフォールトが起きた報告です。GPUリセットでデスクトップセッションも終了しました(#82661)
  • ウィンドウが最小化できない: Ubuntu 24.04のKDE(X11)で、タイトルバーの最小化ボタンで最小化してもアプリのメインプロセスがすぐ元に戻す報告です(Desktop 1.40609.0、#90742)

ディスクが急に減ったときは、まず/var/logの使用量を見ます。

sudo du -h --max-depth=1 /var/log | sort -rh | head -3

このコマンドはディレクトリ単位の集計なので、/var/log直下のファイルは行として出ません。先頭の/var/logの合計だけが大きく、journalなど下位のディレクトリが小さければ、直下のファイルが膨らんでいます。

sudo find /var/log -type f -size +1G -exec ls -lh {} \;

syslog系が突出していれば、#83453と同じ型かもしれません。報告者の環境では、rsyslogがファイルを掴んでいてrmでは容量が戻らず、truncate -s 0 /var/log/syslogで空にしたそうです。

FedoraやRHELで使いたい場合の要望も#88843に出ています。報告者はUbuntu向けの.debをalienでrpmに変換し、Bazzite(rpm-ostree系)に入れて依存関係の解決までは通ったと書いていますが、本人も公式の代わりにはならない個人的な回避策と断っています。

まとめ

Ubuntu・Debianなら、aptリポジトリを登録して数コマンドで入ります。Coworkを使う場合はkvmグループとQEMUを先に揃えます。起動しない、ログが膨らむといった症状が出たら、上のIssueに自分の環境が近いか確かめる手があります。

この記事を共有:XはてブLinkedIn

関連する記事

Claude をもっと見る →