Claude Media
Claude Desktop Linux版(beta)のインストール手順

Claude Desktop Linux版(beta)のインストール手順

Ubuntu・DebianへのaptリポジトリインストールからCowork用のKVM設定、トラブル対処、Linux betaでまだ使えない機能まで一本にまとめます。

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

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

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

FedoraやArchのようなDebian系でないディストリビューションでは、デスクトップアプリの代わりにClaude Code CLIを使います。CLIはより幅広いLinuxディストリビューションに対応しています。Windows上のWSL 2で作業している場合は、Linux版のデスクトップアプリではなくWindows版のデスクトップアプリをインストールし、WSL 2のディストリビューション内でセッションを実行する構成になります。WindowsでのDesktop導入はClaude Desktop Windows版のインストールと初期設定にまとめています。

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

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

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

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

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 updateNO_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ファイル)

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

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

ダウンロードした.debファイルのあるディレクトリで、次のようにインストールします。

sudo apt install ./claude-desktop_*.deb

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

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

CoworkはDispatchや長時間のエージェント作業を担うタブです。Linux版では、デスクトップアプリがQEMUとKVMでホストする仮想マシンの中でその処理を実行します。この構成はLinux版だけの特徴で、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環境で見られます。

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-architectureamd64arm64を返すかも確認します。それでも見つからない場合は.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で起動しています。通常ユーザーでログインし直してから起動します
  • 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への対応は今後追加される予定であることが公式ドキュメントに明記されています。

まとめ

Claude Desktop Linux版の導入は、署名鍵をダウンロードしてaptリポジトリを登録し、apt install claude-desktopでインストールしてサインインする、という流れが基本です。対応OSはUbuntu 22.04以降とDebian 12以降のx86_64・arm64に限られ、Coworkを使うにはハードウェア仮想化とQEMU、kvmグループへの参加が別途必要になります。更新はシステムの通常のパッケージ更新に乗り、Computer UseやDictationなど一部の機能はbeta期間中まだ使えません。

よくある質問

FedoraやArch Linuxでも使えますか

公式にはテストされていません。Debian系以外のディストリビューションでは、デスクトップアプリの代わりにCLIを使うことが案内されています。

WSL 2でも使えますか

Linux版デスクトップアプリではなく、Windows版デスクトップアプリをインストールし、WSL 2のディストリビューション内でセッションを実行する構成になります。

rootユーザーで動かせますか

サポートされていません。claude-desktopをrootで起動するとRunning as root without --no-sandbox is not supportedというメッセージで終了します。通常ユーザーでログインして起動します。

Coworkを使わなければ仮想化の設定は不要ですか

不要です。ChatタブとCodeタブはハードウェア仮想化やQEMUのインストールなしで動きます。仮想化まわりの要件はCoworkタブを使うときだけ必要です。

アップデートは自動で届きますか

自動更新はありません。aptリポジトリ経由でインストールしていれば、sudo apt update && sudo apt upgradeか、ディストリビューションのグラフィカルな更新ツールで新しいバージョンが届きます。

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