インストール - Claude Code

概要

Claude Codeは、Anthropicが提供するターミナルベースのAIコーディングアシスタントであり、
開発者がコマンドラインから直接Claudeの強力なAI機能を利用できるツールである。

Claude Codeは、自然言語コマンドを通じて以下日示す機能を提供する。

• コードベース全体の理解と解析
• ファイルの編集とバグ修正
• コードアーキテクチャに関する詳細な質問への回答
• テスト、リンティング、その他のコマンドの実行と修正
• Gitワークフロー (マージコンフリクトの解決やPR作成等) の管理

Claude Codeは、Claudeモデルファミリー (Claude Sonnet および Claude Opus) を使用しており、高度な推論能力を持つコーディングタスクに対応している。

動作環境

Claude Codeは、以下に示すLinuxディストリビューションで動作する。

• Ubuntu 20.04 LTS以降
• Debian 10以降
• Fedora 35以降
• CentOS Stream 8以降、RHEL 8以降
• SUSE 15.3以降 または Tumbleweed
• その他のLinuxディストリビューション

必要な環境

Claude Codeのインストールには、以下のいずれかが必要である。

• Node.js 18.0以降 (npm経由でインストールする場合)
• Nativeインストーラ (Node.jsは不要、推奨方法)

認証方法

Claude Codeを使用するには、以下のいずれかの認証方法が必要である。

• Claude Console: Anthropic Consoleアカウントを使用してOAuth認証を行う。(デフォルトオプション)
• Claude App (Pro または Maxプラン)

  Claude Pro または Maxサブスクリプション (月額$20 または $100)

• API Key

  Anthropic Console APIキー (従量課金制)

※注意
Anthropic APIは従量課金制であり、頻繁に使用すると高額になる可能性がある。
定期的にClaude Codeを使用する開発者には、固定月額料金で高い使用制限が設定されているClaude Maxサブスクリプションが推奨される。

SUSEへのインストール

方法 1 : Nativeインストーラーを使用 (推奨)

Nativeインストーラのインストール

Nativeインストーラは、Node.jsを必要とせず、自動更新機能が安定している。

インストールスクリプトを実行する。

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

特定のバージョンをインストールする場合は、以下に示すようにバージョンを指定する。

# 最新版をインストール
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 特定のバージョンをインストール
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

インストールが完了した後、バージョンを確認する。

claude --version

Claude Codeの起動と認証

プロジェクトディレクトリに移動し、Claude Codeを起動する。

cd /path/to/your-project
claude

初回起動時に認証プロセスが開始されるので、以下に示す手順で認証を完了する。

1. 画面の指示に従い、希望するテキストスタイルを選択する。
2. [Enter]キーを押下して、Anthropic Consoleアカウントにログインする。
3. ブラウザが自動的に開くので、メールアドレスまたはGoogleアカウントでログインする。
4. アカウントタイプを選択する。
5. [Authorize]ボタンを押下して、APIキーを生成する。

認証が完了すると、Claude Codeのプロンプトが表示され、使用可能になる。

動作確認

Claude Codeが正常に動作しているかどうかを確認する。

claude doctor

このコマンドは、インストールタイプとバージョンを表示し、問題がないかを確認する。

方法2 : NVMとnpmを使用

NVMのインストール

NVM (Node Version Manager) を使用すると、複数のNode.jsバージョンを管理できる。

NVMインストールスクリプトをダウンロードして実行する。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

シェルの設定ファイルを再読み込みする。

Node.js LTSのインストール

NVMを使用して、Node.js LTS (Long Term Support) をインストールする。

nvm install --lts
nvm use --lts

インストールされたNode.jsとnpmのバージョンを確認する。

node --version
npm --version

npmグローバルディレクトリの設定

権限エラーを回避するため、npmのグローバルパッケージ用のディレクトリを設定する。

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

~/.profileファイル等に環境変数 PATH の設定を追加する。

 export PATH="/<Node.jsのインストールディレクトリ>/bin:$PATH"

Claude Codeのインストール

npmを使用してClaude Codeをインストールする。

npm install @anthropic-ai/claude-code

※重要
スーパーユーザ権限を使用すると権限とセキュリティの問題が発生する可能性があるため、使用しないこと。

インストールされたバージョンを確認する。

claude --version

Claude Codeの起動と認証

プロジェクトディレクトリに移動して、Claude Codeを起動する。

cd /path/to/your-project
claude

初回起動時に認証プロセスが開始される。画面の指示に従って認証を完了する。

