メインコンテンツへスキップ
このページでは、日常的な開発のための実践的なワークフローについて説明します。未知のコードの探索、デバッグ、リファクタリング、テストの作成、PR の作成、セッションの管理などです。各セクションには、自分のプロジェクトに適応させることができるプロンプトの例が含まれています。より高度なパターンとヒントについては、ベストプラクティスを参照してください。

​
新しいコードベースを理解する

​
コードベースの概要を素早く把握する

新しいプロジェクトに参加したばかりで、その構造を素早く理解する必要があるとします。
1

プロジェクトルートディレクトリに移動する

cd /path/to/project
2

Claude Code を起動する

claude
3

高レベルの概要をリクエストする

give me an overview of this codebase
4

特定のコンポーネントについてさらに詳しく調べる

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?
ヒント：
  • 広い質問から始めて、特定の領域に絞り込んでいく
  • プロジェクトで使用されているコーディング規約とパターンについて質問する
  • プロジェクト固有の用語の用語集をリクエストする

​
関連するコードを見つける

特定の機能または機能に関連するコードを見つける必要があるとします。
1

Claude に関連ファイルを見つけるよう依頼する

find the files that handle user authentication
2

コンポーネントがどのように相互作用するかについてのコンテキストを取得する

how do these authentication files work together?
3

実行フローを理解する

trace the login process from front-end to database
ヒント：
  • 探しているものについて具体的に説明する
  • プロジェクトのドメイン言語を使用する
  • 言語のコード インテリジェンス プラグインをインストールして、Claude に正確な’定義に移動’と’参照を検索’のナビゲーションを提供する

​
バグを効率的に修正する

エラーメッセージが表示され、そのソースを見つけて修正する必要があるとします。
1

Claude とエラーを共有する

I'm seeing an error when I run npm test
2

修正の推奨事項をリクエストする

suggest a few ways to fix the @ts-ignore in user.ts
3

修正を適用する

update user.ts to add the null check you suggested
ヒント：
  • Claude に問題を再現するコマンドとスタックトレースを伝える
  • エラーを再現するための手順を記載する
  • エラーが断続的か一貫しているかを Claude に知らせる

​
コードをリファクタリングする

古いコードを最新のパターンとプラクティスを使用するように更新する必要があるとします。
1

リファクタリング対象のレガシーコードを特定する

find deprecated API usage in our codebase
2

リファクタリングの推奨事項を取得する

suggest how to refactor utils.js to use modern JavaScript features
3

変更を安全に適用する

refactor utils.js to use ES2024 features while maintaining the same behavior
4

リファクタリングを検証する

run tests for the refactored code
ヒント：
  • Claude に最新のアプローチの利点を説明するよう依頼する
  • 必要に応じて変更が後方互換性を維持することをリクエストする
  • リファクタリングを小さくテスト可能な増分で実行する

​
特化した subagent を使用する

特定のタスクをより効果的に処理するために、特化した AI subagent を使用したいとします。
1

利用可能な subagent を表示する

/agents
これにより、利用可能なすべての subagent が表示され、新しいものを作成できます。
2

subagent を自動的に使用する

Claude Code は自動的に適切なタスクを特化した subagent に委譲します：
review my recent code changes for security issues

run all tests and fix any failures
3

特定の subagent を明示的にリクエストする

use the code-reviewer subagent to check the auth module

have the debugger subagent investigate why users can't log in
4

ワークフロー用のカスタム subagent を作成する

/agents
次に「Create New subagent」を選択し、プロンプトに従って以下を定義します：
  • subagent の目的を説明する一意の識別子（例：code-reviewer、api-designer）。
  • Claude がこのエージェントを使用する場合
  • アクセスできるツール
  • エージェントの役割と動作を説明するシステムプロンプト
ヒント：
  • チーム共有用に .claude/agents/ にプロジェクト固有の subagent を作成する
  • 自動委譲を有効にするために説明的な description フィールドを使用する
  • ツールアクセスを各 subagent が実際に必要なものに制限する
  • 詳細な例については、subagents ドキュメントを確認する

