Claude Desktop on Linux (beta)

Ubuntu と Debian に Claude デスクトップアプリをインストールおよび更新する

Linux 上のデスクトップアプリは、macOS と Windows と同じ Chat、Cowork、Claude Code エクスペリエンスを提供します。並列セッション、ビジュアル diff レビュー、統合ターミナルとエディタ、ライブアプリプレビューが含まれます。機能リファレンスについては、Claude Code Desktop を使用するを参照してください。

要件

• Debian ベースのディストリビューション：Ubuntu 22.04 以降、または Debian 12 以降
• x86_64 または arm64

これらの要件を満たす他の Debian ベースのディストリビューションは動作する可能性がありますが、公式にはテストされていません。Fedora や Arch などの Debian ベース以外のディストリビューションでは、代わりに CLI を実行してください。Windows で WSL 2 を使用している場合は、Windows デスクトップアプリをインストールし、ディストリビューション内でセッションを実行してください。Claude Code Desktop in WSL を参照してください。

Cowork の要件

Cowork は Dispatch とより長い agentic work 用のデスクトップタブです。Linux では、Cowork はこれらのタスクを、デスクトップアプリが QEMU と KVM でホストする仮想マシン内で実行します。Cowork を使用するには、マシンが以下を必要とします。

• ハードウェア仮想化：ファームウェア設定で有効にされていること。これがない場合、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 は /dev/vhost-vsock も必要とし、これは kvm グループメンバーのみが開くことができます。/dev/kvm が既に機能している場合でも、グループに参加してください。

アプリはこれらの要件を起動時に 1 回チェックします。パッケージをインストール後にアプリを再起動し、グループに参加後にログアウトしてからログインし直してください。/dev/vhost-vsock が見つからず、実行中のカーネルが /lib/modules の下にモジュールディレクトリを持たない場合、Cowork タブは、カーネルが Cowork が必要とする仮想化サポートを含まず、手動で追加できないことを報告します。この組み合わせは ChromeOS とコンテナベースの Linux 環境で一般的です。

インストール

Anthropic の apt リポジトリからインストールして、更新がシステムの通常のパッケージ更新を通じて提供されるようにします。ターミナルを開き、各ステップのコマンドを実行してください。

sudo apt install curl gnupg

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

gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.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

sudo apt update && sudo apt install claude-desktop

ダウンロードしたファイルからインストールする

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 をブロックしている場合）、またはアーキテクチャに対応したパッケージが存在しない場合を意味します。ネットワークが downloads.claude.ai に到達できることを確認し、dpkg --print-architecture が amd64 または arm64 を出力することを確認してください。リポジトリは他のアーキテクチャのパッケージを公開していません。

Anthropic の apt リポジトリを登録せずにインストールするには、まず /etc/default/claude-desktop を CLAUDE_DESKTOP_ADD_REPO="false" という行で作成してください。リポジトリがない場合、apt は新しいバージョンを提供しません。更新するには、ダウンロードコマンドを再度実行して再インストールするか、後で リポジトリを登録 してください。

次に、ダウンロードしたファイルをソフトウェアインストーラー（GNOME Software など）で開くか、ダウンロードしたファイルが含まれているディレクトリから apt でインストールします。

sudo apt install ./claude-desktop_*.deb

apt が E: Unsupported file ./claude-desktop_*.deb given on commandline を報告する場合、パターンが現在のディレクトリ内の .deb ファイルと一致しませんでした。ダウンロードが完了したことを確認してから、ファイルが含まれているディレクトリからコマンドを再度実行してください。

.deb をインストールすると、Anthropic の apt リポジトリも /etc/apt/sources.list.d/claude-desktop.list に登録されるため、今後の更新はシステムの 通常のパッケージ更新 で提供されます。

更新

デスクトップアプリは Linux では自動的に更新されません。更新はシステムの通常のパッケージ更新で提供されます。

sudo apt update && sudo apt upgrade

ディストリビューションのグラフィカルソフトウェアアップデーターも新しいバージョンを検出します。

