ガイド

著者 Matt Connor 2026-08-07 ・更新日 2026-08-26

ClaudeはLinuxで使える？DesktopアプリとCLIの違い

Q: Linux で Claude Code を実行するには Node.js が必要ですか？

推奨されるインストール方法では必要ありません。curl -fsSL https://claude.ai/install.sh | bash は、実行時に Node.js を使用しないコンパイル済みバイナリをダウンロードします。Node.js が必要になるのは npm パッケージをインストールする場合だけです。version 2.1.198 時点では Node.js 22 以降が要求されます。古い Node.js では npm が EBADENGINE 警告を表示しますが、同じネイティブバイナリがプラットフォーム別の依存関係として取得されるため、インストール自体は完了します。sudo npm install -g でインストールしないでください。npm の prefix に root 所有のファイルが残り、後続の更新に失敗する原因になります。

Q: SSH 経由で Claude Code にログインするにはどうすればよいですか？

claude を実行すると、認証 URL が表示されます。その URL はサーバー上ではなく、自分のコンピューターのブラウザーで開きます。サインインすると、ブラウザーにはリダイレクトではなくログインコードが表示されます。これは、Claude Code がリモートマシンの loopback アドレスで起動した callback listener にブラウザーから接続できないためです。そのコードを Paste code here if prompted プロンプトに貼り付けます。誰も操作していない状態で開始するセッションでは、claude setup-token を実行し、表示された token を必要な場所で CLAUDE_CODE_OAUTH_TOKEN として設定します。

Q: Claude Code は Linux のどこにログイン情報を保存しますか？

~/.claude/.credentials.json に file mode 0600 で保存されます。または、その変数を設定している場合は CLAUDE_CONFIG_DIR 配下に保存されます。macOS と異なり、Linux では keychain を使用しないため、ユーザーとして実行されるプロセスであればファイルを読み取れます。そのため、/home backup やマシンイメージには有効なログイン情報が含まれます。システムの snapshot またはコピーを作成する前に /logout を実行してください。環境に ANTHROPIC_API_KEY も設定されている場合、承認後は保存済みの subscription login より優先されます。/status で現在有効なログインを確認できます。

Linuxで使えるClaudeを整理。aptで入れるベータ版Desktopアプリ、Claude Code CLI、エディタプラグインの対応状況と、必要な有料プランを確認できます。

Claude のどの部分が現在 Linux でネイティブに動作するか

Claude は Linux 上で 4 つの独立した環境で動作します。2026 年 8 月時点では、4 つすべてが通常の Ubuntu または Debian マシンで利用できます。デスクトップアプリは Anthropic の apt リポジトリからインストールでき、ベータ版です。Claude Code CLI (command line interface) はコンパイル済みバイナリで、デスクトップアプリより多くのディストリビューションで動作します。claude.ai の Web アプリはブラウザだけで利用でき、API は独自のコードから呼び出す HTTPS エンドポイントです。

macOS と Windows にある機能のうち、Linux のデスクトップベータ版には 2 つありません。1 つは Claude が画面上のアプリを操作する Computer Use で、もう 1 つは音声入力です。Anthropic のドキュメントでは、どちらも Linux ではまだ利用できないとされています。CLI には独自の音声入力機能があるため、この差は Claude 自体ではなくデスクトップアプリにあります。

利用可能な機能は変わるため、このページは各環境の説明として読み、これを前提に計画する前に現在の状態を確認してください。最後のセクションに、確認すべきページを示します。

Ubuntu または Debian に Claude デスクトップアプリをインストールする

公式に記載されている要件は、x86_64（dpkg では amd64 と呼ばれます）または arm64 の Ubuntu 22.04 以降、あるいは Debian 12 以降です。その他の Debian 系ディストリビューションでも動作する可能性はありますが、テストされていません。Fedora と RHEL にはまだパッケージがないため、これらの環境では CLI またはブラウザーを使用します。

ダウンロードした .deb ファイルからではなく、apt リポジトリからインストールします。Linux アプリには独自の更新機能がないため、新しいバージョンはパッケージマネージャー経由でのみ提供されます。リポジトリを登録することで、apt upgrade が新しいバージョンを取得できるようになります。

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

gpg --show-keys はフィンガープリント 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE を表示するはずです。リポジトリを登録する前に照合してください。確認していない署名鍵を、何も確認せずに信頼することになるためです。gpg がファイルに有効な OpenPGP データがないと報告した場合、ダウンロードに失敗しています。その場合、後で apt update が NO_PUBKEY BAA929FF1A7ECACE とともに失敗します。

