2026年4月6日

Claude Code LinuxへのインストールとUbuntu・Debian・Alpine完全ガイド【2026年最新】

Claude Code LinuxへのインストールとUbuntu・Debian・Alpine完全ガイド【2026年最新】

室谷室谷代表取締役
今回はLinuxでClaude Codeを使う話をしましょう。実は日本語の詳しい記事がほとんどなくて・・・MYUUUのエンジニアでもクラウドサーバーをUbuntuで使っている人から「どうやってインストールすればいいですか?」って聞かれることが増えてきているんですよね。
テキトー教師テキトー教師DotAI 認定講師
.AI(ドットエーアイ)でも同じです。受講生さんの中にLinuxユーザーが意外と多くて、「MacやWindowsの記事はあるのにLinuxが出てこない」って声をよくもらいます。
室谷室谷代表取締役
そうなんですよね。Ubuntu・Debian・Alpine Linuxと、対応しているディストリビューションも広がっているので、この記事で全部まとめてしまいましょう。
テキトー教師テキトー教師DotAI 認定講師
整理すると、今回の記事では「ディストリビューション別のインストール手順」「よくあるエラーの対処法」「Linuxならではのポイント」をカバーしていきます。この記事を読むと、どんなLinux環境でもClaude Codeを動かせるようになるはずです。

Claude CodeのLinux対応状況【2026年最新】

室谷室谷代表取締役
まず現状を確認しておきましょう。Claude CodeはLinuxに正式対応しているんですが、「どのLinuxでも同じコマンド」というわけではないんですよね。
テキトー教師テキトー教師DotAI 認定講師
ここ、受講生さんがよくハマるポイントです。Ubuntuで動いたコマンドをAlpineでそのまま実行すると動かない、みたいなことが起きるので。
室谷室谷代表取締役
公式ドキュメントによると、2026年時点でサポートされているLinuxはこの3系統です。
ディストリビューション対応バージョン備考
Ubuntu20.04以上最も安定した環境
Debian10以上Ubuntu系の代表格
Alpine Linux3.19以上追加パッケージが必要
テキトー教師テキトー教師DotAI 認定講師
ハードウェア要件も確認しておきましょう。RAM 4GB以上、インターネット接続必須、シェルはBashまたはZshが必要です。

クラウドVPSでの利用を考えている人は、この4GBという要件が重要になってきます。
室谷室谷代表取締役
特にメモリが少ないVPSだとインストール中にプロセスが強制終了されることがあるので・・・このあとのトラブルシューティングで詳しく触れますね。

ディストリビューション別Claude Codeインストールフロー(Ubuntu/Debian/Alpine/Docker)

ネイティブインストーラーでClaude Code Linuxをインストールする

室谷室谷代表取締役
2026年時点では、ネイティブインストーラーが推奨です。以前はnpmでインストールする方法が主流でしたが、今はもう公式が「非推奨」としているんですよね。
テキトー教師テキトー教師DotAI 認定講師
これ、Qiitaとかの古い記事を見て「npmでインストールしよう」となってしまう人が多いんです。公式のネイティブインストーラーが速くて依存関係も不要なので、こちらを使いましょうというのが今の正解です。
室谷室谷代表取締役
Ubuntu、Debian、Alpine以外の対応Linux全てで使えるコマンドがこれです。
bash
curl -fsSL https://claude.ai/install.sh | bash
テキトー教師テキトー教師DotAI 認定講師
一行で終わるのがありがたいですよね。これを実行するだけでインストールスクリプトが自動的にシステムを検出して、適切なバイナリをダウンロードしてくれます。
室谷室谷代表取締役
インストール先は ~/.local/bin/claude です。インストール後に「claudeコマンドが見つからない」エラーが出る場合は、この場所がPATHに含まれていないことが原因です。
bash
# インストール後にPATHを確認
echo $PATH | tr ':' '\n' | grep local/bin
テキトー教師テキトー教師DotAI 認定講師
もしPATHに含まれていなければ、シェルの設定ファイルに追記します。
bash
# Bash(Linux デフォルト)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
室谷室谷代表取締役
インストール後は動作確認を兼ねて、バージョン確認と診断コマンドを両方実行しておくといいですね。
bash
# バージョン確認
claude --version