​
Plan Mode を使用して安全なコード分析を行う

Plan Mode は Claude に読み取り専用操作でコードベースを分析して計画を作成するよう指示します。これはコードベースの探索、複雑な変更の計画、またはコードの安全なレビューに最適です。Plan Mode では、Claude は AskUserQuestionを使用して要件を収集し、計画を提案する前に目標を明確にします。

​
Plan Mode を使用する場合

  • マルチステップの実装：機能が多くのファイルへの編集を必要とする場合
  • コード探索：何かを変更する前にコードベースを徹底的に調査したい場合
  • インタラクティブな開発：Claude との方向性について反復したい場合

​
Plan Mode の使用方法

セッション中に Plan Mode をオンにする Shift+Tab を使用してセッション中に Plan Mode に切り替えることができます。 Normal Mode にいる場合、Shift+Tab は最初に Auto-Accept Mode に切り替わります。これはターミナルの下部に ⏵⏵ accept edits on で示されます。その後の Shift+Tab は Plan Mode に切り替わります。これは ⏸ plan mode on で示されます。 Plan Mode で新しいセッションを開始する Plan Mode で新しいセッションを開始するには、--permission-mode plan フラグを使用します： 
claude --permission-mode plan
Plan Mode で「ヘッドレス」クエリを実行する 「ヘッドレスモード」で -p を使用して Plan Mode でクエリを直接実行することもできます： 
claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

​
例：複雑なリファクタリングの計画

claude --permission-mode plan

I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
Claude は現在の実装を分析し、包括的な計画を作成します。フォローアップで改善します： 
What about backward compatibility?

How should we handle database migration?
Ctrl+G を押してデフォルトのテキストエディタで計画を開き、Claude が進める前に直接編集できます。
計画を受け入れると、Claude は計画コンテンツからセッションに自動的に名前を付けます。名前はプロンプトバーとセッションピッカーに表示されます。既に --name または /rename で名前を設定している場合、計画を受け入れてもそれは上書きされません。

​
Plan Mode をデフォルトとして設定する

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}
詳細な設定オプションについては、設定ドキュメントを参照してください。

​
テストを使用する

カバーされていないコードのテストを追加する必要があるとします。
1

テストされていないコードを特定する

find functions in NotificationsService.swift that are not covered by tests
2

テストスキャフォルディングを生成する

add tests for the notification service
3

意味のあるテストケースを追加する

add test cases for edge conditions in the notification service
4

テストを実行して検証する

run the new tests and fix any failures
Claude は、プロジェクトの既存のパターンと規約に従うテストを生成できます。テストをリクエストするときは、検証したい動作について具体的に説明してください。Claude は既存のテストファイルを調べて、既に使用されているスタイル、フレームワーク、アサーションパターンに一致させます。 包括的なカバレッジのために、Claude に見落とした可能性のあるエッジケースを特定するよう依頼してください。Claude はコードパスを分析し、エラー条件、境界値、見落としやすい予期しない入力のテストを提案できます。

​
プルリクエストを作成する

Claude に直接プルリクエストを作成するよう依頼するか（「create a pr for my changes」）、ステップバイステップで Claude をガイドできます：
1

変更内容を要約する

summarize the changes I've made to the authentication module
2

プルリクエストを生成する

create a pr
3

レビューと改善

enhance the PR description with more context about the security improvements
gh pr create を使用して PR を作成すると、セッションはその PR に自動的にリンクされます。後で claude --from-pr <number> で再開できます。
Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。

​
ドキュメントを処理する

コードのドキュメントを追加または更新する必要があるとします。
1

ドキュメント化されていないコードを特定する

find functions without proper JSDoc comments in the auth module
2

ドキュメントを生成する

add JSDoc comments to the undocumented functions in auth.js
3

レビューと改善

improve the generated documentation with more context and examples
4

ドキュメントを検証する

check if the documentation follows our project standards
ヒント：
  • 必要なドキュメントスタイル（JSDoc、docstring など）を指定する
  • ドキュメント内の例をリクエストする
  • パブリック API、インターフェース、複雑なロジックのドキュメントをリクエストする