リポジトリの登録は、/etc/apt/sources.list.d/claude-desktop.list に記述する deb 行です。Anthropic の Linux インストールページ code.claude.com/docs/en/desktop-linux から、その行を表示どおりに正確にコピーします。この手順で最も変更される可能性が高いのはリポジトリのアドレスです。記憶で入力した行を使うと、後で E: Unable to locate package claude-desktop が表示されることになります。貼り付ける前に行の内容を確認してください。arch=amd64,arm64 は、他のアーキテクチャでは apt が何も見つけられない理由です。signed-by= は、確認したばかりのキーリングファイルを指定しています。これにより、その鍵はこのリポジトリだけに限定され、apt が読み取る他のすべての対象に対して信頼されることを防げます。

sudo apt update && sudo apt install claude-desktop

アプリケーションランチャーから起動するか、ターミナルで claude-desktop を実行します。claude.ai のアカウントでサインインします。会社で設定されている場合は、組織の SSO（シングルサインオン）も使用できます。デスクトップアプリは Claude Console API key を受け付けません。key based authentication は CLI の機能です。

E: Unable to locate package claude-desktop は、apt がリポジトリを読み取っていないことを示します。cat /etc/apt/sources.list.d/claude-desktop.list には、記述した deb 行が表示されるはずです。また、他のアーキテクチャ向けのパッケージは公開されていないため、dpkg --print-architecture は amd64 または arm64 を表示するはずです。以後の更新は、sudo apt update && sudo apt upgrade からシステムの他の更新とともに提供されます。

ブラウザーでのみ利用できるもの

claude.ai は、どのディストリビューションでも現在のブラウザーから利用できます。そのため、Fedora、RHEL、Arch、openSUSE など、パッケージが提供されていない環境でも利用できます。ブラウザーでは Claude Code on the web も利用できます。この場合、セッションはマシン上ではなく Anthropic のクラウドで実行され、常にサブスクリプションの認証情報が使用されます。

ブラウザーの制限を理解しておくことが重要です。クラウド上のセッションは、自分のサーバーにあるファイルを読み取ったり、サーバー上でコマンドを実行したりできません。マシンにアクセスする処理には、そのマシン上のソフトウェアが必要です。つまり、CLI またはデスクトップアプリを使用します。

CLI で Web アプリケーションにはできないこと

claude をディレクトリ内で起動すると、そのディレクトリを対象に動作します。違いはそこにあり、その他の特徴もここから生まれます。

作業ディレクトリ内のファイルを読み取り、編集します。編集を適用する前に、その内容を表示します。
承認した shell コマンドを実行します。そのため、プロジェクトのビルド、テストスイートの実行、ログの確認、サーバー上のサービスの調査ができます。
対話セッションなしで実行できます。claude -p "read the nginx error log and summarise it" は 1 つの回答を出力して終了するため、cron ジョブやパイプラインから利用できます。回答の形式は設定できます。出力スタイルで各回答の背後にある system prompt を変更できるため、スクリプト実行では簡潔にし、対話セッションでは内容を説明させることができます。
claude mcp add を使用して MCP (model context protocol) サーバーに接続できます。これにより、ファイルシステム以外のツールもモデルから利用できます。
グラフィカルなデスクトップがまったくない環境でも動作します。これは、これからレンタルする VPS (virtual private server) では常に該当します。

この最後の点が、サーバーガイドで CLI を扱う理由です。レンタルサーバーにあるのは SSH (secure shell) だけで、それ以外はありません。そのため、端末だけがサーバー上で利用できる操作環境になります。この方法で実行する場合にも固有のルールがあります。VPS 上の tmux 内で Claude Code を実行する方法で詳しく説明し、日常的なシステム管理作業で Claude を使用する方法では、任せる価値のある作業を説明します。

エディター連携は、この 2 つの中間に位置します。VS Code 拡張機能には VS Code 1.94.0 以降が必要で、diff と計画の確認ができるグラフィカルなパネルをエディター内に表示します。このパネル用に CLI の専用コピーを組み込みますが、claude を PATH に追加しません。そのため、統合ターミナルで claude と入力する場合も、standalone install が必要です。VS Code を基盤とするエディターでは、Open VSX registry から同じ拡張機能をインストールできます。JetBrains plugin もあります。

Linux で Claude Code を実行するために Node.js は必要ですか？

推奨されるインストール方法では必要ありません。ネイティブインストーラーはコンパイル済みバイナリをダウンロードします。このバイナリは Node.js 上では実行されません。

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version を実行すると、2.1.211 (Claude Code) のようなバージョン番号が表示されます。問題があるように見える場合は claude doctor を実行してください。セッションを開始せずに、インストールと設定ファイルに関する読み取り専用の診断情報が表示されます。

