こんにちは！この記事では、Amazon Linux 2023環境にClaude Codeをインストールする方法を詳しく解説します。インストール中に発生する可能性のある問題とその解決策も含めていますので、スムーズにセットアップできるはずです。

前提条件

Amazon Linux 2023環境
インターネット接続
基本的なLinuxコマンドの知識

1. NodeJSのインストール

Claude Codeを使用するには、NodeJS 18以上が必要です。Amazon Linux 2023では、以下のコマンドでNodeJS 20をインストールできます：

sudo dnf install -y nodejs20 nodejs20-npm

インストールが完了したら、バージョンを確認しましょう：

node -v && npm -v

以下のような出力が表示されるはずです：

v20.19.2
10.8.2

バージョン番号は環境によって異なる場合があります。

2. Claude Codeのインストール

2.1 最初の試み（エラーケース）

通常、npmパッケージをグローバルにインストールするには、以下のコマンドを使用します：

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

しかし、このコマンドを実行すると、以下のようなエラーが発生する可能性があります：

npm error code EACCES
npm error syscall mkdir
npm error path /usr/lib/nodejs20/lib/node_modules/@anthropic-ai
npm error errno -13
npm error Error: EACCES: permission denied, mkdir '/usr/lib/nodejs20/lib/node_modules/@anthropic-ai'
...
npm error The operation was rejected by your operating system.
npm error It is likely you do not have the permissions to access this file as the current user

これは、システムディレクトリに書き込む権限がないために発生するエラーです。

注意: sudo npm install -gを使用することは推奨されていません。権限の問題やセキュリティリスクを引き起こす可能性があります。

2.2 解決策：npmのグローバルパッケージをユーザーディレクトリにインストールする

この問題を解決するには、npmの設定を変更して、グローバルパッケージをユーザーのホームディレクトリにインストールするようにします：

# npmのグローバルパッケージをインストールするディレクトリを作成
mkdir -p ~/.npm-global

# npmの設定を変更
npm config set prefix '~/.npm-global'

# PATHに追加
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

2.3 Claude Codeのインストール（成功ケース）

設定を変更した後、再度インストールを試みます：

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

今回は成功するはずです：

added 3 packages in 6s

2 packages are looking for funding
  run `npm fund` for details

3. インストールの確認

Claude Codeがインストールされたことを確認するために、バージョンを確認します：

claude --version

以下のような出力が表示されるはずです：

1.0.31 (Claude Code)

注意: コマンド名はclaude-codeではなくclaudeです。

4. トラブルシューティング

4.1 コマンドが見つからない場合

claude --versionを実行して「command not found」エラーが発生した場合は、以下の手順を試してください：

PATHが正しく設定されているか確認：

echo $PATH

~/.npm-global/binがPATHに含まれているか確認してください。

シンボリックリンクが作成されているか確認：

ls -la ~/.npm-global/bin/

claudeというシンボリックリンクが存在するはずです。

新しいターミナルセッションを開始するか、以下のコマンドでPATHを再読み込み：

source ~/.bashrc

4.2 その他の問題

依存関係のエラー: NodeJSのバージョンが古い場合は、最新バージョンにアップデートしてください。
ネットワークエラー: インターネット接続を確認してください。
ディスク容量不足: 十分なディスク容量があることを確認してください。

まとめ

この記事では、Amazon Linux 2023環境にClaude Codeをインストールする方法を解説しました。主なポイントは以下の通りです：

NodeJS 20とnpmをインストール
npmのグローバルパッケージをユーザーディレクトリにインストールするよう設定
Claude Codeをインストール
claudeコマンドで動作確認

これらの手順に従えば、権限の問題を回避しながら、Claude Codeを正常にインストールできるはずです。

何か質問や問題がありましたら、コメント欄でお知らせください。

参考リンク

Claude Code公式ドキュメント
npm公式ドキュメント - グローバルパッケージの設定