# インストールと設定の診断
claude doctor
テキトー教師テキトー教師DotAI 認定講師
claude doctorは地味ですが便利なコマンドです。認証状態、ネットワーク接続、PATH設定を一括でチェックしてくれるので、問題があった時にすぐ原因がわかります。

UbuntuでClaude Codeをインストールする手順

Claude Code公式ドキュメントのセットアップページ(認証・アップデート手順)(公式サイトより)

室谷室谷代表取締役
Ubuntuはサポートが一番手厚い環境です。ここを確認してからインストールを始めましょう。
テキトー教師テキトー教師DotAI 認定講師
受講生さんで一番多いのがUbuntu環境ですね。AWSのEC2やGCPのCompute Engineもデフォルトがだいたいubuntuだったりするので。
室谷室谷代表取締役
Ubuntu 20.04以上であれば、先ほどのネイティブインストールコマンドで問題なく動きます。追加のパッケージインストールは不要です。
bash
# Ubuntu 20.04以上での標準インストール手順

# 1. システムを最新に更新(推奨)
sudo apt update && sudo apt upgrade -y

# 2. curlが入っているか確認(通常は入っているはず)
which curl

# 3. ネイティブインストーラーを実行
curl -fsSL https://claude.ai/install.sh | bash

# 4. インストールを確認
claude --version
テキトー教師テキトー教師DotAI 認定講師
sudo apt updateを先にやっておくのは、インストールに必要な証明書周りの問題を防ぐためです。講座では必ずこの順番を守るよう伝えています。
室谷室谷代表取締役
インストール後の認証もスムーズに進みます。claudeコマンドを初回実行するとブラウザが開いてAnthropicアカウントでのログイン画面が出るので、そこで認証を完了させます。
テキトー教師テキトー教師DotAI 認定講師
ここで「Pro以上のプランが必要」という点も重要です。無料プランではClaude Codeを使えません。

Pro(月額$20)以上が必要です。
室谷室谷代表取締役
MYUUUのメンバーはほぼProかMax 5xで運用しています。普通に使うならProで十分ですよ。

Ubuntu Serverへのインストール(ヘッドレス環境)

テキトー教師テキトー教師DotAI 認定講師
GUIのないUbuntu Serverで使う場合、ブラウザ認証ができないんですよね。ここで詰まる人が割といます。
室谷室谷代表取締役
そうなんです。ヘッドレス環境の場合は認証方法が変わります。

claudeコマンド初回実行時にブラウザが開けない場合、ターミナルにURLが表示されるので、それをローカルPCのブラウザで開いて認証を完了させる流れになります。
テキトー教師テキトー教師DotAI 認定講師
あるいはAnthropicのAPIキーを直接設定する方法もあります。この場合はProプランではなくAPIキー課金になるので、使用量によってはコストが変わります。
bash
# APIキー認証の場合
export ANTHROPIC_API_KEY="your-api-key-here"
claude
室谷室谷代表取締役
チームでLinuxサーバーを使っている場合は、環境変数で管理するのが便利ですね。.bashrcや.profileに書いておくと毎回設定しなくて済みます。

DebianでClaude Codeをインストールする方法

テキトー教師テキトー教師DotAI 認定講師
Debianも基本はUbuntuと同じです。Debian 10以上であれば、同じネイティブインストールコマンドが使えます。
bash
curl -fsSL https://claude.ai/install.sh | bash
室谷室谷代表取締役
ただ、Debianは設定が少し保守的で、デフォルトのPATHがUbuntuと少し違うことがあります。インストール後は必ずPATHの確認をしてください。
テキトー教師テキトー教師DotAI 認定講師
あとはcurlがデフォルトで入っていない最小構成のDebianもあるので、確認しておきましょう。
bash
# curlがなければインストール
sudo apt install curl -y