方法3 : zypperとnpmを使用

システムの更新

まず、システムパッケージを更新する。

sudo zypper refresh
sudo zypper update

Node.jsとnpmのインストール

パッケージ管理システムからNode.jsとnpmをインストールする。

# SUSE 15.6の場合
sudo zypper install nodejs22 npm22

もし、パッケージ管理システムに古いNode.jsとnpmしか存在しない場合は、NVMの使用を推奨する。

インストールされたバージョンを確認する。

node --version
npm --version

npmグローバルディレクトリの設定

権限エラーを回避するため、npmのグローバルパッケージ用のディレクトリを設定する。

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

 export PATH="$HOME/.npm-global/bin:$PATH"

Claude Codeのインストール

npm install @anthropic-ai/claude-code

バージョンを確認する。

claude --version

Claude Codeの起動と認証

cd /path/to/your-project
claude

画面の指示に従って認証を完了する。

RHELへのインストール

方法1 : Nativeインストーラを使用 (推奨)

Nativeインストーラーのインストール

Nativeインストーラは、Node.jsを必要とせず、最も安定した方法である。

インストールスクリプトを実行する。

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

# 最新版をインストールする場合
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 特定のバージョンをインストールする場合
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

インストールが完了した後、バージョンを確認する。

claude --version

Claude Codeの起動と認証

プロジェクトディレクトリに移動して、Claude Codeを起動する。

cd /path/to/your-project
claude

初回起動時に認証プロセスが開始される。
画面の指示に従って認証を完了する。

動作確認

インストールの状態を確認する。

claude doctor

方法2 : dnfモジュールとnpmを使用

システムの更新

まず、システムを最新の状態に更新する。

sudo dnf update

EPELリポジトリの有効化 (必要に応じて)

EPELリポジトリを有効にする。

# RHEL 10の場合
sudo subscription-manager repos --enable codeready-builder-for-rhel-10-$(arch)-rpms
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm

# RHEL 9の場合
sudo subscription-manager repos --enable codeready-builder-for-rhel-9-$(arch)-rpms
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

利用可能なNode.jsモジュールの確認

RHELで利用可能なNode.jsモジュールを確認する。

dnf module list nodejs

# 出力例:

Name    Stream  Profiles                          Summary
nodejs  18      common [d], development, minimal, s2i  Javascript runtime
nodejs  20      common [d], development, minimal, s2i  Javascript runtime

Node.jsモジュールのインストール

Node.js LTSをインストールする。

# Node.js LTS 20の場合
sudo dnf module install nodejs:22

# Node.js LTS 20の場合
sudo dnf module install nodejs:20

※注意
ストリームをインストール時に指定すると、自動的に有効化されるため、事前に手動で有効化する必要はない。

インストールされたNode.jsとnpmのバージョンを確認する。

node --version
npm --version

npmグローバルディレクトリの設定

権限エラーを回避するため、npmのグローバルパッケージ用のディレクトリを設定する。

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

~/.profileファイル等に環境変数 PATH を追加する。

 export PATH="/<Node.jsのインストールディレクトリ>/bin:$PATH"

Claude Codeのインストール

npmを使用してClaude Codeをグローバルにインストールする。

npm install @anthropic-ai/claude-code

※重要
スーパーユーザ権限を使用すると、セキュリティの問題を引き起こす可能性があるため使用しないこと。

インストールされたバージョンを確認する。

claude --version

Claude Codeの起動と認証

プロジェクトディレクトリに移動して、Claude Codeを起動する。

cd /path/to/your-project
claude

初回起動時に認証プロセスが開始される。
画面の指示に従って認証を完了する。

方法3 : NodeSourceリポジトリを使用

NodeSourceリポジトリの追加

NodeSourceは、最新かつ安定したNode.jsビルドを提供するコミュニティ管理のリポジトリである。

Node.js LTSのセットアップスクリプトをダウンロードして実行する。

# Node.js 22をインストールする場合
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -

# Node.js 20をインストールする場合
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -

Node.jsとnpmのインストール

sudo dnf install nodejs

インストールされたバージョンを確認する。

node --version
npm --version

npmグローバルディレクトリの設定

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

 export PATH="$HOME/.npm-global/bin:$PATH"

Claude Codeのインストール

npm install @anthropic-ai/claude-code

バージョンを確認する。

claude --version

Claude Codeの起動と認証

cd /path/to/your-project
claude

画面の指示に従って認証を完了する。

