インストール - Claude Codeのソースを表示

== 概要 ==
Claude Codeは、Anthropicが提供するターミナルベースのAIコーディングアシスタントであり、<br>
開発者がコマンドラインから直接Claudeの強力なAI機能を利用できるツールである。<br>
<br>
Claude Codeは、自然言語コマンドを通じて以下日示す機能を提供する。<br>
* コードベース全体の理解と解析
* ファイルの編集とバグ修正
* コードアーキテクチャに関する詳細な質問への回答
* テスト、リンティング、その他のコマンドの実行と修正
* Gitワークフロー (マージコンフリクトの解決やPR作成等) の管理
<br>
Claude Codeは、Claudeモデルファミリー (Claude Sonnet および Claude Opus) を使用しており、高度な推論能力を持つコーディングタスクに対応している。<br>
<br><br>

== 動作環境 ==
Claude Codeは、以下に示すLinuxディストリビューションで動作する。<br>
* Ubuntu 20.04 LTS以降
* Debian 10以降
* Fedora 35以降
* CentOS Stream 8以降、RHEL 8以降
* SUSE 15.3以降 または Tumbleweed
* その他のLinuxディストリビューション
<br><br>

== 必要な環境 ==
Claude Codeのインストールには、以下のいずれかが必要である。<br>
* Node.js 18.0以降 (npm経由でインストールする場合)
* Nativeインストーラ (Node.jsは不要、推奨方法)
<br><br>

== 認証方法 ==
Claude Codeを使用するには、以下のいずれかの認証方法が必要である。<br>
* Claude Console: Anthropic Consoleアカウントを使用してOAuth認証を行う。(デフォルトオプション)
* Claude App (Pro または Maxプラン)
*: Claude Pro または Maxサブスクリプション (月額$20 または $100)
* API Key
*: Anthropic Console APIキー (従量課金制)
<br>
<u>※注意</u><br>
<u>Anthropic APIは従量課金制であり、頻繁に使用すると高額になる可能性がある。</u><br>
<u>定期的にClaude Codeを使用する開発者には、固定月額料金で高い使用制限が設定されているClaude Maxサブスクリプションが推奨される。</u><br>
<br><br>

== SUSEへのインストール ==
==== 方法 1 : Nativeインストーラーを使用 (推奨) ====
===== Nativeインストーラのインストール =====
Nativeインストーラは、Node.jsを必要とせず、自動更新機能が安定している。<br>
<br>
インストールスクリプトを実行する。<br>
 curl -fsSL https://claude.ai/install.sh | bash
<br>
特定のバージョンをインストールする場合は、以下に示すようにバージョンを指定する。<br>
 # 最新版をインストール
 curl -fsSL https://claude.ai/install.sh | bash -s latest
 
 # 特定のバージョンをインストール
 curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
<br>
インストールが完了した後、バージョンを確認する。<br>
 claude --version
<br>
===== Claude Codeの起動と認証 =====
プロジェクトディレクトリに移動し、Claude Codeを起動する。<br>
 cd /path/to/your-project
 claude
<br>
初回起動時に認証プロセスが開始されるので、以下に示す手順で認証を完了する。<br>
# 画面の指示に従い、希望するテキストスタイルを選択する。
# [Enter]キーを押下して、Anthropic Consoleアカウントにログインする。
# ブラウザが自動的に開くので、メールアドレスまたはGoogleアカウントでログインする。
# アカウントタイプを選択する。
# [Authorize]ボタンを押下して、APIキーを生成する。
<br>
認証が完了すると、Claude Codeのプロンプトが表示され、使用可能になる。<br>
<br>
===== 動作確認 =====
Claude Codeが正常に動作しているかどうかを確認する。<br>
 claude doctor
<br>
このコマンドは、インストールタイプとバージョンを表示し、問題がないかを確認する。<br>
<br>
==== 方法2 : NVMとnpmを使用 ====
===== NVMのインストール =====
NVM (Node Version Manager) を使用すると、複数のNode.jsバージョンを管理できる。<br>
<br>
NVMインストールスクリプトをダウンロードして実行する。<br>
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
<br>
シェルの設定ファイルを再読み込みする。<br>
<br>
===== Node.js LTSのインストール =====
NVMを使用して、Node.js LTS (Long Term Support) をインストールする。<br>
 nvm install --lts
 nvm use --lts