Node.js が関係するのは npm でインストールする場合だけです。パッケージバージョン 2.1.198 以降では、npm パッケージに Node.js 22 以降が必要です。古い Node.js で実行すると、npm は EBADENGINE 警告を表示しますが、処理は失敗しません。パッケージがプラットフォームごとの依存関係として同じネイティブバイナリを取得し、適切な場所にリンクするためです。

npm install -g @anthropic-ai/claude-code

sudo を付けて実行しないでください。ドキュメントでは sudo npm install -g を避けるよう警告しています。これを行うと、グローバル npm プレフィックス内に root 所有のファイルが作成されるため、次回の権限なしでのインストールまたは更新が権限エラーで失敗します。npm のグローバルディレクトリに書き込めない場合は、バックグラウンドの自動更新が停止し、claude doctor に修正方法が示されます。

Anthropic は Debian、Fedora、RHEL、Alpine 用の署名付きパッケージリポジトリも公開しています。そのため、sudo apt install claude-code はデスクトップ版のパッケージとほぼ同じように動作し、専用の署名鍵は https://downloads.claude.ai/keys/claude-code.asc にあります。

ユーザー単位でインストールするか、システム全体にインストールするか

ネイティブインストーラーはユーザー単位のインストールです。~/.local/bin/claude にランチャーを配置し、これは ~/.local/share/claude/versions/ へのシンボリックリンクです。root 権限は不要で、バックグラウンドで自動更新されます。同じマシン上でも、ユーザーごとに別のコピーが異なるバージョンで配置されます。

パッケージマネージャーによるインストールはシステム全体が対象です。1 つのバイナリをすべてのユーザーで共有するため、root 権限が必要です。また、Claude Code 経由では自動更新されません。sudo apt update && sudo apt upgrade claude-code を実行してアップグレードします。これは、そのマシン上で他のソフトウェアに対してすでに実行しているコマンドと同じです。

自分のアカウントでログインして使用するマシンでは、ユーザー単位のインストールを選択してください。これは、多くの VPS 運用に適しています。共有サーバーやマシンイメージでは、パッケージによるインストールを選択してください。全ユーザーで 1 つのバージョンを使用し、予定したタイミングで更新したい場合に適しています。ネイティブインストールでは、~/.claude/settings.json 内の 2 つの設定で更新動作を決めます。

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

stable チャネルは、おおむね 1 週間前にリリースされたバージョンを追従し、重大なリグレッションを含むリリースをスキップします。DISABLE_AUTOUPDATER が停止するのはバックグラウンドチェックだけです。そのため、claude update は引き続き使用でき、新しいバージョンを適用するタイミングを自分で管理できます。サーバー上で長時間のジョブを無人で実行しており、実行中にバイナリが変わってほしくない場合に重要な設定です。

SSH でログインし、セッションを維持する

レンタルサーバーで CLI を初めて実行すると、Linux 特有の問題が 2 つ発生します。ログインフローではブラウザーが必要ですが、サーバーにはブラウザーがありません。SSH 接続が切れると、実行中の作業も停止します。

2 つ目の問題は tmux で解決できます。tmux セッションは接続ではなくリモートマシン上の tmux サーバーに属します。そのため、接続が切れてもプロセスは実行を続けます。

tmux new -s claude
claude

Ctrl-b の後に d を実行するとデタッチできます。後で tmux attach -t claude を実行すれば戻れます。

ログインが 1 つ目の問題です。claude を実行すると、認証 URL が表示されます。その URL を自分のコンピューターのブラウザーで開きます。サインインすると、ブラウザーはリダイレクトせずにログインコードを表示します。これは、ノートパソコンのブラウザーから、リモートマシンのループバックアドレスで Claude Code が起動したコールバックサーバーに接続できないためです。そのコードを Paste code here if prompted プロンプトでターミナルに貼り付けると、ターミナルに Login successful と表示されます。

誰も見ていない状態でセッションを開始する必要がある場合は、claude setup-token を実行します。同じブラウザー認証を開き、1 年間有効な OAuth トークンをターミナルに表示します。トークンはどこにも保存されないため、コピーして必要な場所に設定してください。

export CLAUDE_CODE_OAUTH_TOKEN=your-token

このトークンには有料プランが必要で、モデルへのリクエストにのみ使用できます。1 年間有効なパスワードとして扱ってください。保管場所と、エージェントがトークンを読み出せないようにする方法については、AI エージェントから秘密情報を遠ざけるで説明します。