アンインストール

sudo apt remove claude-desktop

パッケージをアンインストールすると、登録されたリポジトリエントリと署名キーも削除されます。Add Anthropic's apt repository ステップでリポジトリエントリを自分で追加した場合は、それも削除してください。

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

トラブルシューティング

claude-desktop パッケージが見つからない

sudo apt install claude-desktop が E: Unable to locate package claude-desktop で失敗する場合、apt が追加したリポジトリを見つけられていません。以下を確認してください。

• リポジトリを追加した後に sudo apt update を実行してください。apt install だけでは、最後に apt update を実行した後に追加したリポジトリは認識されません。
• リポジトリエントリが書き込まれたことを確認します。cat /etc/apt/sources.list.d/claude-desktop.list は Anthropic の apt リポジトリを追加 ステップの deb 行を表示する必要があります。ファイルが空または見つからない場合は、そのステップを再度実行してください。
• アーキテクチャがサポートされていることを確認します。dpkg --print-architecture は amd64 または arm64 を出力する必要があります。リポジトリは他のアーキテクチャのパッケージを公開していません。
• sudo apt update を再度実行し、downloads.claude.ai に関連するエラーの出力を確認します。そこでネットワークまたはキーエラーが発生している場合は、リポジトリが追加されましたが、到達またはベリファイできなかったことを意味します。

リポジトリが配置されており到達可能で、パッケージがまだ見つからない場合は、代わりに ダウンロードしたファイルからインストール してください。

未解決の依存関係

apt が The following packages have unmet dependencies または Unsatisfied dependencies で停止する場合は、名前が付けられている依存関係を読んでください。

• libc6 (>= 2.34)：ディストリビューションがパッケージがサポートするより古いです。Ubuntu 20.04 は libc6 2.31 を搭載しています。Ubuntu 22.04 以降または Debian 12 以降にアップグレードしてください。
• すべての欠落している依存関係が :amd64 または :arm64 サフィックス付きで not installable を表示する場合：マシンのアーキテクチャと異なるアーキテクチャの .deb をダウンロードしました。dpkg --print-architecture を実行して一致する .deb をダウンロードするか、apt リポジトリからインストール してください。これはアーキテクチャのパッケージを選択します。

root として --no-sandbox なしで実行することはサポートされていません

claude-desktop がこのメッセージで終了する場合、root として起動しました。通常のユーザーとしてログインして、そこから起動してください。

Cowork が利用できない

Cowork タブがこれらのメッセージのいずれかを表示する場合は、名前が付けられている要件を修正してから、アプリを再起動してください。

• Cowork には QEMU が必要です：メッセージが一覧表示する QEMU と UEFI ファームウェアパッケージ をインストールしてください。
• Cowork にはハードウェア仮想化（KVM）が必要です：ファームウェア設定で ハードウェア仮想化 をオンにしてください。
• Claude には仮想化を使用する権限がありません（/dev/kvm）：ユーザーを kvm グループ に追加してから、ログアウトしてログインし直してください。
• Cowork には vhost_vsock カーネルモジュールが必要です：sudo modprobe vhost_vsock を実行してから、アプリを再起動してください。これは現在のブートのみモジュールをロードします。すべてのブートでロードするには、echo vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.conf を実行してください。

Linux ベータ版にまだ含まれていない機能

• Computer Use: アプリとスクリーン制御は Linux では利用できません。
• Dictation: 音声入力は Linux デスクトップアプリでは利用できません。代わりに CLI で音声ディクテーションを使用してください。
• Quick Entry グローバルホットキー: X11 で動作します。ネイティブ Wayland では、デスクトップ環境の GlobalShortcuts ポータルが必要です。
• Fedora と RHEL: 現在、Debian ベースのディストリビューションのみがサポートされています。追加のディストリビューションのサポートは今後提供される予定です。

デスクトップアプリでまだ利用できない機能については、CLIは同じ Claude Code エンジンを実行し、より広い範囲の Linux ディストリビューションをサポートしています。システム要件を参照してください。