こんにちは！この記事では、Amazon Linux 2023環境にClaude Codeをインストールする方法を詳しく解説します。インストール中に発生する可能性のある問題とその解決策も含めていますので、スムーズにセットアップできるはずです。
## 前提条件
- Amazon Linux 2023環境
- インターネット接続
- 基本的なLinuxコマンドの知識
## 1. NodeJSのインストール
Claude Codeを使用するには、NodeJS 18以上が必要です。Amazon Linux 2023では、以下のコマンドでNodeJS 20をインストールできます：
```bash
sudo dnf install -y nodejs20 nodejs20-npm
```
インストールが完了したら、バージョンを確認しましょう：
```bash
node -v && npm -v
```
以下のような出力が表示されるはずです：
```
v20.19.2
10.8.2
```
バージョン番号は環境によって異なる場合があります。
## 2. Claude Codeのインストール
### 2.1 最初の試み（エラーケース）
通常、npmパッケージをグローバルにインストールするには、以下のコマンドを使用します：
```bash
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の設定を変更して、グローバルパッケージをユーザーのホームディレクトリにインストールするようにします：
```bash
# 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のインストール（成功ケース）
設定を変更した後、再度インストールを試みます：
```bash
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がインストールされたことを確認するために、バージョンを確認します：
```bash
claude --version
```
以下のような出力が表示されるはずです：
```
1.0.31 (Claude Code)
```
> **注意**: コマンド名は`claude-code`ではなく`claude`です。
## 4. トラブルシューティング
### 4.1 コマンドが見つからない場合
`claude --version`を実行して「command not found」エラーが発生した場合は、以下の手順を試してください：
1. PATHが正しく設定されているか確認：
```bash
echo $PATH
```
`~/.npm-global/bin`がPATHに含まれているか確認してください。
2. シンボリックリンクが作成されているか確認：
```bash
ls -la ~/.npm-global/bin/
```
`claude`というシンボリックリンクが存在するはずです。
3. 新しいターミナルセッションを開始するか、以下のコマンドでPATHを再読み込み：
```bash
source ~/.bashrc
```
### 4.2 その他の問題
- **依存関係のエラー**: NodeJSのバージョンが古い場合は、最新バージョンにアップデートしてください。
- **ネットワークエラー**: インターネット接続を確認してください。
- **ディスク容量不足**: 十分なディスク容量があることを確認してください。
## まとめ
この記事では、Amazon Linux 2023環境にClaude Codeをインストールする方法を解説しました。主なポイントは以下の通りです：
1. NodeJS 20とnpmをインストール
2. npmのグローバルパッケージをユーザーディレクトリにインストールするよう設定
3. Claude Codeをインストール
4. `claude`コマンドで動作確認
これらの手順に従えば、権限の問題を回避しながら、Claude Codeを正常にインストールできるはずです。
何か質問や問題がありましたら、コメント欄でお知らせください。
## 参考リンク
- [Claude Code公式ドキュメント](https://docs.anthropic.com/claude/docs/claude-code)
- [npm公式ドキュメント - グローバルパッケージの設定](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally)