概要
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
初回起動時に認証プロセスが開始されるので、以下に示す手順で認証を完了する。
- 画面の指示に従い、希望するテキストスタイルを選択する。
- [Enter]キーを押下して、Anthropic Consoleアカウントにログインする。
- ブラウザが自動的に開くので、メールアドレスまたはGoogleアカウントでログインする。
- アカウントタイプを選択する。
- [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を起動する。
cd /path/to/your-project claude
基本的なコマンド
Claude Codeが起動すると対話型プロンプトが表示されて、以下に示すようなコマンドを使用できる。
- プロジェクトについて質問する。
what does this project do?
- 特定のモジュールのエラーを修正する。
fix the type errors in auth module
- 変更をコミットする。
commit my changes with a descriptive message
- プロジェクトドキュメントを生成する。
/init
- 利用可能なコマンドを表示する。
/help
- システムの健全性を確認する。
/doctor
- 会話をクリアする。
/clear
- Claude Codeを終了する。
/exit
プロジェクトの理解
Claude Codeは、プロジェクトのファイル構造の認識、使用されている技術の分析、プロジェクト固有の質問に答えることができる。
- "このPythonスクリプトは何をするのか?"
- "認証モジュールのタイプエラーを修正して"
- "説明的なメッセージで変更をコミットして"
トラブルシューティング
"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を手動でコピーしてブラウザに貼り付ける。
参考リンク