# その後、ネイティブインストーラーを実行
curl -fsSL https://claude.ai/install.sh | bash
室谷室谷代表取締役
Debian使いの人は、自分でLinux環境を作り込んでいる人が多い印象です。最小構成から必要なものだけ入れていくスタイルの人は、こういう基本的なチェックが大事ですね。

Alpine LinuxでClaude Codeをインストールする方法

テキトー教師テキトー教師DotAI 認定講師
Alpine Linuxは少し特殊で、ここが一番躓きやすいポイントだと思います。Alpine独自の手順が必要です。
室谷室谷代表取締役
Alpineはmusl libcを使っているんですよね。通常のLinuxがglibcを使っているのに対して。

Claude Codeのネイティブバイナリはデフォルトでglibc向けにビルドされているので、Alpine用の追加設定が必要になります。
テキトー教師テキトー教師DotAI 認定講師
整理するとこういう手順が必要です。
bash
# Step 1: 必要な依存パッケージをインストール
apk add libgcc libstdc++ ripgrep

# Step 2: ネイティブインストーラーを実行
curl -fsSL https://claude.ai/install.sh | bash

# Step 3: settings.jsonにUSE_BUILTIN_RIPGREP設定を追加
mkdir -p ~/.config/claude
cat > ~/.config/claude/settings.json << 'SETTINGS'
{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}
SETTINGS

# Step 4: インストール確認
claude --version
室谷室谷代表取締役
libgccとlibstdc++は動作に必要で、ripgrepはClaude Codeが内部でファイル検索に使っているツールです。AlpineではClaude Code内蔵のripgrepが使えないので、システムのものを使うようUSE_BUILTIN_RIPGREP=0で設定する必要があります。
テキトー教師テキトー教師DotAI 認定講師
Dockerで軽量イメージとしてAlpineを使っている場合も同じ手順です。DockerfileにAlpine用の手順を入れておきましょう。
dockerfile
FROM alpine:3.19

# 依存パッケージのインストール
RUN apk add --no-cache libgcc libstdc++ ripgrep curl bash

# Claude Codeのインストール
RUN curl -fsSL https://claude.ai/install.sh | bash

# settings.jsonの設定
RUN mkdir -p /root/.config/claude && \
    echo '{"env":{"USE_BUILTIN_RIPGREP":"0"}}' > /root/.config/claude/settings.json

ENV PATH="/root/.local/bin:$PATH"
室谷室谷代表取締役
Dockerでの活用シーン、増えてきていますよね。CI/CDパイプラインの中でClaude Codeを動かすみたいな使い方が出てきています。

npmからネイティブインストールへの移行方法

テキトー教師テキトー教師DotAI 認定講師
以前npmでClaude Codeをインストールしていた人向けの話です。npmインストールは非推奨になりましたが、古い記事を参考にして今もnpmで使い続けている人がいます。
室谷室谷代表取締役
移行は難しくないんですよね。こんな手順でできます。
bash
# Step 1: ネイティブバイナリをインストール
curl -fsSL https://claude.ai/install.sh | bash

# Step 2: 古いnpmパッケージを削除
npm uninstall -g @anthropic-ai/claude-code
テキトー教師テキトー教師DotAI 認定講師
移行すべき理由は3つです。ネイティブインストールはnodeやnpmへの依存がないこと、起動が速いこと、バックグラウンドで自動更新されることです。
室谷室谷代表取締役
自動更新が地味に便利なんですよね。npmだとnpm install -g @anthropic-ai/claude-codeを手動でやり直さないといけなかったので。

ネイティブだとバックグラウンドで最新版に更新されていきます。

Claude Code Linuxのアップデート方法

室谷室谷代表取締役
アップデートはネイティブインストールであればほぼ自動です。Claude Codeは起動時とバックグラウンドで定期的にアップデートを確認しています。
テキトー教師テキトー教師DotAI 認定講師
手動で即座に適用したい場合はclaude updateコマンドが使えます。
bash
# 手動アップデート
claude update