​
ノートと非コードフォルダで作業する

Claude Code はどのディレクトリでも機能します。ノートボルト、ドキュメントフォルダ、またはマークダウンファイルの任意のコレクション内で実行して、コードと同じ方法でコンテンツを検索、編集、再編成します。 .claude/ ディレクトリと CLAUDE.md は他のツールの設定ディレクトリと並んで競合なく存在します。Claude は各ツール呼び出しで新しくファイルを読み込むため、別のアプリケーションで行った編集は次回そのファイルを読み込むときに表示されます。

​
画像を使用する

コードベース内の画像を使用する必要があり、Claude の画像コンテンツ分析を支援したいとします。
1

会話に画像を追加する

次のいずれかの方法を使用できます：
  1. Claude Code ウィンドウに画像をドラッグアンドドロップする
  2. 画像をコピーして、CLI に ctrl+v で貼り付ける（cmd+v は使用しないでください）
  3. Claude に画像パスを提供する。例：「Analyze this image: /path/to/your/image.png」
2

Claude に画像を分析するよう依頼する

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?
3

コンテキストに画像を使用する

Here's a screenshot of the error. What's causing it?

This is our current database schema. How should we modify it for the new feature?
4

ビジュアルコンテンツからコード提案を取得する

Generate CSS to match this design mockup

