Claude Code基本操作ガイド - 対話型コーディングの始め方

はじめに

Claude Codeのインストールと初期設定が完了したら、いよいよ実際の開発作業でClaude Codeを活用していきましょう。Claude Codeは自然言語でのやり取りを通じて、コードの理解から実装、デバッグまで幅広いタスクを支援してくれます。

本記事では、Claude Codeとの対話方法を基礎から解説します。この記事を読むことで、以下のことができるようになります。

• claudeコマンドの起動とセッション管理の基本を理解する
• 自然言語で効果的に質問・指示を出す方法を習得する
• @によるファイル参照でコンテキストを提供する
• スラッシュコマンドを使ってClaude Codeの動作を制御する

実行環境

• オペレーティングシステム: macOS 10.15以上、Ubuntu 20.04以上/Debian 10以上、Windows 10以上（WSL 1/2またはGit for Windows）
• ハードウェア: 4GB以上のRAM
• Node.js 18以上（npmインストールの場合のみ必要）
• インターネット接続（認証およびAI処理に必要）
• シェル環境: Bash、Zsh、またはFish推奨

前提条件

• コマンドライン操作の基礎知識
• Gitの基本操作（clone、commit、push等）
• プログラミングの基礎知識（言語は問わない）
• Claude.aiまたはAnthropic Consoleアカウント
• Claude Codeのインストールと認証が完了していること

claudeコマンドの起動

Claude Codeを使い始めるには、ターミナルでclaudeコマンドを実行します。プロジェクトディレクトリに移動してから起動することで、そのプロジェクトのコンテキストを自動的に認識します。

基本的な起動方法

1
2
3
4
5

# プロジェクトディレクトリに移動
cd your-project

# Claude Codeを起動
claude

起動すると、対話型のREPL（Read-Eval-Print Loop）が開始され、自然言語で質問や指示を入力できる状態になります。

初期プロンプト付きで起動

特定の質問や指示を持って起動したい場合は、コマンドライン引数として渡すことができます。

1
2
3
4
5

# プロジェクトの概要を質問して起動
claude "このプロジェクトの構造を説明して"

# 特定のファイルについて質問
claude "src/utils/helpers.jsの役割を教えて"

プリントモードでの実行

対話モードを開始せず、単発の質問に回答を得たい場合は-pフラグを使用します。

1
2
3
4
5

# 質問に回答してすぐに終了
claude -p "この関数のバグを見つけて"

# パイプと組み合わせて使用
cat error.log | claude -p "このエラーログを分析して原因を特定して"

プリントモードは、CI/CDパイプラインやシェルスクリプトでの自動化に適しています。

セッション管理

Claude Codeは会話のコンテキストをセッションとして管理します。セッションを適切に活用することで、過去の会話を参照しながら作業を継続できます。

セッションの継続

直前のセッションを継続するには-c（または--continue）フラグを使用します。

1
2
3
4
5

# 最後のセッションを継続
claude -c

# 継続しながら新しい質問を追加
claude -c "さっきの修正をテストしたら別のエラーが出た"

セッションの再開

特定のセッションを名前またはIDで再開するには-r（または--resume）フラグを使用します。

1
2
3
4
5
6
7
8

# セッション名で再開
claude -r "auth-refactor"

# セッション名で再開し、新しい質問を追加
claude -r "auth-refactor" "このPRを完成させて"

# セッションピッカーを表示
claude -r

セッションの名前変更

作業中のセッションに分かりやすい名前を付けるには/renameコマンドを使用します。

1

> /rename auth-refactor

名前を付けておくと、後から-rフラグで簡単に再開できます。

セッションのフォーク

既存のセッションを複製して新しい方向性で作業を続けたい場合は、--fork-sessionフラグを使用します。

1
2

# セッションを再開しつつ、新しいセッションIDで開始
claude --resume abc123 --fork-session

自然言語による対話

Claude Codeの最大の特徴は、自然言語でコーディングタスクを指示できる点です。効果的な対話のためのテクニックを紹介します。

質問の基本パターン

Claude Codeへの質問は、明確で具体的であるほど良い回答が得られます。

1
2
3
4
5
6
7
8

# コードの説明を依頼
> このuseAuthフックの動作を説明して

