ClaudeCodeのLinuxインストール方法【Ubuntu/Debian/Fedora対応】
「LinuxでClaudeCodeを使いたいけれど、ディストリビューションごとに手順が違って混乱する」と感じていませんか。本記事では、Ubuntu／Debian／Fedora／Arch Linuxという主要4ディストリビューションそれぞれに対し、ClaudeCodeを確実に動かすための手順をまとめました。Node.jsの導入から依存関係の解決、初回起動時の認証、トラブル対処まで、Linux初心者にもわかるよう図表とコマンド例を交えて解説します。読み終えるころには、あなたのLinux環境でClaudeCodeがしっかり動いているはずです。
結論ファースト：Linuxでの最短セットアップ
結論からお伝えすると、LinuxへのClaudeCode導入は次の3行で完了します（Ubuntu／Debianの場合）。
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
sudo npm install -g @anthropic-ai/claude-code
これでインストールは終わり、あとは claude と打って起動するだけです。Fedoraなら dnf、Arch Linuxなら pacman を使う点が違いますが、基本的な流れは「Node.jsを入れる→npmでClaudeCodeをグローバルインストール→起動して認証」の3段階で共通です。
| ディストリビューション | パッケージマネージャ | Node.js導入の難易度 |
|---|---|---|
| Ubuntu 22.04 / 24.04 | apt | 易しい |
| Debian 11 / 12 | apt | 易しい |
| Fedora 40+ | dnf | 普通 |
| Arch Linux | pacman | 易しい |
| openSUSE Leap 15 | zypper | 普通 |
Linuxの公式リポジトリにあるNode.jsは古いバージョンであることが多いため、後述の「NodeSource」など外部リポジトリの活用がおすすめです。これにより常に最新LTSのNode.jsを使えます。
事前準備：Linuxで確認すべき5項目
インストールに進む前に、お使いのLinux環境を確認しましょう。次の5項目を押さえれば、ほぼ詰まりません。
1. ディストリビューションとバージョン
cat /etc/os-release
Ubuntu／Debian／Fedoraなど、自分の環境を把握します。
2. CPUアーキテクチャ
uname -m
x86_64（一般的なPC）か aarch64（ARM、ラズパイなど）かを確認。ClaudeCodeはどちらでも動きますが、ARM向けNode.jsは別途バイナリ選択が必要です。
3. インターネット接続
ping -c 3 api.anthropic.com
接続できることを確認します。社内ネットワークの場合はプロキシ設定も要チェック。
4. sudo権限
sudo -v
エラーが出なければOK。出る場合は管理者にsudo権限を依頼してください。
5. 既存のNode.js
node -v 2>/dev/null
すでに18以上が入っていれば再インストール不要。古い場合はアンインストールしてから新しいバージョンを入れます。
Ubuntuへのインストール手順
Ubuntu（22.04 LTSまたは24.04 LTSを想定）でのインストールは最もシンプルです。
ステップ1：パッケージリストを更新
sudo apt update
sudo apt upgrade -y
ステップ2：NodeSourceリポジトリを追加
Ubuntu公式のNode.jsは古いことがあるため、NodeSourceリポジトリを使って最新LTSを入れます。
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
curl が入っていない場合は sudo apt install -y curl を先に実行してください。
ステップ3：Node.jsとnpmの確認
node -v # v22.x.x
npm -v # 10.x.x
ステップ4：ClaudeCodeをインストール
sudo npm install -g @anthropic-ai/claude-code
sudo を使いたくない場合は、npmのprefix設定を変更する方法もあります。これはホームディレクトリにグローバルパッケージを置く方法です。
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code
ステップ5：起動と認証
claude
ブラウザが自動で開き、Anthropicアカウントで認証します。CUI（GUIなし）環境の場合は、表示されるURLを別のPCで開いて認証コードを取得する方法もサポートされています。
Debianへのインストール手順
Debian 11（Bullseye）／12（Bookworm）はUbuntuとほぼ同じ手順です。違いは「sudoがデフォルトで入っていないことがある」点です。
ステップ1：sudoのセットアップ（必要な場合のみ）
su -
apt install -y sudo
usermod -aG sudo yourusername
exit
ログインし直すと、ユーザーアカウントから sudo が使えるようになります。
ステップ2：必要パッケージのインストール
sudo apt update
sudo apt install -y curl build-essential
build-essential はnpmパッケージの一部がコンパイルを要求するときに必要です。
ステップ3：Node.js（NodeSource経由）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
ステップ4：ClaudeCodeのインストール
sudo npm install -g @anthropic-ai/claude-code
Debianは安定性を優先するディストリビューションのため、デフォルトリポジトリのNode.jsは古いバージョンになりがちです。必ずNodeSourceなどの新しいリポジトリを使いましょう。
Fedoraへのインストール手順
Fedora 40以降を想定します。FedoraはRPM系で、パッケージマネージャに dnf を使います。
ステップ1：システムを最新化
sudo dnf upgrade -y
ステップ2：必要パッケージのインストール
sudo dnf install -y curl gcc-c++ make
ステップ3：Node.jsのインストール
FedoraもNodeSourceリポジトリが使えます。
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs
または、Fedora公式のModuleStreamを使う方法もあります。
sudo dnf module install -y nodejs:22/common
ステップ4：ClaudeCodeのインストール
sudo npm install -g @anthropic-ai/claude-code
ステップ5：SELinuxとの相性
Fedoraは標準でSELinuxが有効です。ClaudeCodeの動作に直接影響することは稀ですが、ファイル操作で「Permission denied」が出た場合はSELinuxの一時的な無効化（sudo setenforce 0）で原因切り分けができます。常時無効化はセキュリティ上推奨しません。
Arch Linuxへのインストール手順
Arch Linuxは「ローリングリリース」モデルで、常に最新パッケージが揃います。
ステップ1：システム更新
sudo pacman -Syu
ステップ2：Node.jsとnpmのインストール
sudo pacman -S nodejs npm
公式リポジトリの nodejs パッケージは常に最新版が提供されるため、別途リポジトリを追加する必要はありません。
ステップ3：ClaudeCodeのインストール
sudo npm install -g @anthropic-ai/claude-code
Arch User Repository（AUR）から入れる方法
AURヘルパー（yay、parulなど）を使えば、コミュニティ提供のClaudeCodeパッケージを試せます（提供状況は時期により異なる）。
yay -S claude-code
ただし、AURパッケージは公式ではないため、最新性とセキュリティの観点からは公式npm経由のほうが安全です。
openSUSEへのインストール手順
openSUSE Leap 15.5以降を想定します。
ステップ1：システム更新
sudo zypper refresh
sudo zypper update -y
ステップ2：Node.jsのインストール
sudo zypper install -y nodejs22 npm22
バージョンが古い場合は、NodeSource相当のリポジトリを追加するか、公式バイナリ（nodejs.org）を手動配置します。
ステップ3：ClaudeCodeのインストール
sudo npm install -g @anthropic-ai/claude-code
nvmで複数バージョンを管理する
開発プロジェクトごとに異なるNode.jsバージョンを使い分けたい場合は、nvm（Node Version Manager）がおすすめです。これはLinuxの全ディストリビューションで使えます。
# nvmのインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# ターミナル再読み込み
source ~/.bashrc
# 最新LTSをインストール
nvm install --lts
nvm use --lts
# ClaudeCodeをインストール
npm install -g @anthropic-ai/claude-code
nvmを使うと sudo 不要でグローバルインストールできるのが大きな利点です。プロジェクトごとに .nvmrc ファイルを置けば、フォルダに入った瞬間に自動でバージョン切り替えも可能です。
初回起動時の認証フロー
インストール後、claude コマンドを実行すると認証が始まります。
GUI環境（デスクトップあり）の場合
claude
ブラウザが自動で開き、Anthropicのログイン画面が出ます。メールアドレスとパスワードを入力し、認証コードを受け取って入力、最後に「Authorize Claude Code」をクリック。ターミナルに Login successful が出れば完了です。
CUI環境（デスクトップなし、SSHログイン）の場合
サーバーや仮想マシンでGUIがない場合、ターミナルに認証用URLが表示されます。これをコピーして、別のPCのブラウザで開きましょう。認証後、表示される認証コードをサーバー側のターミナルに貼り付ければOKです。
claude --no-browser
このオプションを使うと最初からブラウザ起動を抑制できます。
Linux特有のトラブルシューティング
Linux環境でClaudeCodeを使う際によく遭遇する問題と解決策をまとめました。
| 症状 | 原因 | 解決策 |
|---|---|---|
command not found: claude |
PATHが通っていない | ~/.bashrc に export PATH=$PATH:$(npm config get prefix)/bin を追加 |
EACCES: permission denied |
グローバルディレクトリの権限不足 | nvm利用、または ~/.npm-global 構成に変更 |
Error: Cannot find module |
Node.jsのバージョン不一致 | node -v で18以上か確認、古ければ再インストール |
| プロキシ環境で接続不可 | 企業ネットのプロキシ | npm config set proxy http://proxy:port で設定 |
| 日本語表示が文字化け | ロケール未設定 | sudo locale-gen ja_JP.UTF-8 を実行 |
| 起動はするがログイン画面が開かない | デフォルトブラウザ未設定 | xdg-settings set default-web-browser firefox.desktop |
プロキシ設定の例
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
ロケール設定
日本語を扱う場合は、UTF-8ロケールを設定しておくのが安全です。
sudo apt install -y locales
sudo locale-gen ja_JP.UTF-8
export LANG=ja_JP.UTF-8
サーバー（リモート）環境でのインストール
VPSやクラウドサーバー（AWS EC2、GCP、Azureなど）にClaudeCodeを入れたい場合も基本手順は同じです。ただし以下に注意してください。
- SSH経由のセットアップ：ローカルからSSHで接続し、上記の手順をリモート側で実行します。
- ファイアウォール：Anthropicの
api.anthropic.comへの443番ポート（HTTPS）が許可されている必要があります。 - GUIなしの認証：
--no-browserオプションを使い、URL／コード方式で認証します。 - 永続セッション：SSHが切れても作業を続けたいなら
tmuxやscreenを使いましょう。
# tmuxの例
tmux new -s claude
claude
# Ctrl + B → D でデタッチ、後で tmux attach -t claude で復帰
アップデートとアンインストール
ClaudeCodeのアップデート
sudo npm update -g @anthropic-ai/claude-code
または再インストール。
sudo npm install -g @anthropic-ai/claude-code@latest
アンインストール
sudo npm uninstall -g @anthropic-ai/claude-code
設定ファイルも消したい場合は、ホームディレクトリの ~/.claude フォルダも削除します。
rm -rf ~/.claude
詳しくはClaudeCodeのアップデート方法とClaudeCodeのアンインストール手順を参照してください。
よくある質問（FAQ）
Q1. 古いLinux（Ubuntu 18.04など）でも動きますか？ A. Node.js 18以上が動けば技術的には動作しますが、セキュリティアップデートが終了したディストリビューションは推奨しません。Ubuntu 22.04 LTS以降にアップグレードを検討してください。
Q2. Raspberry Pi（ARM）でも使えますか？
A. はい、ARM64版Node.jsを入れれば動作します。ただし、npm install 時に一部のネイティブモジュールがコンパイルされ時間がかかります。
Q3. WSL2のUbuntuにインストールしてもいいですか？ A. はい、むしろWindows公式推奨の方法です。本記事のUbuntu手順をそのまま使えます。
Q4. snapパッケージやFlatpakで入れられますか？ A. 2026年5月時点では公式提供はありません。npmからのインストールを使ってください。
Q5. sudo を使わずに入れる方法は？
A. nvmを使うか、~/.npm-global にプレフィックスを設定する方法があります。本記事のUbuntu章に手順を載せています。
Q6. インストール後、claude を打つとプロセスが落ちます。
A. メモリ不足、Node.jsのバージョン不一致、依存関係の問題が考えられます。node -v を確認し、npm install -g @anthropic-ai/claude-code@latest で再インストールしてください。
Q7. 複数ユーザーで共有するサーバーで使う場合の注意点は？
A. グローバルインストールは管理者ユーザーで行い、各ユーザーは自分のアカウントで claude を起動して個別認証します。APIキーやログイン情報はユーザーごとに分離されます。
まとめ
- LinuxへのClaudeCode導入は「Node.js→npmインストール→起動認証」の3ステップ
- Ubuntu／Debian／Fedora／Arch Linuxすべてで動作可能
- Node.jsはNodeSourceなど外部リポジトリで最新LTSを入れるのが鉄則
- 権限エラー対策にはnvmまたは
~/.npm-global構成が便利 - CUI環境では
--no-browserオプションでSSH越し認証可能 - プロキシ・ロケール・ファイアウォール設定はLinux特有の確認ポイント
- アップデートとアンインストールはnpmコマンドで完結