ガイド

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

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

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

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

Linuxで使えるClaudeの範囲を解説します。aptで導入するベータ版Desktopアプリ、Claude Code CLI、エディタープラグインの対応状況と、利用できる有料プランを確認できます。

Linux で現在ネイティブに動作する Claude の範囲

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

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

提供状況は変わるため、このページは各提供形態の説明として読み、導入計画を立てる前に現在の状況を確認してください。最後のセクションに、確認すべきページを示します。

Ubuntu または Debian に Claude desktop app をインストールする

文書化されている要件は、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 に書き込む 1 行の deb です。Anthropic の Linux インストールページ code.claude.com/docs/en/desktop-linux から、その行を表示どおり正確にコピーしてください。リポジトリのアドレスは、この手順の中で最も変更される可能性が高い部分です。記憶を頼りに入力した行は、後で E: Unable to locate package claude-desktop を見続ける原因になります。貼り付ける前に行の内容を確認してください。arch=amd64,arm64 は、別のアーキテクチャでは apt が何も見つけられない理由です。signed-by= は、先ほど確認した keyring ファイルを指定します。これにより、その鍵を apt が読み取るすべての対象で信頼するのではなく、このリポジトリだけに限定できます。

sudo apt update && sudo apt install claude-desktop

アプリケーションランチャーから起動するか、ターミナルで claude-desktop を実行します。claude.ai のアカウントでサインインします。会社で設定している場合は、組織の SSO（シングルサインオン）経由でもサインインできます。desktop app は Claude Console API key を受け付けません。key ベースの認証は 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 を起動すると、そのディレクトリを対象に動作します。違いはこれだけで、その他の機能もここから派生します。

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

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

エディター統合は、CLI と Web アプリの中間に位置します。VS Code 拡張機能には VS Code 1.94.0 以降が必要です。エディター内に差分と計画の確認機能を備えたグラフィカルなパネルを表示します。このパネル用に CLI の非公開コピーを同梱しますが、claude を PATH に追加しません。そのため、統合ターミナルで claude と入力する場合も、スタンドアロン版のインストールが必要です。VS Code をベースにしたエディターでは、Open VSX レジストリから同じ拡張機能をインストールできます。JetBrains 用のプラグインもあります。

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 は引き続き動作し、新しいバージョンを適用するタイミングを制御できます。これは、長時間実行するジョブを unattended で動かすサーバーで重要です。実行中にバイナリが変更されることを避けられます。

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

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

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

tmux new -s claude
claude

Ctrl-b の後に d でデタッチし、後で tmux attach -t claude で戻ります。

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

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

export CLAUDE_CODE_OAUTH_TOKEN=your-token

このトークンには有料プランが必要で、モデルへのリクエストだけを実行できます。1 年間有効なパスワードとして扱ってください。保存場所と、エージェントによる読み出しを防ぐ方法については、AI エージェントから Secret を隔離するで説明します。

小規模なサーバーでは、もう 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拡張機能にログインできます。いずれも同じサブスクリプションが適用されます。無料の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 にありますが、このディレクトリが shell の検索パスに含まれていません。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 を自分のユーザー専用にするか、マシン全体で使えるようにするかを選択します。

FAQ

Linux 向けの Claude デスクトップアプリはありますか？

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

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

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

Claude Pro サブスクリプションは CLI と Web アプリの両方を対象にしていますか？

はい。Pro、Max、Team、Enterprise のいずれかのプランでは、1 つのアカウントで claude.ai、デスクトップアプリ、CLI、VS Code 拡張機能にサインインできます。無料の claude.ai プランには Claude Code が含まれないため、terminal CLI の利用には有料プランまたは Claude Console アカウントが必要です。API は Console アカウントからトークン単位で別途請求されます。Console アカウントは、サブスクリプションとは異なる製品です。

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