Claude Code ユーザーガイド
Claude Code は、ターミナル上で Claude と直接対話しながら、コードベースの解析、コード生成、リファクタリング、開発ワークフローの自動化などを行えるエージェント型コマンドラインインターフェース（CLI）ツールです。
1. インストール方法
公式には、自動アップデートがサポートされているプラットフォーム固有のネイティブインストーラーの使用が推奨されています。
ネイティブインストーラーによるインストール
- macOS / Linux / WSL (Windows Subsystem for Linux):
curl -fsSL https://claude.ai/install.sh | bash
- Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex
- Windows (CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
npm によるインストール
Node.js 環境（Node.js 18以上が必要）がある場合、npm を使用してグローバルにインストールすることも可能です。
npm install -g @anthropic-ai/claude-code
インストールの確認
インストール完了後、新しいターミナルを開いて以下のコマンドを実行し、バージョンが表示されるか確認します。
claude --version
2. 基本的な使い方
初回起動と認証
プロジェクトのルートディレクトリに移動し、以下のコマンドを実行します。
claude
初回起動時は、ブラウザが開いて Anthropic アカウントによる OAuth 認証を求められます。画面の指示に従ってログインを完了してください。
インタラクティブモード
claude コマンドを実行すると、対話型セッションが始まります。この中で質問をしたり、コードの修正を依頼したりできます。
ワンショット実行（非インタラクティブ）
対話セッションを起動せずに、単発の指示を実行させることも可能です。スクリプトや CI/CD パイプラインでの自動化に便利です。
claude -p "src/auth.ts の login 関数にバリデーションを追加して"
シェルコマンドの直接実行
インタラクティブセッション内で、! をプレフィックスとして付けることで、通常のシェルコマンドを実行できます。Claude による説明をスキップしてコマンドを素早く実行したい場合に役立ちます。
!git status
!npm test
3. スラッシュコマンド
セッション内の入力欄で / を入力すると、利用可能なスラッシュコマンドの一覧が表示されます。以下は主要なコマンドです。
| コマンド | 説明 |
|---|---|
/help | 利用可能なすべてのコマンドの一覧とヘルプを表示します。 |
/clear | 会話履歴を完全に消去し、コンテキストウィンドウをクリアします（初期状態に戻す）。 |
/compact | これまでの会話履歴を要約して圧縮し、消費するコンテキスト量を節約します。 |
/rewind | 会話や適用したコード変更を前の状態に巻き戻します。 |
/context | 現在使用しているコンテキスト量（トークン数など）を可視化します。 |
/btw [質問] | メインの会話のコンテキストを汚さずに、ちょっとした脇道の質問を投げかけます。 |
/plan | 複雑な変更を行う前に、計画モードに切り替えて設計や段取りを整理します。 |
/review | コードベースのレビューを依頼します。 |
/init | プロジェクトのルートに CLAUDE.md を作成して初期化します。 |
/memory | 永続メモリ（CLAUDE.md）の内容を対話的に編集します。 |
/model [モデル名] | 使用するモデルを切り替えます（例：sonnet, opus）。 |
/effort [レベル] | 思考の深さ（Reasoning depth）を設定します（low, medium, high, max）。 |
/mcp | Model Context Protocol（MCP）サーバーの接続を管理します。 |
/tasks | バックグラウンドで実行中のタスクを一覧表示・管理します。 |
/config | Claude Code の各種設定を行うインターフェースを開きます。 |
/keybindings | キーバインド設定用の JSON ファイルを開きます。 |
/doctor | インストール状況や接続テストを行い、動作環境の診断をします。 |
/usage | 今のセッションでの消費トークン数やコスト、制限値などの統計情報を表示します。 |
4. キーボードショートカット
インタラクティブセッション中、キーボードショートカットを利用して操作を効率化できます。
| アクション | ショートカット | 説明 |
|---|---|---|
| 入力キャンセル / 終了 | Ctrl + C | 実行中のプロセスを停止するか、セッションを終了します。 |
| 履歴の巻き戻しメニュー | Esc + Esc (2回押す) | 会話や適用したコード変更を以前のステップへロールバックするメニューを開きます。 |
| 許可モードの切り替え | Shift + Tab | ファイル編集やコマンド実行などの実行許可モードを切り替えます。 |
| 詳細出力/思考プロセスのトグル | Ctrl + O | 詳細なログ出力や推論（Reasoning）プロセスの表示/非表示を切り替えます。 |
| 入力履歴の検索 | Ctrl + R | 過去に入力したプロンプトの履歴を検索します。 |
| 外部エディタでの編集 | Ctrl + G | 入力中のプロンプトを外部のテキストエディタで編集します。 |
| コマンドのバックグラウンド化 | Ctrl + B | 実行中の時間のかかるコマンドをバックグラウンドに送ります。 |
| 下書きプロンプトの一時退避 | Ctrl + S | 入力中のプロンプトを下書きとして一時保存（スタッシュ）します。 |
| 思考モード（Thinking）の切り替え | Alt + T | 推論を伴う Thinking Mode の有効/無効を切り替えます。 |
| モデルの切り替え | Alt + P | 使用する AI モデルを素早く切り替えます。 |
| ファイル/フォルダの参照 | @ + パス | プロンプト内で特定のファイルやディレクトリをコンテキストとして参照指定します。 |
5. 高度なカスタマイズ
CLAUDE.md によるコンテキスト共有
プロジェクトのルートに CLAUDE.md を配置することで、プロジェクト固有の開発ルール、コマンド、コーディング規約などを Claude にあらかじめインプットできます。
毎回のチャットで同じ前提条件を説明する手間が省け、エージェントがプロジェクトの規約に沿った正確な提案を行えるようになります。
/initを実行することで、テンプレートとなるCLAUDE.mdを自動生成できます。- 本プロジェクトにおけるエージェント用設定ファイルの記述例については、ルートディレクトリの
GEMINI.mdも参考にしてください。
カスタムスラッシュコマンドの定義
自分専用のカスタムコマンドを追加できます。
- グローバル設定ディレクトリ
~/.claude/commands/またはプロジェクト固有のディレクトリ.claude/commands/に Markdown ファイル（例：test-all.md）を作成します。 - ファイル名（拡張子を除く）がコマンド名（例：
/test-all）になります。 - Markdown ファイル内に、そのコマンドが実行されたときに Claude が行うべき指示を詳しく記述します。
キーバインディングのカスタマイズ
/keybindings コマンドを実行すると、キーマップを設定するための JSON ファイルが開きます。好みに応じてショートカットキーの割り当てをカスタマイズできます。
6. ベストプラクティス
- 具体的かつ明瞭な指示を与える
「バグを直して」といった曖昧な指示ではなく、「
src/auth.tsのlogin関数で、パスワードが空の場合のエラーハンドリングを追加して」のように、対象ファイルや関数名、期待する振る舞いを具体的に指定してください。 - 定期的な履歴のクリア (
/clear) と要約 (/compact) 長時間セッションを続けると、会話履歴が肥大化してコンテキストウィンドウを圧迫し、料金の上昇や Claude の注意力の散漫化を招きます。大きな作業の区切りごとに/clearで履歴を消去するか、/compactで圧縮することをお勧めします。 /plan（計画モード）の活用 大規模なリファクタリングや複数ファイルにまたがる複雑な設計変更を行う際は、まず/planコマンドで変更のロードマップを作成・合意してから実行に移ることで、手戻りを防げます。- 実行前・コミット前の差分確認 (
/diff) Claude がコードに加えた変更は、自動的に保存されます。変更をコミットする前に、/diffコマンドやgit diffを使って、意図通りの変更が行われているかを必ず確認してください。