# 現在のバージョン確認
claude --version
室谷室谷代表取締役
リリースチャンネルも選べます。デフォルトのlatestだと新機能がすぐ来ますが、安定性重視ならstableチャンネルにしておくと一週間程度の遅延で届きます。
json
{
  "autoUpdatesChannel": "stable"
}
テキトー教師テキトー教師DotAI 認定講師
本番環境で動かしているサーバーはstableにしておく方が安心ですね。開発環境はlatestで最新機能を試す、という使い分けをしている受講生さんが多いです。
室谷室谷代表取締役
自動更新を完全に止めたい場合はDISABLE_AUTOUPDATERを設定します。
json
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Linux特有のトラブルシューティング

Claude Code公式トラブルシューティングページ(権限・認証エラーの対処法)(公式サイトより)

室谷室谷代表取締役
Linux環境特有のエラーをまとめておきましょう。これ、めちゃくちゃ重要なセクションです。
テキトー教師テキトー教師DotAI 認定講師
講座でも「インストールできない」という相談の8割がここに該当します。

command not found: claude

テキトー教師テキトー教師DotAI 認定講師
一番多いエラーです。インストールは成功しているのにclaudeコマンドが見つからないというパターンですね。
室谷室谷代表取締役
PATHの問題です。~/.local/binがPATHに含まれていないことが原因です。
bash
# PATHに含まれているか確認
echo $PATH | tr ':' '\n' | grep local/bin

# 含まれていなければBashに追加
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 設定後に再確認
claude --version

インストール中にKilledが表示される(メモリ不足)

室谷室谷代表取締役
VPSやクラウドサーバーでよく起きるエラーです。Claude Codeのインストールに4GB以上のRAMが必要なんですが、それ以下の環境だとOOMキラーに終了させられてしまいます。
テキトー教師テキトー教師DotAI 認定講師
スワップを追加することで対処できます。2GBのスワップファイルを作る手順です。
bash
# 2GBのスワップファイルを作成
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# その後インストールを再試行
curl -fsSL https://claude.ai/install.sh | bash
室谷室谷代表取締役
安価なVPS(メモリ1-2GBのもの)で試している場合はほぼこれが原因ですね。

musl/glibcミスマッチエラー

テキトー教師テキトー教師DotAI 認定講師
libstdc++.so.6: No such file or directoryというエラーです。これはglibc系のシステムなのにmusl向けのバイナリがダウンロードされてしまった場合に起きます。
室谷室谷代表取締役
まず自分のシステムがどちらかを確認します。
bash
# glibcかmuslかを確認
ldd /bin/ls | head -1

# linux-vdso.so や /lib/x86_64-linux-gnu/ が出ればglibc
# muslと出ればmusl(Alpine等)
テキトー教師テキトー教師DotAI 認定講師
glibc系なのにmuslバイナリが入ってしまった場合は、インストール先を削除して再インストールします。
bash
# 既存のインストールを削除
rm -f ~/.local/bin/claude

# 再インストール
curl -fsSL https://claude.ai/install.sh | bash

Illegal instruction エラー

室谷室谷代表取締役
CPUアーキテクチャが一致していない場合に起きます。x86_64向けのバイナリをARM系のサーバーで動かそうとしている場合ですね。
テキトー教師テキトー教師DotAI 認定講師
まず自分のアーキテクチャを確認しましょう。
bash
# アーキテクチャ確認
uname -m
# x86_64 → 64bit Intel/AMD
# aarch64 → ARM64
室谷室谷代表取締役
ARM64環境(AWSのGravitonインスタンス等)でこのエラーが出た場合は、GitHubのissueで報告してください。

ネットワークエラー(企業プロキシ環境)

テキトー教師テキトー教師DotAI 認定講師
企業のサーバーで使う場合に出やすいエラーです。インストーラーはstorage.googleapis.comからバイナリをダウンロードするんですが、社内プロキシでブロックされることがあります。
室谷室谷代表取締役
プロキシ環境変数を設定してからインストールします。
bash
# プロキシ設定してインストール
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
テキトー教師テキトー教師DotAI 認定講師
プロキシのURLは社内のIT部門に確認してください、というのが標準的な対応ですね。