小規模なサーバーでは、さらに 1 つ問題があります。インストールにはおよそ 512 MB の空きメモリが必要です。また、実行時のハードウェア要件は 4 GB 以上の RAM と記載されています。そのため、1 GB のインスタンスでは kernel の out-of-memory killer によってインストールが終了します。

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

swap を追加してから、インストーラーを再度実行します。swap は、kernel がオーバーフローしたメモリとして使用するディスク領域です。RAM より大幅に低速ですが、インストールを完了するには十分です。

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

swapon は、このブート中だけファイルを有効にします。再起動後も有効にしたい場合は、/swapfile の行を /etc/fstab に追加してください。実稼働サーバーでエージェントにコマンドを実行させる前に、ほかに何を制限すべきかについては、VPS で Claude Code を安全に実行するで説明します。

Linux で Claude の認証情報が保存される場所

Linux では、/login が認証情報を ~/.claude/.credentials.json にファイルモード 0600 で書き込みます。macOS では同じ認証情報が暗号化された Keychain に保存されるため、Mac で身に付けた習慣はそのまま使えません。Linux ではトークンがホームディレクトリ内の平文ファイルに保存され、ユーザーとして実行されるすべてのプロセスが読み取れます。CLAUDE_CONFIG_DIR を設定すると、ファイルは代わりにそのディレクトリ配下へ移動します。

ここから 2 つの点が分かります。/home のバックアップには有効なログイン情報が含まれるため、そのバックアップを共有マシンへコピーすると、読み取り権限を持つ他のユーザーにアカウントを渡すことになります。また、ログイン済みのマシンから作成したマシンイメージには、そのログイン情報が含まれ、そこからクローンしたすべてのインスタンスへ引き継がれます。スナップショットを作成する前に /logout を実行してください。

サブスクリプションと API key を同時に使用している場合、認証情報の優先順位に注意が必要です。シェルで ANTHROPIC_API_KEY が設定されていると、承認後に Claude Code はそれを使用します。そのためサブスクリプションは使われず、key に対して token 単位の料金が発生します。/status で現在有効な認証情報を確認でき、unset ANTHROPIC_API_KEY でサブスクリプションのログインに戻れます。

ログインには有効期限があります。有効期限の 3 日前から、起動時の行に Your login expires in 3 days と表示されます。この警告によってリクエストが停止することはありません。有効期限が切れると、すべてのリクエストが Login expired · Please run /login で失敗します。週末に無人のセッションを実行したままにする前に、この点を確認してください。そのようなセッションは処理が進まなくなり、自動的には復旧できません。

すべてを1つの Claude サブスクリプションで利用できますか？

1つの有料プランで、同じログイン情報を使ってすべての利用環境にアクセスできます。Pro、Max、Team、Enterprise のアカウントでは、ブラウザーの claude.ai、デスクトップアプリ、CLI、VS Code 拡張機能にサインインでき、どの場合も同じサブスクリプションが適用されます。利用枠もすべての環境で共通です。そのため、サーバーで CLI を長時間実行すると、デスクトップアプリで利用できる残りの枠も消費されます。いずれかの環境で処理が拒否され始めた場合は、どの制限期間に達したのか、どう対処するのかを確認する必要があります。無料の claude.ai プランには Claude Code へのアクセスが含まれません。そのため、CLI とデスクトップアプリの Claude Code 機能には、有料プランまたは Claude Console アカウントが必要です。

API は別の製品で、請求方式も異なります。Console アカウントでは、実際に送信したトークン数に応じて料金が発生します。これは、ターミナルで入力する用途よりも、構築するサービスに適した方式です。ANTHROPIC_API_KEY を設定すると、CLI はこの請求方式に切り替わります。これは自分で選択するものであり、フォールバックではありません。

料金とプランの制限は頻繁に変わるため、ここでは再掲しません。最新の数値は、Claude Code の実際の料金と必要な Claude プランの2ページで確認できます。トークン単位の請求と月額プランを比較する場合は、サブスクリプションと比較した APIで損益分岐点を確認できます。

実際に発生するインストールエラー

インストールが成功した直後の bash: claude: command not found。 バイナリは ~/.local/bin/claude にありますが、そのディレクトリがシェルの検索パスに含まれていません。echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin" で確認できます。エントリがない場合は何も出力されません。bash では echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc で修正し、その後 source ~/.bashrc を実行します。VS Code 拡張機能だけをインストールしても、このファイルは作成されません。拡張機能は CLI のコピーを拡張機能ディレクトリ内に保持するためです。