# 実装方法を質問
> ユーザー認証のエラーハンドリングを改善するにはどうすればいい？

# バグの原因を調査
> ログイン時にセッションが保存されないバグの原因を調べて

効果的な指示の出し方

複雑なタスクを依頼する際は、コンテキストと期待する結果を明確に伝えます。

1
2
3
4
5
6
7
8

# コンテキストを含めた指示
> src/api/users.jsに新しいエンドポイントを追加して。
> ユーザーのプロフィール画像をアップロードする機能で、
> 既存のファイルアップロード処理のパターンに従って実装して。

# 段階的な指示
> まずこのコードのセキュリティ上の問題点を指摘して。
> その後、修正案を提示して。

会話の流れを活用

Claude Codeは会話のコンテキストを保持しているため、自然な会話の流れで作業を進められます。

1
2
3
4
5
6
7
8
9

> このAPIエンドポイントにバリデーションを追加して

（Claude Codeが実装を提案）

> いいね。でもエラーメッセージをもっと具体的にして

（Claude Codeが修正を提案）

> 完璧。これをテストする方法も教えて

ファイル参照（@記法）

@記法を使うと、特定のファイルやディレクトリをClaude Codeに明示的に参照させることができます。これにより、関連するコードを正確にコンテキストに含めることができます。

基本的なファイル参照

1
2
3
4
5
6
7
8

# 単一ファイルを参照
> @src/utils/helpers.jsのバグを修正して

# 複数ファイルを参照
> @src/old-version.jsと@src/new-version.jsを比較して違いを説明して

# ディレクトリを参照
> @src/components/のコンポーネント構造を分析して

ファイルパスの補完

@を入力すると、ファイルパスの自動補完が有効になります。Tab キーで候補を選択できます。

1
2

> @src/co[Tab]
# → @src/components/ が補完される

カスタムスラッシュコマンドでのファイル参照

カスタムスラッシュコマンドの定義内でも@記法を使用できます。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# .claude/commands/review.md
以下のファイルを参照してコードレビューを実施してください：

@src/main.js
@src/utils/

重点的に確認する項目：
- エラーハンドリング
- パフォーマンス
- セキュリティ

キーボードショートカット

Claude Codeでは、効率的な操作のためのキーボードショートカットが用意されています。

基本操作

複数行入力

長いプロンプトや複数行のコードを入力する際は、以下の方法を使用します。

VS Code、Alacritty、Zed、Warpなどのターミナルでは、/terminal-setupコマンドを実行してShift+Enterバインディングをインストールできます。

クイックコマンド

スラッシュコマンド

スラッシュコマンドは、Claude Codeの動作を制御するための組み込みコマンドです。/で始まるコマンドを入力することで、さまざまな機能にアクセスできます。

主要なスラッシュコマンド一覧

以下は頻繁に使用する主要なスラッシュコマンドです。

/help - ヘルプの表示

利用可能なコマンドとその説明を表示します。

1

> /help

カスタムスラッシュコマンドが定義されている場合は、それらも一覧に表示されます。

/model - モデルの選択

使用するAIモデルを切り替えます。

1
2
3
4
5

> /model

# 表示されるメニューから選択
# - claude-sonnet-4-5（高速・コスト効率）
# - claude-opus-4-5（最高性能）

また、起動時にコマンドライン引数で指定することもできます。

1
2
3
4
5

# Sonnetモデルを使用
claude --model sonnet

# Opusモデルを使用
claude --model opus

/config - 設定の管理

設定インターフェースを開き、Claude Codeの動作をカスタマイズします。

1

> /config

設定インターフェースでは以下の項目を変更できます。

• パーミッション設定
• テーマ設定
• 出力スタイル
• Vimモードの有効化

/clear - 会話のリセット

現在の会話履歴をクリアして、新しい会話を開始します。

1

> /clear

トークン使用量が多くなってきた場合や、新しいトピックに移る場合に使用します。

/compact - 会話の圧縮

会話履歴を圧縮してトークン使用量を節約します。オプションで圧縮時のフォーカス指示を追加できます。

1
2
3
4
5

# 基本的な圧縮
> /compact

# 特定のトピックにフォーカスして圧縮
> /compact 認証機能の実装に関する内容を保持

/init - プロジェクトの初期化