<br>
インストールされたNode.jsとnpmのバージョンを確認する。<br>
 node --version
 npm --version
<br>
===== npmグローバルディレクトリの設定 =====
権限エラーを回避するため、npmのグローバルパッケージ用のディレクトリを設定する。<br>
 mkdir -p ~/.npm-global
 npm config set prefix ~/.npm-global
<br>
~/.profileファイル等に環境変数 <code>PATH</code> の設定を追加する。<br>
 <syntaxhighlight lang="sh">
 export PATH="/<Node.jsのインストールディレクトリ>/bin:$PATH"
 </syntaxhighlight>
<br>
===== Claude Codeのインストール =====
npmを使用してClaude Codeをインストールする。<br>
 npm install @anthropic-ai/claude-code
<br>
<u>※重要</u><br>
<u>スーパーユーザ権限を使用すると権限とセキュリティの問題が発生する可能性があるため、使用しないこと。</u><br>
<br>
インストールされたバージョンを確認する。<br>
 claude --version
<br>
===== Claude Codeの起動と認証 =====
プロジェクトディレクトリに移動して、Claude Codeを起動する。<br>
 cd /path/to/your-project
 claude
<br>
初回起動時に認証プロセスが開始される。画面の指示に従って認証を完了する。<br>
<br>
==== 方法3 : zypperとnpmを使用 ====
===== システムの更新 =====
まず、システムパッケージを更新する。<br>
 sudo zypper refresh
 sudo zypper update
<br>
===== Node.jsとnpmのインストール =====
パッケージ管理システムからNode.jsとnpmをインストールする。<br>
 # SUSE 15.6の場合
 sudo zypper install nodejs22 npm22
<br>
もし、パッケージ管理システムに古いNode.jsとnpmしか存在しない場合は、NVMの使用を推奨する。<br>
<br>
インストールされたバージョンを確認する。<br>
 node --version
 npm --version
<br>
===== npmグローバルディレクトリの設定 =====
権限エラーを回避するため、npmのグローバルパッケージ用のディレクトリを設定する。<br>
 mkdir -p ~/.npm-global
 npm config set prefix ~/.npm-global
<br>
 <syntaxhighlight lang="sh">
 export PATH="$HOME/.npm-global/bin:$PATH"
 </syntaxhighlight>
<br>
===== Claude Codeのインストール =====
 npm install @anthropic-ai/claude-code
<br>
バージョンを確認する。<br>
 claude --version
<br>
===== Claude Codeの起動と認証 =====
 cd /path/to/your-project
 claude
<br>
画面の指示に従って認証を完了する。<br>
<br><br>

== RHELへのインストール ==
==== 方法1 : Nativeインストーラを使用 (推奨) ====
===== Nativeインストーラーのインストール =====
Nativeインストーラは、Node.jsを必要とせず、最も安定した方法である。<br>
<br>
インストールスクリプトを実行する。<br>
 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
<br>
インストールが完了した後、バージョンを確認する。<br>
 claude --version
<br>
===== Claude Codeの起動と認証 =====
プロジェクトディレクトリに移動して、Claude Codeを起動する。<br>
 cd /path/to/your-project
 claude
<br>
初回起動時に認証プロセスが開始される。<br>
画面の指示に従って認証を完了する。<br>
<br>
===== 動作確認 =====
インストールの状態を確認する。<br>
 claude doctor
<br>
==== 方法2 : dnfモジュールとnpmを使用 ====
===== システムの更新 =====
まず、システムを最新の状態に更新する。<br>
 sudo dnf update
<br>
===== EPELリポジトリの有効化 (必要に応じて) =====
EPELリポジトリを有効にする。<br>
 # 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
<br>
===== 利用可能なNode.jsモジュールの確認 =====
RHELで利用可能なNode.jsモジュールを確認する。<br>
 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
<br>
===== Node.jsモジュールのインストール =====
Node.js LTSをインストールする。<br>
 # Node.js LTS 20の場合
 sudo dnf module install nodejs:22
 
 # Node.js LTS 20の場合
 sudo dnf module install nodejs:20