Error loading shared library libstdc++.so.6。 インストーラーが glibc システム向けに musl ビルドを選択しています。musl のクロスコンパイルパッケージが存在すると、検出処理が誤判定することがあります。ldd --version 2>&1 | head -1 を実行してください。出力の GNU libc または GLIBC は glibc を使用していることを示します。この場合は誤ったバイナリを受け取っているため、インストールを削除してインストーラーを再実行します。Alpine などの musl システムでは、逆に apk add libgcc libstdc++ ripgrep を実行します。

1 台のホストに claude が 2 つある場合。 which -a claude で PATH 内のすべての一致を一覧表示できます。ネイティブインストールは ~/.local/bin/claude から ~/.local/share/claude/versions/ へのシンボリックリンクです。従来のローカル npm インストールは ~/.claude/local/ 配下にあり、npm -g ls @anthropic-ai/claude-code でグローバル npm インストールを確認できます。不要なものを削除してください。PATH の前方に古いコピーが残っていると、修正済みのバグが直っていないように見えるためです。

現在の状態を確認する場所

Linux デスクトップの対応状況、要件、インストールコマンド: code.claude.com/docs/en/desktop-linux
CLI が対応するディストリビューションとすべてのインストール方法: code.claude.com/docs/en/setup
ダウンロード可能なアプリが存在するプラットフォーム: claude.com/download
各プランの内容と料金: claude.com/pricing

このガイドに記載したバージョン番号と日付は、すべて 2026 年 8 月時点のスナップショットです。今後も変わらない基本構成は、4 つの利用形態、有料の利用形態間で共有する 1 つのログイン、そして CLI をユーザー単位で導入するかマシン全体に導入するかという 1 つの選択です。

FAQ

Linux 向けの Claude desktop app はありますか？

あります。2026 年 8 月時点では beta 版で、amd64 または arm64 の Ubuntu 22.04 以降と Debian 12 以降をサポートしています。Anthropic の apt リポジトリと署名キーを追加してから sudo apt install claude-desktop でインストールすると、新しいバージョンが通常のシステム更新で適用されます。Linux 版には macOS アプリと同じタブがあり、Claude Code タブも含まれます。Computer Use と音声入力はまだ Linux 版に含まれていません。また、Fedora と RHEL 向けのパッケージはないため、これらのディストリビューションでは CLI またはブラウザーの claude.ai を使用します。

Linux で Claude Code を実行するには Node.js が必要ですか？

推奨されるインストール方法では必要ありません。curl -fsSL https://claude.ai/install.sh | bash は、実行時に Node.js を使用しないコンパイル済みバイナリをダウンロードします。Node.js が必要になるのは npm パッケージをインストールする場合だけです。version 2.1.198 時点では Node.js 22 以降が要求されます。古い Node.js では npm が EBADENGINE 警告を表示しますが、同じネイティブバイナリがプラットフォーム別の依存関係として取得されるため、インストール自体は完了します。sudo npm install -g でインストールしないでください。npm の prefix に root 所有のファイルが残り、後続の更新に失敗する原因になります。

SSH 経由で Claude Code にログインするにはどうすればよいですか？

claude を実行すると、認証 URL が表示されます。その URL はサーバー上ではなく、自分のコンピューターのブラウザーで開きます。サインインすると、ブラウザーにはリダイレクトではなくログインコードが表示されます。これは、Claude Code がリモートマシンの loopback アドレスで起動した callback listener にブラウザーから接続できないためです。そのコードを Paste code here if prompted プロンプトに貼り付けます。誰も操作していない状態で開始するセッションでは、claude setup-token を実行し、表示された token を必要な場所で CLAUDE_CODE_OAUTH_TOKEN として設定します。

Claude Code は Linux のどこにログイン情報を保存しますか？

~/.claude/.credentials.json に file mode 0600 で保存されます。または、その変数を設定している場合は CLAUDE_CONFIG_DIR 配下に保存されます。macOS と異なり、Linux では keychain を使用しないため、ユーザーとして実行されるプロセスであればファイルを読み取れます。そのため、/home backup やマシンイメージには有効なログイン情報が含まれます。システムの snapshot またはコピーを作成する前に /logout を実行してください。環境に ANTHROPIC_API_KEY も設定されている場合、承認後は保存済みの subscription login より優先されます。/status で現在有効なログインを確認できます。

Claude Pro subscription では CLI と Web アプリの両方を利用できますか？

はい。Pro、Max、Team、Enterprise のいずれのプランでも、1 つのアカウントで claude.ai、desktop app、CLI、VS Code extension にログインできます。無料の claude.ai プランには Claude Code が含まれないため、terminal CLI には有料プランまたは Claude Console account が必要です。API は Console account から token 単位で別途課金されます。これは subscription とは異なる製品です。

#claude #linux #claude-code #cli#desktop