Claude Code LinuxでのIDE連携

室谷室谷代表取締役
インストールが完了したら、次はエディタとの連携です。LinuxではVS CodeとJetBrainsが対応しています。
テキトー教師テキトー教師DotAI 認定講師
VS Codeでの連携は特に設定不要ですね。Claude Codeの拡張機能をインストールするだけで使えます。
室谷室谷代表取締役
VS Codeを使っている場合は、拡張機能マーケットプレイスで「Claude Code」を検索してインストールするだけです。その後、VS CodeのターミナルでClaude Codeを起動すると、IDE統合が有効になります。
テキトー教師テキトー教師DotAI 認定講師
JetBrains系(IntelliJ IDEA、PyCharm等)も公式プラグインがあります。ただ、Linuxでは少し設定が必要なケースがあって・・・
室谷室谷代表取締役
JetBrainsのIDEを使っている場合に「IDE not detected」エラーが出ることがあります。これはJetBrainsが起動していない状態でClaude Codeを使おうとしたか、パス設定の問題です。

JetBrainsのIDEを先に起動してからClaude Codeを使うと解決することがほとんどです。
テキトー教師テキトー教師DotAI 認定講師
VimやNeovimを使っている人もLinuxには多いですよね。Claude Code用のNeovimプラグインも出ているので、ターミナルから直接使えます。

LinuxサーバーでClaude Codeを本番運用する

室谷室谷代表取締役
個人の開発環境だけでなく、チームのLinuxサーバーでClaude Codeを使う場合の話もしておきましょう。MYUUUでも開発サーバーにClaude Codeを入れていて、チームメンバーがSSH接続して使えるようにしています。
テキトー教師テキトー教師DotAI 認定講師
マルチユーザー環境での設定、これは意外と見落としがちですよね。各ユーザーが個別にインストールするのか、システム全体にインストールするのかで手順が変わります。
室谷室谷代表取締役
基本は各ユーザーが~/.local/binに個別インストールする形が推奨です。システムワイドにインストールすると、権限管理が複雑になりますし、各ユーザーが異なるバージョンを使いたい場合にも対応しにくくなります。
テキトー教師テキトー教師DotAI 認定講師
チームで使う場合は認証方法も統一しておいた方がいいですね。APIキーを使う場合は、環境変数をユーザーの.profileや.bashrcに設定する方法が一般的です。
bash
# 各ユーザーの.bashrcに追記
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc
室谷室谷代表取締役
チームで同じAPIキーを使う場合は、使用量の管理に注意してください。Anthropicのコンソールで使用量を確認できるので、定期的にチェックする習慣をつけておくといいですね。
テキトー教師テキトー教師DotAI 認定講師
Teamプランを使えばチームメンバー全員を一つのアカウントで管理できます。コスト管理が楽になるので、5人以上で使う場合はTeamプランを検討してみてください。

Claude Code Linuxのアンインストール方法

室谷室谷代表取締役
最後にアンインストールの方法も確認しておきましょう。
テキトー教師テキトー教師DotAI 認定講師
ネイティブインストールのアンインストールはシンプルです。
bash
# ネイティブインストールのアンインストール
rm -f ~/.local/bin/claude

# 設定ファイルも削除したい場合
rm -rf ~/.config/claude
rm -rf ~/.claude
室谷室谷代表取締役
npmでインストールしていた場合は別のコマンドが必要です。
bash
# npmインストールのアンインストール
npm uninstall -g @anthropic-ai/claude-code
テキトー教師テキトー教師DotAI 認定講師
設定ファイル(.config/claude/)には認証情報やCLAUDE.mdの設定が入っています。完全にリセットしたい場合は削除、設定を引き継ぎたい場合は残しておく形で大丈夫です。

まとめ

室谷室谷代表取締役
Claude CodeのLinuxインストール、整理しておきましょう。Ubuntu/Debianはネイティブインストーラー一行で完結、Alpine Linuxは依存パッケージを入れてからという手順の違いが最重要ポイントです。