<br>
<u>※注意</u><br>
<u>ストリームをインストール時に指定すると、自動的に有効化されるため、事前に手動で有効化する必要はない。</u><br>
<br>
インストールされたNode.jsとnpmのバージョンを確認する。<br>
 node --version
 npm --version
<br>
===== npmグローバルディレクトリの設定 =====
権限エラーを回避するため、npmのグローバルパッケージ用のディレクトリを設定する。<br>
 mkdir -p ~/.npm-global
 npm config set prefix ~/.npm-global
<br>
~/.profileファイル等に環境変数 <code>PATH</code> を追加する。<br>
 <syntaxhighlight lang="sh">
 export PATH="/<Node.jsのインストールディレクトリ>/bin:$PATH"
 </syntaxhighlight>
<br>
===== Claude Codeのインストール =====
npmを使用してClaude Codeをグローバルにインストールする。<br>
 npm install @anthropic-ai/claude-code
<br>
<u>※重要</u><br>
<u>スーパーユーザ権限を使用すると、セキュリティの問題を引き起こす可能性があるため使用しないこと。</u><br>
<br>
インストールされたバージョンを確認する。<br>
 claude --version
<br>
===== Claude Codeの起動と認証 =====
プロジェクトディレクトリに移動して、Claude Codeを起動する。<br>
 cd /path/to/your-project
 claude
<br>
初回起動時に認証プロセスが開始される。<br>
画面の指示に従って認証を完了する。<br>
<br>
==== 方法3 : NodeSourceリポジトリを使用 ====
===== NodeSourceリポジトリの追加 =====
NodeSourceは、最新かつ安定したNode.jsビルドを提供するコミュニティ管理のリポジトリである。<br>
<br>
Node.js LTSのセットアップスクリプトをダウンロードして実行する。<br>
 # 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 -
<br>
===== Node.jsとnpmのインストール =====
 sudo dnf install nodejs
<br>
インストールされたバージョンを確認する。<br>
 node --version
 npm --version
<br>
===== npmグローバルディレクトリの設定 =====
 mkdir -p ~/.npm-global
 npm config set prefix ~/.npm-global
<br>
 <syntaxhighlight lang="sh">
 export PATH="$HOME/.npm-global/bin:$PATH"
 </syntaxhighlight>
<br>
===== Claude Codeのインストール =====
 npm install @anthropic-ai/claude-code
<br>
バージョンを確認する。<br>
 claude --version
<br>
===== Claude Codeの起動と認証 =====
 cd /path/to/your-project
 claude
<br>
画面の指示に従って認証を完了する。<br>
<br>
==== 方法4 : NVMを使用 ====
===== NVMのインストール =====
NVM (Node Version Manager) を使用すると、複数のNode.jsバージョンを管理できる。<br>
<br>
NVMインストールスクリプトをダウンロードして実行する。<br>
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
<br>
シェルの設定を再読み込みする。<br>
<br>
===== Node.js LTSのインストール =====
 nvm install --lts
 nvm use --lts
<br>
インストールされたバージョンを確認する。<br>
 node --version
 npm --version
<br>
===== npmグローバルディレクトリの設定 =====
 mkdir -p ~/.npm-global
 npm config set prefix ~/.npm-global
<br>
 <syntaxhighlight lang="sh">
 export PATH="$HOME/.npm-global/bin:$PATH"
 </syntaxhighlight>
<br>
===== Claude Codeのインストール =====
 npm install @anthropic-ai/claude-code
<br>
バージョンを確認する。<br>
 claude --version
<br>
===== Claude Codeの起動と認証 =====
 cd /path/to/your-project
 claude
<br>
画面の指示に従って認証を完了する。<br>
<br><br>

== アンインストール ==
=== npmでインストールした場合 ===
Claude Codeをアンインストールする。<br>
 npm uninstall -g @anthropic-ai/claude-code
<br>
=== Nativeバイナリでインストールした場合 ===
バイナリとシンボリックリンクを削除する。<br>
 rm -f ~/.local/bin/claude
 rm -f ~/.claude/bin/claude
<br>
Claude Codeプログラムディレクトリを削除する。<br>
 rm -rf ~/.claude
<br>
=== 設定ファイルの削除 ===
ユーザー設定とキャッシュデータを削除する。<br>
 rm -rf ~/.claude
 rm -f ~/.claude.json