What HTML structure would recreate this component?
ヒント：
  • テキスト説明が不明確または面倒な場合は画像を使用する
  • より良いコンテキストのために、エラー、UI デザイン、図のスクリーンショットを含める
  • 会話で複数の画像を使用できます
  • 画像分析は図、スクリーンショット、モックアップなどで機能します
  • Claude が画像を参照する場合（例：[Image #1]）、Cmd+Click（Mac）または Ctrl+Click（Windows/Linux）リンクをクリックして、デフォルトビューアで画像を開きます

​
ファイルとディレクトリを参照する

@ を使用して、Claude に読み込まれるのを待たずにファイルまたはディレクトリをすばやく含めます。
1

単一ファイルを参照する

Explain the logic in @src/utils/auth.js
これにより、ファイルの完全な内容が会話に含まれます。
2

ディレクトリを参照する

What's the structure of @src/components?
これにより、ファイル情報を含むディレクトリリストが提供されます。
3

MCP リソースを参照する

Show me the data from @github:repos/owner/repo/issues
これにより、@server:resource 形式を使用して接続された MCP サーバーからデータを取得します。詳細については、MCP リソースを参照してください。
ヒント：
  • ファイルパスは相対パスまたは絶対パスにできます
  • @ ファイル参照は、ファイルのディレクトリと親ディレクトリに CLAUDE.md を追加してコンテキストに含めます
  • ディレクトリ参照はコンテンツではなくファイルリストを表示します
  • 単一のメッセージで複数のファイルを参照できます（例：「@file1.js and @file2.js」）

​
拡張思考（思考モード）を使用する

拡張思考はデフォルトで有効になっており、Claude が複雑な問題をステップバイステップで推論するためのスペースを提供します。この推論は詳細モードで表示され、Ctrl+O でオンに切り替えることができます。拡張思考中、スピナーは「still thinking」や「almost done thinking」などのインラインの進捗ヒントを表示し、Claude が積極的に作業していることを示します。 さらに、努力レベルをサポートするモデルは適応的推論を使用します。固定された思考トークン予算の代わりに、モデルは努力レベル設定とタスクに基づいて動的に思考を決定します。適応的推論により、Claude は日常的なプロンプトにより速く応答し、それから恩恵を受けるステップのためにより深い思考を予約できます。 拡張思考は、複雑なアーキテクチャの決定、難しいバグ、マルチステップの実装計画、異なるアプローチ間のトレードオフの評価に特に価値があります。
「think」、「think hard」、「think more」などのフレーズは通常のプロンプト指示として解釈され、思考トークンを割り当てません。

​
思考モードを設定する

思考はデフォルトで有効になっていますが、調整または無効にできます。
スコープ設定方法詳細
努力レベル/effort を実行するか、/model で調整するか、CLAUDE_CODE_EFFORT_LEVELを設定するサポートされているモデルでの思考の深さを制御する
ultrathink キーワードプロンプトの任意の場所に「ultrathink」を含めるそのターンでモデルがより多く推論するよう指示するコンテキスト内指示を追加します。努力レベル自体は変更しません。努力レベルを調整を参照してください
トグルショートカットOption+T（macOS）または Alt+T（Windows/Linux）を押す現在のセッションの思考をオン/オフに切り替えます（すべてのモデル）。ターミナル設定を有効にして Option キーショートカットを有効にする必要がある場合があります
グローバルデフォルト/config を使用して思考モードをトグルするすべてのプロジェクト全体でデフォルトを設定します（すべてのモデル）。
~/.claude/settings.json に alwaysThinkingEnabled として保存されます
トークン予算を制限するMAX_THINKING_TOKENS環境変数を設定する思考予算を特定のトークン数に制限します。適応的推論を備えたモデルでは、適応的推論が無効になっていない限り 0 に設定されている場合のみ適用されます。例：export MAX_THINKING_TOKENS=10000
Claude の思考プロセスを表示するには、Ctrl+O を押して詳細モードをトグルし、グレーのイタリック体で表示される内部推論を確認します。

​
拡張思考の仕組み

拡張思考は、Claude が応答する前に実行する内部推論の量を制御します。より多くの思考により、ソリューションを探索し、エッジケースを分析し、間違いを自己修正するためのより多くのスペースが提供されます。 努力レベルをサポートするモデルでは、思考は適応的推論を使用します。モデルは、選択した努力レベルに基づいて思考トークンを動的に割り当てます。これは速度と推論の深さのトレードオフを調整するための推奨される方法です。努力レベル自体を変更せずに、Claude がそのターンでより多くまたはより少なく思考することを望む場合は、プロンプトで直接そう言うか、CLAUDE.md で言うこともできます。 古いモデルでは、思考は出力予算から最大 31,999 トークンの固定予算を使用します。MAX_THINKING_TOKENS環境変数でこれを制限するか、/config または Option+T/Alt+T トグルで思考を完全に無効にできます。 適応的推論を備えたモデルでは、MAX_THINKING_TOKENS は 0 に設定されている場合のみ適用されます。または CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 は、これらのモデルを固定予算に戻します。CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING は Opus 4.6 と Sonnet 4.6 にのみ適用されます。Opus 4.7 は常に適応的推論を使用し、固定思考予算をサポートしていません。環境変数を参照してください。
思考の要約が編集されている場合でも、使用されたすべての思考トークンに対して課金されます。インタラクティブモードでは、思考はデフォルトで折りたたまれたスタブとして表示されます。settings.json で showThinkingSummaries: true を設定して、完全な要約を表示します。

​
以前の会話を再開する

Claude Code を開始するときは、以前のセッションを再開できます：
  • claude --continue は現在のディレクトリで最新の会話を続行します
  • claude --resume は会話ピッカーを開くか、名前で再開します
  • claude --from-pr 123 は特定のプルリクエストにリンクされたセッションを再開します
アクティブなセッション内から、/resume を使用して別の会話に切り替えます。 選択したセッションが古く、それを再度読み込むことが使用制限の実質的な部分を消費するほど大きい場合、--resume、--continue、および /resume は完全なトランスクリプトを読み込む代わりに、サマリーから再開することを提案します。このプロンプトは Amazon Bedrock、Google Cloud Vertex AI、または Microsoft Foundry では利用できません。 セッションはプロジェクトディレクトリごとに保存されます。デフォルトでは、/resume ピッカーは現在の worktree からのインタラクティブセッションを表示し、リストを他の worktree またはプロジェクトに広げるためのキーボードショートカット、検索、プレビュー、名前変更があります。以下のセッションピッカーを使用を参照してください。 別の worktree の同じリポジトリからセッションを選択すると、Claude Code はディレクトリを切り替える必要なく直接再開します。関連のないプロジェクトからセッションを選択すると、cd と再開コマンドをクリップボードにコピーします。 名前で再開すると、現在のリポジトリとその worktree 全体で解決されます。claude --resume <name> と /resume <name> の両方が完全一致を探し、セッションが別の worktree に存在する場合でも直接再開します。 名前があいまいな場合、claude --resume <name> はピッカーを開き、名前を検索用語として事前入力します。/resume <name> をセッション内から実行すると、代わりにエラーが報告されるため、/resume を引数なしで実行してピッカーを開き、選択します。 claude -p または SDK 呼び出しで作成されたセッションはピッカーに表示されませんが、セッション ID をそのまま claude --resume <session-id> に渡すことで再開できます。

​
セッションに名前を付ける

セッションに説明的な名前を付けて、後で見つけやすくします。これは複数のタスクまたは機能に取り組むときのベストプラクティスです。
1

セッションに名前を付ける

起動時に -n でセッションに名前を付けます：
claude -n auth-refactor
またはセッション中に /rename を使用します。これはプロンプトバーに名前も表示します：
/rename auth-refactor
ピッカーから任意のセッションの名前を変更することもできます。/resume を実行し、セッションに移動して、Ctrl+R を押します。
2

後で名前で再開する

コマンドラインから：
claude --resume auth-refactor
またはアクティブなセッション内から：
/resume auth-refactor

​
セッションピッカーを使用する

/resume コマンド（または引数なしの claude --resume）は、次の機能を備えたインタラクティブセッションピッカーを開きます： ピッカーのキーボードショートカット：
ショートカットアクション
↑ / ↓セッション間を移動する
→ / ←グループ化されたセッションを展開または折りたたむ
Enterハイライトされたセッションを選択して再開する
Spaceセッションコンテンツをプレビューする。Ctrl+V も、ターミナルがペーストとしてキャプチャしないターミナルで機能します
Ctrl+Rハイライトされたセッションの名前を変更する
/ または Space 以外の任意の印字可能文字検索モードに入り、セッションをフィルタリングする
Ctrl+Aこのマシン上のすべてのプロジェクトからセッションを表示します。もう一度押すと現在のリポジトリを復元します
Ctrl+W現在のリポジトリのすべての worktree からセッションを表示します。もう一度押すと現在の worktree を復元します。マルチ worktree リポジトリでのみ表示されます
Ctrl+B現在の git ブランチからのセッションにフィルタリングします。もう一度押すとすべてのブランチからのセッションを表示します
Escピッカーまたは検索モードを終了する
セッション組織： ピッカーは有用なメタデータを含むセッションを表示します：
  • セッション名（設定されている場合）、そうでない場合は会話の要約または最初のユーザープロンプト
  • 最後のアクティビティからの経過時間
  • メッセージ数
  • Git ブランチ（該当する場合）
  • Ctrl+A ですべてのプロジェクトに広げた後に表示されるプロジェクトパス
フォークされたセッション（/branch、/rewind、または --fork-session で作成）はルートセッションの下にグループ化され、関連する会話を見つけやすくなります。
ヒント：
  • セッションを早期に名前付ける：異なるタスクで作業を開始するときに /rename を使用します。後で「payment-integration」を見つける方が「explain this function」よりもはるかに簡単です
  • 現在のディレクトリで最新の会話にすばやくアクセスするには --continue を使用します
  • 必要なセッションがわかっている場合は --resume session-name を使用します
  • 参照して選択する必要がある場合は --resume（名前なし）を使用します
  • スクリプトの場合は、claude --continue --print "prompt" を使用して非対話モードで再開します
  • ピッカーで Space を押して、セッションを再開する前にプレビューします
  • 再開された会話は、元のセッションと同じモデルと設定で開始されます
仕組み：
  1. 会話ストレージ：すべての会話は完全なメッセージ履歴とともにローカルに自動保存されます
  2. メッセージ逆シリアル化：再開時に、コンテキストを維持するために全メッセージ履歴が復元されます
  3. ツール状態：前の会話からのツール使用と結果が保持されます
  4. コンテキスト復元：会話は前のすべてのコンテキストを保持して再開されます

​
Git worktree を使用して並列 Claude Code セッションを実行する

複数のタスクに同時に取り組む場合、各 Claude セッションがコードベースの独自のコピーを持つ必要があります。そうしないと変更が衝突します。Git worktree は、同じリポジトリ履歴とリモート接続を共有しながら、独自のファイルとブランチを持つ個別の作業ディレクトリを作成することで、この問題を解決します。つまり、Claude が 1 つの worktree で機能に取り組んでいる間に、別の worktree でバグを修正でき、どちらのセッションも相互に干渉しません。 --worktree（-w）フラグを使用して、分離された worktree を作成し、Claude をその中で開始します。渡す値は worktree ディレクトリ名とブランチ名になります： 
# "feature-auth" という名前の worktree で Claude を開始する
# 新しいブランチで .claude/worktrees/feature-auth/ を作成する
claude --worktree feature-auth

# 別の worktree で別のセッションを開始する
claude --worktree bugfix-123
名前を省略すると、Claude は自動的にランダムな名前を生成します： 
# "bright-running-fox" のような名前を自動生成する
claude --worktree
Worktree は <repo>/.claude/worktrees/<name> に作成され、デフォルトのリモートブランチから分岐します。これは origin/HEAD が指すところです。worktree ブランチは worktree-<name> という名前が付けられます。 ベースブランチは Claude Code フラグまたは設定を通じて設定できません。origin/HEAD はクローン時に Git が設定したローカル .git ディレクトリに保存される参照です。リポジトリのデフォルトブランチが後で GitHub または GitLab で変更された場合、ローカル origin/HEAD は古いものを指し続け、worktree はそこから分岐します。ローカル参照をリモートが現在デフォルトと見なしているものと再同期するには： 
git remote set-head origin -a
これは、ローカル .git ディレクトリのみを更新する標準 Git コマンドです。リモートサーバーでは何も変わりません。worktree が特定のブランチではなくリモートのデフォルトに基づくようにしたい場合は、git remote set-head origin your-branch-name で明示的に設定します。 worktree の作成方法を完全に制御するには、WorktreeCreate フックを設定します。フックは Claude Code のデフォルト git worktree ロジックを完全に置き換えるため、必要な ref から取得してブランチできます。 セッション中に Claude に「work in a worktree」または「start a worktree」を依頼することもでき、自動的に作成されます。

​
Subagent worktree

Subagent は worktree 分離を使用して、競合なしに並列で作業することもできます。Claude に「use worktrees for your agents」を依頼するか、カスタム subagentで isolation: worktree をエージェントのフロントマターに追加して設定します。各 subagent は独自の worktree を取得し、変更なしで subagent が終了すると自動的にクリーンアップされます。

​
Worktree クリーンアップ

worktree セッションを終了すると、Claude は変更があったかどうかに基づいてクリーンアップを処理します：
  • 変更なし：worktree とそのブランチは自動的に削除されます
  • 変更またはコミットが存在する：Claude は worktree を保持するか削除するかをプロンプトします。保持するとディレクトリとブランチが保存され、後で戻ることができます。削除すると worktree ディレクトリとそのブランチが削除され、すべてのコミットされていない変更とコミットが破棄されます
Subagent worktree は、subagent が変更なしで終了すると自動的にクリーンアップされます。クラッシュまたは中断された並列実行によって孤立した subagent worktree は、cleanupPeriodDays設定より古い場合、コミットされていない変更、追跡されていないファイル、プッシュされていないコミットがない場合、起動時に自動的に削除されます。--worktree で作成した worktree は、このスイープによって削除されることはありません。 Claude セッション外で worktree をクリーンアップするには、worktree を手動で管理を使用します。
.claude/worktrees/ を .gitignore に追加して、worktree コンテンツがメインリポジトリに追跡されていないファイルとして表示されるのを防ぎます。

​
Worktree に gitignored ファイルをコピーする

Git worktree は新しいチェックアウトなので、メインリポジトリから .env や .env.local などの追跡されていないファイルは含まれません。Claude が worktree を作成するときにこれらのファイルを自動的にコピーするには、プロジェクトルートに .worktreeinclude ファイルを追加します。 ファイルは .gitignore 構文を使用して、コピーするファイルをリストします。パターンに一致し、gitignored されているファイルのみがコピーされるため、追跡されたファイルは決して複製されません。
.worktreeinclude
.env
.env.local
config/secrets.json
これは --worktree、subagent worktree、およびデスクトップアプリの並列セッションで作成された worktree に適用されます。

​
Worktree を手動で管理する

worktree の場所とブランチ設定をより細かく制御するには、Git を使用して worktree を直接作成します。これは特定の既存ブランチをチェックアウトするか、worktree をリポジトリの外に配置する必要がある場合に便利です。 
# 新しいブランチで worktree を作成する
git worktree add ../project-feature-a -b feature-a

# 既存のブランチで worktree を作成する
git worktree add ../project-bugfix bugfix-123

# worktree で Claude を開始する
cd ../project-feature-a && claude

# 完了したらクリーンアップする
git worktree list
git worktree remove ../project-feature-a
詳細については、公式 Git worktree ドキュメントを参照してください。
プロジェクトのセットアップに従って、各新しい worktree で開発環境を初期化することを忘れないでください。スタックに応じて、これには依存関係のインストール（npm install、yarn）、仮想環境のセットアップ、またはプロジェクトの標準セットアップ手順に従うことが含まれる場合があります。

​
Git 以外のバージョン管理

Worktree 分離はデフォルトで git で機能します。SVN、Perforce、Mercurial などの他のバージョン管理システムの場合は、WorktreeCreate と WorktreeRemove フックを設定して、カスタム worktree 作成とクリーンアップロジックを提供します。設定されている場合、これらのフックは --worktree を使用するときにデフォルトの git 動作を置き換えます。そのため、.worktreeincludeは処理されません。フックスクリプト内でローカル設定ファイルをコピーしてください。 共有タスクとメッセージングを使用した並列セッションの自動調整については、エージェントチームを参照してください。

​
Claude が注意を必要とするときに通知を受け取る

長時間実行されるタスクを開始して別のウィンドウに切り替えるときは、Claude が終了したときまたは入力が必要なときに知ることができるようにデスクトップ通知を設定できます。これは Notification フックイベントを使用します。これは Claude が許可を待っている、アイドル状態で新しいプロンプトの準備ができている、または認証を完了しているときはいつでも発火します。
1

設定にフックを追加する

~/.claude/settings.json を開き、プラットフォームのネイティブ通知コマンドを呼び出す Notification フックを追加します：
{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}
設定ファイルに既に hooks キーがある場合は、上書きするのではなく Notification エントリをマージします。CLI で説明したいことを説明することで、Claude にフックを書くよう依頼することもできます。
2

オプションでマッチャーを絞り込む

デフォルトでは、フックはすべての通知タイプで発火します。特定のイベントのみで発火させるには、matcher フィールドを次のいずれかの値に設定します：
マッチャー発火する場合
permission_promptClaude がツール使用を承認する必要がある場合
idle_promptClaude が完了し、次のプロンプトを待っている場合
auth_success認証が完了する場合
elicitation_dialogClaude があなたに質問している場合
3

フックを検証する

/hooks と入力し、Notification を選択して、フックが表示されることを確認します。選択すると、実行されるコマンドが表示されます。エンドツーエンドでテストするには、Claude に許可が必要なコマンドを実行するよう依頼してターミナルから離れるか、Claude に通知を直接トリガーするよう依頼します。
完全なイベントスキーマと通知タイプについては、通知リファレンスを参照してください。

​
Claude を unix スタイルのユーティリティとして使用する

​
検証プロセスに Claude を追加する

Claude Code をリンターまたはコードレビューアーとして使用したいとします。 ビルドスクリプトに Claude を追加する： 
// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}
ヒント：
  • CI/CD パイプラインで自動コードレビューに Claude を使用する
  • プロンプトをカスタマイズして、プロジェクトに関連する特定の問題をチェックする
  • 異なるタイプの検証用に複数のスクリプトを作成することを検討する

​
パイプイン、パイプアウト

Claude にデータをパイプインし、構造化された形式でデータを取得したいとします。 Claude を通じてデータをパイプする： 
cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt
ヒント：
  • パイプを使用して Claude を既存のシェルスクリプトに統合する
  • 他の Unix ツールと組み合わせて強力なワークフローを作成する
  • 構造化出力に --output-format を使用することを検討する

​
出力形式を制御する

特に Claude Code をスクリプトまたは他のツールに統合する場合、Claude の出力が特定の形式である必要があるとします。
1

テキスト形式を使用する（デフォルト）

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt
これは Claude のプレーンテキスト応答のみを出力します（デフォルトの動作）。
2

JSON 形式を使用する

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json
これは、コストと期間を含むメタデータを含むメッセージの JSON 配列を出力します。
3

ストリーミング JSON 形式を使用する

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json
これは、Claude がリクエストを処理するときにリアルタイムで一連の JSON オブジェクトを出力します。各メッセージは有効な JSON オブジェクトですが、連結された場合、全体の出力は有効な JSON ではありません。
ヒント：
  • Claude の応答だけが必要な単純な統合には --output-format text を使用する
  • 完全な会話ログが必要な場合は --output-format json を使用する
  • 各会話ターンのリアルタイム出力には --output-format stream-json を使用する

​
Claude をスケジュールで実行する

Claude に長時間実行されるタスクを自動的に定期的に処理させたいとします。例えば、毎朝オープン PR をレビューしたり、毎週依存関係を監査したり、夜間に CI の失敗をチェックしたりします。 実行場所に基づいてスケジューリングオプションを選択します：
オプション実行場所最適な用途
ルーチンAnthropic 管理インフラストラクチャコンピュータがオフの場合でも実行する必要があるタスク。claude.ai/code/routinesで設定します。
デスクトップスケジュール済みタスクデスクトップアプリ経由のマシンローカルファイル、ツール、またはコミットされていない変更への直接アクセスが必要なタスク。
GitHub ActionsCI パイプラインオープン PR などのリポジトリイベント、またはワークフロー設定と一緒に存在する必要がある cron スケジュールに関連するタスク。
/loop現在の CLI セッションセッションが開いている間のクイックポーリング。タスクは新しい会話を開始すると停止します。--resume と --continue は期限切れでないものを復元します。
スケジュール済みタスク用のプロンプトを作成するときは、成功がどのように見えるか、および結果をどうするかについて明示的に説明してください。タスクは自律的に実行されるため、質問を明確にすることはできません。例えば：‘needs-review ラベルが付いたオープン PR をレビューし、問題に関するインラインコメントを残し、#eng-reviews Slack チャネルに要約を投稿します。‘

​
Claude にその機能について質問する

Claude は自分のドキュメントへの組み込みアクセスを持っており、自分の機能と制限について質問に答えることができます。

​
質問例

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills are available?

how do I use MCP with Claude Code?

how do I configure Claude Code for Amazon Bedrock?

what are the limitations of Claude Code?
Claude はこれらの質問に対してドキュメントベースの回答を提供します。実行可能な例と実践的なデモンストレーションについては、/powerup を実行してアニメーション化されたデモを含むインタラクティブレッスンを受けるか、上記の特定のワークフローセクションを参照してください。
ヒント：
  • Claude は使用しているバージョンに関係なく、常に最新の Claude Code ドキュメントにアクセスできます
  • 詳細な回答を得るために具体的な質問をする
  • Claude は MCP 統合、エンタープライズ設定、高度なワークフローなどの複雑な機能を説明できます

​
次のステップ

ベストプラクティス

Claude Code から最大限の価値を得るためのパターン

Claude Code の仕組み

agentic ループとコンテキスト管理を理解する

Claude Code を拡張する

skill、フック、MCP、subagent、プラグインを追加する

リファレンス実装

開発コンテナリファレンス実装をクローンする