現在のプロジェクトを分析し、CLAUDE.mdファイルを自動生成します。

1

> /init

生成されたCLAUDE.mdには、プロジェクトの構造、技術スタック、コーディング規約などが含まれます。

/memory - メモリの編集

CLAUDE.mdファイルを直接編集するためのインターフェースを開きます。

1

> /memory

/resume - セッションの再開

過去のセッションを再開します。引数なしで実行するとセッションピッカーが表示されます。

1
2
3
4
5

# セッションピッカーを表示
> /resume

# 特定のセッションを再開
> /resume auth-refactor

/permissions - パーミッションの管理

現在のパーミッション設定を表示し、変更できます。

1

> /permissions

/cost - コストの確認

現在のセッションでのトークン使用量と推定コストを表示します。

1

> /cost

/doctor - 診断の実行

Claude Codeのインストール状態をチェックし、問題があれば報告します。

1

> /doctor

/bug - バグ報告

Claude Codeのバグを報告します。会話の内容がAnthropicに送信されます。

1

> /bug

Bashモードの活用

!プレフィックスを使用すると、Claude Codeを経由せずにシェルコマンドを直接実行できます。

1
2
3
4
5
6
7
8

# テストを実行
> !npm test

# Gitの状態を確認
> !git status

# ファイル一覧を表示
> !ls -la src/

Bashモードで実行したコマンドの出力は会話コンテキストに追加されるため、結果についてClaude Codeに質問することができます。

1
2
3
4
5

> !npm test

（テスト結果が表示される）

> このテストの失敗原因を分析して

対話のベストプラクティス

Claude Codeを効果的に活用するためのベストプラクティスをまとめます。

1. コンテキストを明確に伝える

1
2
3
4
5
6
7

# 悪い例
> バグを直して

# 良い例
> @src/api/auth.jsのlogin関数で、
> パスワードが空文字の場合にバリデーションエラーが発生しない
> バグを修正して

2. 段階的に作業を進める

複雑なタスクは一度に依頼せず、段階的に進めます。

1
2
3
4
5
6
7
8
9

> まずこのコードの問題点を分析して

（分析結果を確認）

> その問題を修正するコードを書いて

（修正を確認）

> 修正したコードのテストを追加して

3. フィードバックを具体的に

Claude Codeの提案に対するフィードバックは具体的に伝えます。

1
2
3
4
5
6

# 悪い例
> これじゃない

# 良い例
> このアプローチだとパフォーマンスに問題がある。
> 代わりにメモ化を使った実装にして

4. セッションを適切に管理

関連する作業は同じセッションで継続し、新しいトピックに移る場合はセッションをクリアまたは新規作成します。

1
2
3
4
5

# 作業が一区切りついたらセッションに名前を付ける
> /rename feature-user-profile

# 別の日に再開
claude -r "feature-user-profile"

セッション管理のワークフロー

実際の開発作業でのセッション管理のワークフローを図で示します。

flowchart TD
    A[claude起動] --> B{新規作業?}
    B -->|はい| C[新しいセッション開始]
    B -->|いいえ| D[claude -cまたは-rで継続]
    
    C --> E[作業を進める]
    D --> E
    
    E --> F{作業が一区切り?}
    F -->|はい| G[/renameで名前を付ける]
    F -->|いいえ| E
    
    G --> H{継続する?}
    H -->|はい| E
    H -->|いいえ| I[セッション終了]
    
    I --> J[後日claude -rで再開可能]

まとめ

本記事では、Claude Codeの基本的な操作方法を解説しました。

• claudeコマンドによる起動と、-c、-rフラグによるセッション管理
• 自然言語での効果的な質問・指示の出し方
• @記法によるファイル参照でコンテキストを明示的に提供
• /help、/model、/configなどのスラッシュコマンドによる制御

これらの基本操作を習得することで、日常的な開発質問にClaude Codeを活用できるようになります。次のステップとして、Claude Codeを使ったコードベースの理解や、Plan Mode/Accept Modeの使い分けについて学んでいくことをお勧めします。

参考リンク

• Claude Code公式ドキュメント
• Claude Code CLIリファレンス
• Claude Codeスラッシュコマンド
• Claude Codeインタラクティブモード
• Claude Code GitHubリポジトリ