<br>
プロジェクト固有の設定を削除する (プロジェクトディレクトリから実行）。<br>
 rm -rf .claude
 rm -f .mcp.json
<br><br>

== 環境変数による設定 ==
==== API Keyの設定 ====
環境変数を使用して、APIキーを設定することもできる。<br>
<br>
 <syntaxhighlight lang="sh">
 # 一時的に設定する場合
 export ANTHROPIC_API_KEY="<APIキー>"
 
 # 永続的に設定する場合
 export ANTHROPIC_API_KEY="<APIキー>"
 </syntaxhighlight>
<br>
==== モデルの指定 ====
Claude Codeは複数のモデルをサポートしている。<br>
これは、環境変数でモデルを指定することができる。<br>
<br>
 <syntaxhighlight lang="sh">
 # Claude Sonnet 4.5を使用する場合
 export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
 
 # Claude 4 Opusを使用する場合
 export ANTHROPIC_MODEL="claude-opus-4-20250514"
 </syntaxhighlight>
<br>
==== 自動更新の無効化 ====
デフォルトでは、Claude Codeは自動的に更新される。<br>
<br>
これを無効にする場合は、~/.profileファイル等に以下に示す環境変数を追加する。<br>
 <syntaxhighlight lang="sh">
 export DISABLE_AUTOUPDATER=1
 
 # 永続的に設定する場合
 export DISABLE_AUTOUPDATER=1
 </syntaxhighlight>
<br><br>

== Claude Codeの使用方法 ==
==== Claude Codeの起動 ====
プロジェクトディレクトリに移動してClaude Codeを起動する。<br>
 cd /path/to/your-project
 claude
<br>
==== 基本的なコマンド ====
Claude Codeが起動すると対話型プロンプト (REPL) が表示され、以下に示すようなコマンドを使用できる。<br>
<br>
===== セッション管理 =====
* 利用可能なコマンドを表示する。
*: <pre>/help</pre>
<br>
* 会話履歴をクリアする。
*: <pre>/clear</pre>
<br>
* Claude Codeを終了する。
*: <pre>/exit</pre>
*: または
*: <pre>/quit</pre>
*: または、[Ctrl] + [D]キーを同時押下する。
<br>
* 前の会話を続ける。
*: <pre>/continue</pre>
<br>
===== プロジェクト初期化と設定 =====
* プロジェクトガイド (CLAUDE.md) を生成する。
*: <pre>/init</pre>
<br>
* 設定インターフェースを開く。
*: <pre>/config</pre>
<br>
* プロジェクトメモリファイルを編集する。
*: <pre>/memory</pre>
<br>
* システムの健全性を確認する。
*: <pre>/doctor</pre>
<br>
* 追加の作業ディレクトリを追加する。
*: <pre>/add-dir</pre>
<br>
===== コンテキストとトークン管理 =====
* 現在のコンテキスト使用状況を色付きグリッドで表示する。
*: <pre>/context</pre>
<br>
* 会話履歴を圧縮する。 (オプションで焦点を当てる指示を追加可能) 
*: <pre>/compact</pre>
*: または
*: <pre>/compact focus on authentication logic</pre>
<br>
* トークン使用統計を表示する。
*: <pre>/cost</pre>
<br>
===== 拡張思考モード (Extended Thinking)  =====
Claude Codeには、複雑な問題に対してより深く考える拡張思考機能がある。<br>
<br>
* [Tab]キーを押して拡張思考モードをオン/オフする。 (v2.0.0以降) 
*: セッション中いつでも切り替え可能。
*: 設定は次回セッション以降も引き継がれる。
*: UI上に現在の思考モード状態が表示される。
<br>
* プロンプトに思考トリガーキーワードを含める。
*: 思考レベル: <code>think</code> < <code>think hard</code> < <code>think harder</code> < <code>ultrathink</code>
*: 使用例:
*: <pre>ultrathink: この複雑なアルゴリズムの最適化方法を考えて</pre>
*: <pre>think hard about the best architecture for this microservice</pre>
<br>
* 拡張思考モードが特に有効な場合:
** 複雑な数学的問題の解決
** システムアーキテクチャの設計決定
** 多段階の推論が必要なデバッグ
** コードの最適化戦略の立案
** 複雑なリファクタリングの計画
<br>
<u>※注意</u><br>
<u>拡張思考モードはトークン消費量が増加するため、複雑な問題に対してのみ使用することを推奨する。</u><br>
<br>
===== アウトプットスタイルの設定 =====
Claude Codeでは、応答のスタイルをカスタマイズできる。<br>
<br>
* カスタムアウトプットスタイルを作成する。
*: <pre>/output-style:new</pre>
*: インタラクティブにスタイルの詳細 (説明的、簡潔、学習向け等) を指定できる。
*: 作成したスタイルは <code>~/.claude/output-styles/</code> または <code>.claude/output-styles/</code> に保存される。
<br>
* 作成したスタイルに切り替える。
*: <pre>/output-style [スタイル名]</pre>
*: 使用例:
*: <pre>/output-style performance-coach</pre>
*: <pre>/output-style explanatory</pre>
<br>
* CLAUDE.mdファイルでコーディングスタイルや規約を指定する。
*: グローバル設定: <code>~/.claude/CLAUDE.md</code>
*: プロジェクト固有設定: <code>.claude/CLAUDE.md</code>
*: 設定例:
*: <syntaxhighlight lang="md">
 ## Code Style
 - Use functional components with TypeScript
 - Prefer composition over inheritance
 - Always handle error cases explicitly
 - Follow team's ESLint configuration
 
 ## Documentation Standards
 - Add JSDoc comments for all public functions
 - Include usage examples in documentation
 - Keep comments concise and up-to-date
 </syntaxhighlight>
*: <br>
* 起動時にシステムプロンプトを追加する。
*: <pre>claude --append-system-prompt "Always respond concisely and use TypeScript for code examples"</pre>
*: この方法は、特定セッションのみに適用する場合に便利である。
<br>
===== モデル選択 =====
* 使用するモデルを対話的に選択する。
*: <pre>/model</pre>
*: インタラクティブメニューから希望のモデルを選択できる。
*: 変更は即座に有効になり、セッションを再起動する必要はない。
<br>
* 現在使用中のモデルを確認する。
*: <pre>/status</pre>
<br>
===== 高度な機能 =====
* カスタムAIサブエージェントを管理する。
*: <pre>/agents</pre>
<br>
* フック設定を管理する。 (ツールイベント用)
*: <pre>/hooks</pre>
<br>
* バックグラウンドタスクをリスト表示・管理する。
*: <pre>/bashes</pre>
<br>
* MCPサーバの状態を表示・設定する。
*: <pre>/mcp</pre>
<br>
* IDE統合を管理してステータスを表示する。
*: <pre>/ide</pre>
<br>
===== その他のユーティリティ =====
* バージョン情報と接続状態を表示する。
*: <pre>/status</pre>
<br>
* 現在の会話をファイルまたはクリップボードにエクスポートする。
*: <pre>/export [filename]</pre>
<br>
* Anthropicアカウントを切り替える。
*: <pre>/login</pre>
<br>
* バグを報告する。 (会話をAnthropicに送信) 
*: <pre>/bug</pre>
<br>
==== プロジェクトの理解 ====
Claude Codeは、プロジェクトのファイル構造の認識、使用されている技術の分析、プロジェクト固有の質問に答えることができる。<br>
<br>
===== 質問例 =====
* プロジェクトについて質問する。
*: <pre>what does this project do?</pre>
<br>
* このPythonスクリプトは何をするのか?
*: <pre>what does @script.py do?</pre>
<br>
* 特定のモジュールのエラーを修正する。
*: <pre>fix the type errors in auth module</pre>
<br>
* 変更をコミットする。
*: <pre>commit my changes with a descriptive message</pre>
<br>
* 特定の機能を実装する。
*: <pre>implement a user authentication system with JWT tokens</pre>
<br>
* コードをデバッグする。
*: <pre>debug this error: "TypeError: Cannot read property 'id' of undefined" @./src/user-service.js</pre>
<br>
==== コマンドラインフラグ ====
Claude Codeは起動時に様々なフラグをサポートしている。<br>
<br>
===== 基本的な起動オプション =====
* 初回プロンプト付きで起動する。
*: <pre>claude "help me set up a Kubernetes deployment"</pre>
<br>
* プリントモード (-p) で一度だけクエリして終了する。
*: <pre>claude -p "analyze the database schema in this project"</pre>
*: CI/CDパイプライン、プリコミットフック、自動化スクリプトなどに有用。
<br>
* 前の会話を続ける。
*: <pre>claude -c</pre>
<br>
* 特定のセッションIDで再開する。
*: <pre>claude -r session-id</pre>
<br>
* 標準入力からコンテンツを処理する。
*: <pre>cat application.log | claude -p "identify error patterns"</pre>
<br>
===== モデルとディレクトリ設定 =====
* モデルを指定する。
*: <pre>claude --model claude-sonnet-4-5-20250929</pre>
*: または
*: <pre>claude --model claude-opus-4-5-20251101</pre>
<br>
* 追加の作業ディレクトリを追加する。
*: <pre>claude --add-dir ../apps ../lib</pre>
*: 複数のプロジェクトディレクトリにまたがる作業に便利。
<br>
===== 出力とセッション制御 =====
* 最大ターン数を制限する。
*: <pre>claude --max-turns 5 "focused code review"</pre>
*: APIコストを制御する場合に有用である。
<br>
* JSON形式で出力する。
*: <pre>claude -p "generate API documentation" --output-format json</pre>
*: または
*: <pre>claude -p "analyze performance" --output-format stream-json</pre>
<br>
* システムプロンプトを追加する。
*: <pre>claude --append-system-prompt "Working in WSL2 environment. Use 'service' not 'systemctl'"</pre>
<br>
==== カスタムスラッシュコマンド ====
Claude Codeでは、頻繁に使用するプロンプトをMarkdownファイルとして定義できる。<br>
<br>
===== プロジェクト固有のコマンド =====
プロジェクト内のチーム全員が使用できるコマンドを作成する。<br>
 mkdir -p .claude/commands
 echo "Analyze this code for performance issues and suggest optimizations:" > .claude/commands/optimize.md
<br>
これにより <code>/optimize</code> コマンドが利用可能になる。<br>
コマンドは <code>/help</code> で確認でき、"(project)" と表示される。<br>
<br>
===== 個人用コマンド =====
すべてのプロジェクトで使用できる個人用コマンドを作成する。<br>
 mkdir -p ~/.claude/commands
 echo "Review this code for security vulnerabilities:" > ~/.claude/commands/security-review.md
<br>
これにより、<code>/security-review</code> コマンドが利用可能になる。<br>
コマンドは <code>/help</code> で確認でき、"(user)" と表示される。<br>
<br>
===== 引数付きコマンド =====
コマンドファイル内で <code>$ARGUMENTS</code> 変数を使用することで、ユーザ入力を受け取ることができる。<br>
<br>
例: <code>.claude/commands/fix-issue.md</code><br>
 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 that addresses the root cause
 4. Add appropriate tests
 5. Prepare a concise PR description
<br>
使用方法:
*: <pre>/fix-issue 123</pre>
<br>
===== コマンドのフロントマター設定 =====
コマンドファイルにYAMLフロントマターを追加することで、より詳細な設定が可能。<br>
<br>
 例:
 <code>.claude/commands/commit.md</code>
 
 ---
 allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
 argument-hint: [message]
 description: Create a git commit
 model: claude-sonnet-4-5-20250929
 ---
 
 ## Context
 - Current git status: !`git status`
 - Current git diff: !`git diff HEAD`
 - Current branch: !`git branch --show-current`
 
 ## Your task
 Based on the above changes, create a single commit with message: $ARGUMENTS
<br>
===== 階層化されたコマンド =====
サブディレクトリを使用してコマンドを整理できる。<br>
<br>
 .claude/commands/
 ├── frontend/
 │   └── component.md    → /component (project:frontend)
 ├── deploy/
 │   ├── production.md   → /production (project:deploy)
 │   └── staging.md      → /staging (project:deploy)
 └── optimize.md         → /optimize (project)
<br>
==== MCPサーバ統合 ====
Model Context Protocol (MCP) サーバを設定することにより、Claude Codeの機能を拡張できる。<br>
<br>
===== MCP設定の基本 =====
* MCPサーバの設定を開く。
*: <pre>claude mcp</pre>
<br>
* MCPサーバをリスト表示する。
*: <pre>claude mcp list</pre>
<br>
* MCPサーバを追加する。
*: 使用例:
*: <pre>claude mcp add github -- npx @modelcontextprotocol/server-github</pre>
*: <pre>claude mcp add sqlite -- npx @modelcontextprotocol/server-sqlite</pre>
*: <pre>claude mcp add filesystem -- npx @modelcontextprotocol/server-filesystem /path/to/project</pre>
<br>
===== MCP設定ファイル =====
MCPサーバは以下のファイルで設定できる:<br>
* ユーザスコープ:
*: <code>~/.claude/settings.json</code> 内のMCP設定
* プロジェクトスコープ
*: <code>.mcp.json</code> (チーム全体で共有)
* ローカルスコープ:
* <code>.claude/settings.local.json</code> (gitignore対象)
<br>
MCPサーバが設定されると、そのツールはスラッシュコマンドとして自動的に利用可能になる。<br>
<br>
===== MCP利用の実例 =====
* 自然言語でMCPツールを使用する。
*: <pre>Show me GitHub issue #123</pre>
*: <pre>Query users table for anyone named John</pre>
<br>
* 直接コマンドを使用する。
*: <pre>/mcp__github__list_prs</pre>
*: <pre>/mcp__sqlite__query "SELECT * FROM users WHERE name LIKE '%John%'"</pre>
<br>
===== MCPデバッグ =====
* MCPの問題を診断する。
*: <pre>claude --mcp-debug</pre>
*: 設定の問題を特定するのに役立つ。
<br>
==== その他の便利な機能 ====
===== ファイル参照とコンテキスト管理 =====
* ファイルやディレクトリを参照する場合は、<code>@</code>記号を使用する。
*: <pre>analyze @src/auth.js</pre>
*: <pre>review @src/components/</pre>
<br>
* [Tab]キーを使用してファイル名の自動補完ができる。<br>
<br>
===== セッション制御 =====
* [Esc]キーを押すことで、Claudeの処理を中断できる。
*: 処理が長引いている場合や誤った方向に進んでいる場合に有用。
<br>
* 中断後、Claudeに直前のアクションを取り消すよう依頼できる。
*: <pre>undo the last changes</pre>
<br>
===== シェルコマンドの直接実行 =====
* <code>!</code>を使用して、シェルコマンドを直接実行できる。 (会話モードをバイパス) 
*: <pre>!git status</pre>
*: <pre>!npm test</pre>
*: トークン消費を抑えるため、単純なコマンドには <code>!</code> を使用することを推奨。
<br>
===== バックグラウンド実行 =====
* 長時間実行されるコマンドをバックグラウンドで実行できる。
*: Claudeにバックグラウンド実行を依頼する。
*: または、[Ctrl] + [B]キーを押してBashツール呼び出しをバックグラウンドに移動する。
*: (Tmuxユーザは[Ctrl] + [B]を2回押す必要がある)
<br>
* バックグラウンドタスクの管理。
*: <pre>/bashes</pre>
*: 実行中のバックグラウンドタスクをリスト表示し、出力を取得できる。
<br>
===== キーボードショートカット =====
* コマンド履歴検索: [Ctrl] + [R]キー
*: 以前に入力したコマンドを検索できる。
*: 再度[Ctrl] + [R]キーを同時押下すると、古いマッチに移動する。
*: [Backspace]キーで検索をキャンセル。
<br>
* 上下矢印キー: コマンド履歴を移動
<br>
* Vimスタイルの編集を有効化:
*: <pre>/vim</pre>
*: または、<code>/config</code>で永続的に設定可能。
<br>
===== Git統合 =====
Claude CodeはGit操作をサポートしている。<br>
* Claudeに新しいブランチの作成と変更のコミットを依頼できる。
*: <pre>Checkout a new branch named 'feature-xyz' and commit these changes</pre>
<br>
* 重要な変更の後、頻繁にコミットするようClaude に依頼することを推奨。
<br>
* GitHubとの統合 (GitHub CLIまたはMCPサーバ経由) 
*: <pre>Create a PR for this branch</pre>
*: <pre>Ask Claude to review PR #456</pre>
<br>
==== 推奨設定 ====
===== コンテキスト管理 =====
* チェックポイントで積極的にコンパクション (圧縮) を実行する。
*: 機能が完成した後、あるいは、バグが修正された後など、自然な区切りで <code>/compact</code> を使用することを推奨。
<br>
* コンテキスト残量インジケータを確認する。
*: UIの右下に表示されることが多い。
*: 自動コンパクションが近づいていることを示す。
<br>
* 新しいタスクを開始する場合は、<code>/clear</code> を使用する。
*: トークン消費を抑え、無関係な履歴を排除できる。
<br>
===== バージョン管理 =====
* Claude Codeをバージョン管理と併用することを強く推奨。
<br>
* 各重要な変更の後にコミットするようClaude に依頼する。
*: これにより、必要に応じて変更を元に戻すことが容易になる。
<br>
===== パフォーマンス最適化 =====
* ファイルパスを具体的に指定する。
*: 具体的なファイルパスを提供することで、Claudeがより効率的に作業できる。
<br>
* 複数のClaude Codeインスタンスを並行実行できる。
*: 異なるターミナルタブやウィンドウで、それぞれ異なるタスクやプロジェクトの部分に取り組める。
<br>
==== トラブルシューティング ====
===== 一般的な問題 =====
* システムの健全性を診断する。
*: <pre>/doctor</pre>
<br>
* Claude Codeを最新バージョンに更新する。
*: <pre>claude update</pre>
*: Claude Codeは通常、自動的に最新の状態を保つ。
<br>
==== 設定ファイルの場所 ====
* メイン設定
*: <code>~/.claude.json</code>
*: テーマ、通知設定、エディターモード、OAuthセッション、MCP設定、プロジェクトごとの状態を含むファイルである。
<br>
* プロジェクト設定
*: <code>.claude/settings.json</code>
*: チーム全体で共有される設定である。
<br>
* ローカル設定
*: <code>.claude/settings.local.json</code>
*: 個人的な設定
*: gitignore対象のファイルである。
<br>
* プロジェクトメモリ
*: <code>.claude/CLAUDE.md</code>
*: プロジェクト固有の情報、ビルドコマンド、コーディング規約等を記載する。
<br>
* グローバルメモリ
*: <code>~/.claude/CLAUDE.md</code>
*: 全てのプロジェクトに適用される個人的な設定やプリファレンスである。
<br>

== トラブルシューティング ==
==== "command not found: claude" エラー ====
PATHが正しく設定されていない可能性がある。<br>
 <syntaxhighlight lang="sh">
 export PATH="$HOME/.local/bin:$PATH"
 
 # Nativeインストールしている場合
 export PATH="$HOME/.claude/bin:$PATH"
 </syntaxhighlight>
<br>
==== npm権限エラー ====
スーパーユーザ権限でインストールした場合、以下に示すように修正する。<br>
 mkdir -p ~/.npm-global
 npm config set prefix ~/.npm-global
<br>
 <syntaxhighlight lang="sh">
 export PATH="/<Node.jsのインストールディレクトリ>/bin:$PATH"
 </syntaxhighlight>
<br>
その後、<u>一般ユーザ権限</u>でClaude Codeを再インストールする。<br>
 npm install @anthropic-ai/claude-code
<br>
==== 古いインストールの削除 ====
npmを削除する。<br>
 npm uninstall @anthropic-ai/claude-code
 
 # Nativeバイナリを削除する場合
 rm -rf ~/.claude/bin/claude
 rm -rf ~/.local/bin/claude
 
 # 設定ファイルを削除する場合
 # <u>※注意 : 全ての設定が削除される</u>
 rm -rf ~/.claude
 rm ~/.claude.json
<br>
==== Node.jsバージョンが古い場合 ====
Claude CodeではNode.js 18以降が必要である。<br>
<br>
まず、Node.jsのバージョンを確認する。<br>
 node --version
<br>
NVMを使用している場合、最新のLTSバージョンに更新する。<br>
 nvm install --lts
 nvm use --lts
<br>
==== 認証ループの問題 ====
Webブラウザが自動的に開かない場合、ターミナルに表示されるURLを手動でコピーしてブラウザに貼り付ける。<br>
<br><br>

== 参考リンク ==
* [https://code.claude.com/docs/en/setup Claude Code公式ドキュメント]
* [https://docs.claude.com Claude AI公式ドキュメント]
* [https://console.anthropic.com Anthropic Console]
* [https://github.com/anthropics/claude-code Claude CodeのGitHubリポジトリ]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]