方法4 : NVMを使用

NVMのインストール

NVM (Node Version Manager) を使用すると、複数のNode.jsバージョンを管理できる。

NVMインストールスクリプトをダウンロードして実行する。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

シェルの設定を再読み込みする。

Node.js LTSのインストール

nvm install --lts
nvm use --lts

インストールされたバージョンを確認する。

node --version
npm --version

npmグローバルディレクトリの設定

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

 export PATH="$HOME/.npm-global/bin:$PATH"

Claude Codeのインストール

npm install @anthropic-ai/claude-code

バージョンを確認する。

claude --version

Claude Codeの起動と認証

cd /path/to/your-project
claude

画面の指示に従って認証を完了する。

アンインストール

npmでインストールした場合

Claude Codeをアンインストールする。

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

Nativeバイナリでインストールした場合

バイナリとシンボリックリンクを削除する。

rm -f ~/.local/bin/claude
rm -f ~/.claude/bin/claude

Claude Codeプログラムディレクトリを削除する。

rm -rf ~/.claude

設定ファイルの削除

ユーザー設定とキャッシュデータを削除する。

rm -rf ~/.claude
rm -f ~/.claude.json

プロジェクト固有の設定を削除する (プロジェクトディレクトリから実行）。

rm -rf .claude
rm -f .mcp.json

環境変数による設定

API Keyの設定

環境変数を使用して、APIキーを設定することもできる。

 # 一時的に設定する場合
 export ANTHROPIC_API_KEY="<APIキー>"
 
 # 永続的に設定する場合
 export ANTHROPIC_API_KEY="<APIキー>"

モデルの指定

Claude Codeは複数のモデルをサポートしている。
これは、環境変数でモデルを指定することができる。

 # Claude Sonnet 4.5を使用する場合
 export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
 
 # Claude 4 Opusを使用する場合
 export ANTHROPIC_MODEL="claude-opus-4-20250514"

自動更新の無効化

デフォルトでは、Claude Codeは自動的に更新される。

これを無効にする場合は、~/.profileファイル等に以下に示す環境変数を追加する。

 export DISABLE_AUTOUPDATER=1
 
 # 永続的に設定する場合
 export DISABLE_AUTOUPDATER=1

Claude Codeの使用方法

Claude Codeの起動

プロジェクトディレクトリに移動してClaude Codeを起動する。

cd /path/to/your-project
claude

基本的なコマンド

Claude Codeが起動すると対話型プロンプト (REPL) が表示されて、以下に示すようなコマンドを使用できる。

セッション管理

• 利用可能なコマンドを表示する。

  /help

• 会話履歴をクリアする。

  /clear

• Claude Codeを終了する。

  /exit

または

• /quit

または、[Ctrl] + [D]キーを同時押下する。

• 前の会話を続ける。

  /continue

プロジェクト初期化と設定

• プロジェクトガイド (CLAUDE.md) を生成する。

  /init

• 設定インターフェースを開く。

  /config

• プロジェクトメモリファイルを編集する。

  /memory

• システムの健全性を確認する。

  /doctor

• 追加の作業ディレクトリを追加する。

  /add-dir

コンテキストとトークン管理

• 現在のコンテキスト使用状況を色付きグリッドで表示する。

  /context

• 会話履歴を圧縮する(オプションで焦点を当てる指示を追加可能)。

  /compact

または

• /compact focus on authentication logic

• トークン使用統計を表示する。

  /cost

高度な機能

• カスタムAIサブエージェントを管理する。

  /agents

• フック設定を管理する。(ツールイベント用)

  /hooks

• バックグラウンドタスクをリスト表示・管理する。

  /bashes

• MCPサーバの状態を表示・設定する。

  /mcp

• IDE統合を管理してステータスを表示する。

  /ide

その他のユーティリティ

• バージョン情報と接続状態を表示する。

  /status

• 現在の会話をファイルまたはクリップボードにエクスポートする。

  /export [filename]

• Anthropicアカウントを切り替える。

  /login

• バグを報告する(会話をAnthropicに送信)。

  /bug

プロジェクトの理解

Claude Codeは、プロジェクトのファイル構造の認識、使用されている技術の分析、プロジェクト固有の質問に答えることができる。

質問例

• プロジェクトについて質問する。

  what does this project do?

• このPythonスクリプトは何をするのか?

  what does @script.py do?

• 特定のモジュールのエラーを修正する。

  fix the type errors in auth module

• 変更をコミットする。

  commit my changes with a descriptive message

• 特定の機能を実装する。

  implement a user authentication system with JWT tokens

• コードをデバッグする。

  debug this error: "TypeError: Cannot read property 'id' of undefined" @./src/user-service.js

コマンドラインフラグ

Claude Codeは起動時に様々なフラグをサポートしている。

• 初回プロンプト付きで起動する。

  claude "help me set up a Kubernetes deployment"

• プリントモード(-p)で一度だけクエリして終了する。

  claude -p "analyze the database schema in this project"

• 前の会話を続ける。

  claude -c

• 特定のセッションIDで再開する。

  claude -r session-id

• 標準入力からコンテンツを処理する。

  cat application.log | claude -p "identify error patterns"

• モデルを指定する。

  claude --model sonnet

または

• claude --model opus

• 追加の作業ディレクトリを追加する。

  claude --add-dir ../apps ../lib

• 最大ターン数を制限する。

  claude --max-turns 5 "focused code review"

• JSON形式で出力する。

  claude -p "generate API documentation" --output-format json

カスタムスラッシュコマンド

Claude Codeでは、頻繁に使用するプロンプトをMarkdownファイルとして定義できる。

プロジェクト固有のコマンド

プロジェクト内のチーム全員が使用できるコマンドを作成する。

mkdir -p .claude/commands
echo "Analyze this code for performance issues and suggest optimizations:" > .claude/commands/optimize.md

これにより /optimize コマンドが利用可能になる。

個人用コマンド

すべてのプロジェクトで使用できる個人用コマンドを作成する。

mkdir -p ~/.claude/commands
echo "Review this code for security vulnerabilities:" > ~/.claude/commands/security-review.md

これにより /security-review コマンドが利用可能になる。

引数付きコマンド

コマンドファイル内で $ARGUMENTS 変数を使用することで、ユーザ入力を受け取ることができる。

例: .claude/commands/fix-issue.md

Find and fix issue #$ARGUMENTS. Follow these steps:
1. Understand the issue described in the ticket
2. Locate the relevant code in our codebase
3. Implement a solution
4. Add appropriate tests

使用方法:

• /fix-issue 123

MCPサーバ統合

Model Context Protocol (MCP)サーバを設定することにより、Claude Codeの機能を拡張できる。

• MCPサーバの設定を開く。

  claude mcp

• MCPサーバをリスト表示する。

  claude mcp list

• MCPサーバを追加する。

  例:

  claude mcp add github -- npx @modelcontextprotocol/server-github

  MCPサーバが設定されると、そのツールはスラッシュコマンドとして自動的に利用可能になる。

その他の便利な機能

• ファイルやディレクトリを参照する際は、@記号を使用する。

  analyze @src/auth.js

• タブキーを使用してファイル名の自動補完ができる。
  

• Escキーを押すことで、Claudeの処理を中断できる。
  

• !を使用して、シェルコマンドを直接実行できる。(会話モードをバイパス)

  !git status

トラブルシューティング

"command not found: claude" エラー

PATHが正しく設定されていない可能性がある。

 export PATH="$HOME/.local/bin:$PATH"
 
 # Nativeインストールしている場合
 export PATH="$HOME/.claude/bin:$PATH"

npm権限エラー

スーパーユーザ権限でインストールした場合、以下に示すように修正する。

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

 export PATH="/<Node.jsのインストールディレクトリ>/bin:$PATH"

その後、一般ユーザ権限でClaude Codeを再インストールする。

npm install @anthropic-ai/claude-code

古いインストールの削除

npmを削除する。

npm uninstall @anthropic-ai/claude-code

# Nativeバイナリを削除する場合
rm -rf ~/.claude/bin/claude
rm -rf ~/.local/bin/claude

# 設定ファイルを削除する場合
# ※注意 : 全ての設定が削除される
rm -rf ~/.claude
rm ~/.claude.json

Node.jsバージョンが古い場合

Claude CodeではNode.js 18以降が必要である。

まず、Node.jsのバージョンを確認する。

node --version

NVMを使用している場合、最新のLTSバージョンに更新する。

nvm install --lts
nvm use --lts

認証ループの問題

Webブラウザが自動的に開かない場合、ターミナルに表示されるURLを手動でコピーしてブラウザに貼り付ける。

参考リンク

• Claude Code公式ドキュメント
• Claude AI公式ドキュメント
• Anthropic Console
• Claude CodeのGitHubリポジトリ