あとは「古いnpmインストールは使わない」という点を覚えておければ、ほぼ対応できます。
テキトー教師テキトー教師DotAI 認定講師
トラブルシューティングで一番多いのが「command not found」のPATH問題です。インストールが終わったらまずclaude --versionを実行して確認、エラーが出たらPATH設定を見直すという手順を身につけておくと、どんな環境でも対応できます。
室谷室谷代表取締役
LinuxでClaude Codeが動くようになると、CI/CDパイプラインへの組み込みやクラウドサーバーでの自動化も見えてきます。個人の開発環境だけでなく、チームの開発フローに組み込む入口になるので、ぜひ使い込んでみてください。
テキトー教師テキトー教師DotAI 認定講師
.AIでもLinux環境でClaude Codeを活用するコンテンツを増やしていく予定です。引き続きよろしくお願いします。

よくある質問(FAQ)

Q: Claude Code LinuxはRaspberry Piで使えますか?

室谷室谷代表取締役
Raspberry Pi(ARM64)の場合、公式には対応アーキテクチャとしてリストされていないため、正式サポートの範囲外です。Illegal instructionエラーが出る場合はアーキテクチャの不一致が原因のことが多いです。

Q: claude code linux installでnpmとネイティブのどちらが速いですか?

テキトー教師テキトー教師DotAI 認定講師
ネイティブインストールの方が圧倒的に速いです。npmインストールはNode.jsのオーバーヘッドがあるのに対して、ネイティブはコンパイル済みバイナリが直接実行されるため、起動速度も動作速度も上です。

今はnpmは非推奨なので、新規にはネイティブ一択です。

Q: LinuxサーバーでGUIなしで認証できますか?

室谷室谷代表取締役
できます。ヘッドレス環境ではclaudeコマンドを初回実行した際にURLが表示されるので、それをローカルPCのブラウザで開いて認証します。

またはAPIキーをANTHROPIC_API_KEY環境変数で設定する方法も使えます。

Q: claude code linux updateはどうやりますか?

テキトー教師テキトー教師DotAI 認定講師
ネイティブインストールは自動更新されますが、手動で即座に更新したい場合はclaude updateコマンドを実行します。バージョン確認はclaude --versionです。

Q: Ubuntu 18.04では動きますか?

室谷室谷代表取締役
公式サポートはUbuntu 20.04以上です。18.04はEOL(サポート終了)で動作保証外なので、20.04以上へのアップグレードを推奨します。

Related

関連記事

New Articles

新着記事

ガイド

Grokの読み方は「グロック」か「グロク」か?公式回答と会社名・料金の最新事情

2026年11月18日
室谷テキトー教師
ガイド

GoogleのAIモードとAIによる概要の消し方|公式オフ機能の有無とPC・スマホの回避策

2026年11月18日
室谷テキトー教師
ガイド

Azure OpenAI Serviceとは?料金・モデル一覧・データの扱いを最新情報で整理

2026年11月18日
室谷テキトー教師
ニュース

Perplexityの「Orchestrator API」とは?45以上のモデルを1つのAPIキーに統合

2026年11月18日
室谷テキトー教師
ニュース

Microsoftの「Copilot Workspaces」とは?人とエージェントが協働する新体験

2026年11月18日
室谷テキトー教師
ガイド

Geminiのファミリープランは何人まで?Google AI Proを家族で割る料金と設定の手順

2026年11月18日
室谷テキトー教師
ニュース

Microsoft MAIとは?Ignite 2026で発表の7モデルと料金

2026年11月18日
室谷テキトー教師
ニュース

Replit Missionsとは?エージェントスウォームで目標達成型の自律実行

2026年11月18日
室谷テキトー教師
ニュース

Copilot Fusion Maxとは?Terminal-Bench 4.1首位の自動モデル選択

2026年11月18日
室谷テキトー教師
ニュース

Googleの「Gemini Tasks」とは?日本でも無料開始、Gemini 4 Hydrogen搭載

2026年11月18日
室谷テキトー教師

Join

AIプレナーになる。

入会は審査制です。いまの事業と、AIで何を動かしたいのかを聞かせてください。

参加を申請する