Claude を Arch Linux に導入｜AUR と公式インストーラの使い方

Arch Linux で Claude を使う 3 つの選択肢

Arch Linux で Claude Code を動かす経路は、大きく次の 3 つに整理できます。

1. 公式ネイティブインストーラ — install.sh で単一バイナリを配置。バックグラウンド自動アップデート対応で、最も手間が少ない。
2. AUR パッケージ — yay / paru などの AUR ヘルパーで pacman の流儀に揃えて導入。更新管理を pacman に寄せたい人向け。
3. npm グローバルインストール — Node.js 環境を既に持っている人向け。中身は公式バイナリと同じ。

公式のセットアップ手順を見ると、サポート OS として明記されているのは macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+、Alpine 3.19+ で、Arch Linux は名前が挙がっていません。ただしこれは「動作保証外」という意味で、x64 / ARM64 の Arch であればネイティブインストーラも npm も実際には問題なく動きます。

公式ネイティブインストーラで入れる(推奨)

最も手早い方法は公式のインストールスクリプトです。pacman を一切経由せず、ユーザー権限だけで完結します。

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

このスクリプトは ~/.local/bin/claude にバイナリを、~/.local/share/claude に関連ファイルを展開します。~/.local/bin が PATH に含まれていない場合は、.bashrc や .zshrc に以下を追記してください。

export PATH="$HOME/.local/bin:$PATH"

ネイティブインストール版は起動時とバックグラウンドで自動更新されるため、手動アップデートは基本的に不要です。安定版チャンネルに固定したい場合は bash -s stable を、特定バージョンを入れたい場合は bash -s 2.1.89 のように引数を渡せます。検索機能で使う ripgrep はバイナリに同梱されているため、Arch(glibc 環境)では追加パッケージのインストールは不要です。

AUR から Claude Code を入れる

pacman でインストール済みパッケージを一元管理したい場合は、AUR の claude-code を使います。yay などの AUR ヘルパーがあれば 1 コマンドです。

# AUR ヘルパー(yay / paru)を使う場合
yay -S claude-code
# または
paru -S claude-code

AUR には複数の派生パッケージが存在します。

• claude-code — 標準パッケージ。
• claude-code-stable — 安定版チャンネルに追従するパッケージ。
• claude-code-stable-bin — ビルド済みバイナリ版(-bin はソースからビルドせず配布物をそのまま使う Arch の慣例)。

AUR ヘルパーを使わず手動で入れる場合は、リポジトリを clone して makepkg でビルドします。

git clone https://aur.archlinux.org/claude-code.git
cd claude-code
makepkg -si

注意点として、AUR パッケージはすべてコミュニティ(個人メンテナ)製であり、Anthropic 公式ではありません。makepkg でビルドする前に PKGBUILD の中身を必ず確認し、更新が滞っていないか・信頼できるメンテナかをチェックしてから導入するのが Arch の作法です。また AUR 経由の場合、Claude Code 本体の自動アップデート機能は無効になり、更新は pacman / AUR ヘルパー側の操作で行うことになります。

npm で入れる場合の注意点

Node.js を既に使っているなら、npm からも導入できます。Node.js 18 以上が前提です。

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

npm パッケージが内部で取得するバイナリはネイティブインストーラと同一です。プラットフォーム別の optional dependency(linux-x64 / linux-arm64 など、musl 環境向けの linux-x64-musl も提供)を postinstall でリンクする仕組みのため、パッケージマネージャ側で optional dependency を許可しておく必要があります。

最大の注意点は sudo npm install -g を使わないことです。権限問題やセキュリティリスクの原因になります。グローバルディレクトリで権限エラーが出る場合は、npm のグローバル prefix をホーム配下に変更する設定で回避してください。アップグレードは npm update -g ではなく npm install -g @anthropic-ai/claude-code@latest を使います。

GUI のデスクトップ版を Arch で動かす

公式の Claude デスクトップアプリは macOS と Windows のみ対応で、Linux 版は配布されていません。Arch で GUI を使いたい場合は、Windows 版 Electron アプリを Linux 向けに再パッケージする非公式 PKGBUILD を利用します。

従来広く使われてきた aaddrick/claude-desktop-arch は、Windows インストーラから中身を抽出し、Windows 固有コードを除去して Electron を同梱する PKGBUILD でした。ただしこのリポジトリは 2025 年 11 月 8 日にアーカイブされ読み取り専用となっており、メンテナは後継として jkoelker/claude-desktop-native を案内しています。新規に導入するなら後継プロジェクトの手順を確認してください。

アーカイブ版でビルドする場合の流れは次の通りです。

git clone https://github.com/aaddrick/claude-desktop-arch.git
cd claude-desktop-arch
updpkgsums
makepkg -si

makepkg -si は依存関係(electron や asar など)を pacman 経由で自動解決しつつビルド・インストールします。パッケージ名は claude-desktop で、MCP 設定は ~/.config/Claude/claude_desktop_config.json に書き込みます。AppImage ベースで手軽に入れたい場合は AUR の claude-desktop-appimage を yay -S claude-desktop-appimage で導入する選択肢もあります。

認証と動作確認

インストール後はターミナルで claude を実行すると、ブラウザでの認証フローが始まります。

claude

利用には Pro / Max / Team / Enterprise / Console いずれかのアカウントが必要で、無料の Claude.ai プランでは Claude Code を使えません。正しく入ったかは次のコマンドで確認します。

claude --version
claude doctor

claude doctor はインストール状態・自動更新の結果・設定の問題点をまとめて診断してくれるため、command not found などのトラブル時にまず実行する価値があります。

アップデートとアンインストール

更新・削除の手順は導入経路によって異なります。

• ネイティブインストーラ版: 自動更新。即時反映したい時は claude update。削除は rm -f ~/.local/bin/claude と rm -rf ~/.local/share/claude。
• AUR 版: yay -Syu(または paru -Syu)で更新、削除は sudo pacman -R claude-code。
• npm 版: npm install -g @anthropic-ai/claude-code@latest で更新、npm uninstall -g @anthropic-ai/claude-code で削除。
• デスクトップ版: sudo pacman -R claude-desktop で削除。

設定やセッション履歴も完全に消したい場合は ~/.claude ディレクトリと ~/.claude.json を削除します。ただし VS Code 拡張・JetBrains プラグイン・デスクトップ版が残っていると、起動時に ~/.claude が再生成される点に注意してください。

まとめ

Arch Linux は Claude Code の公式サポート対象 OS ではないものの、実用上は問題なく動作します。手軽さと自動更新を重視するなら公式ネイティブインストーラ、pacman で一元管理したいならAUR(コミュニティ製である点を理解した上で)、Node.js 環境があるなら npm を選ぶのが基本方針です。GUI が必要な場合は非公式 PKGBUILD を使いますが、リポジトリのアーカイブ・後継状況を必ず確認してから導入してください。

出典: Claude Code 公式セットアップ手順 / AUR: claude-code / aaddrick/claude-desktop-arch / jkoelker/claude-desktop-native