6 6
7> Claude Code を使用してコードベースの探索、バグ修正、リファクタリング、テスト、その他の日常的なタスクを実行するためのステップバイステップガイド。7> Claude Code を使用してコードベースの探索、バグ修正、リファクタリング、テスト、その他の日常的なタスクを実行するためのステップバイステップガイド。
8 8
9このページでは、日常的な開発のための実践的なワークフローについて説明します。未知のコードの探索、デバッグ、リファクタリング、テストの作成、PR の作成、セッションの管理などです。各セクションには、自分のプロジェクトに適応させることができるプロンプトの例が含まれています。より高度なパターンとヒントについては、[ベストプラクティス](/ja/best-practices)を参照してください。9このページでは、日常的な開発のための短いレシピを集めています。プロンプティングとコンテキスト管理に関する高度なガイダンスについては、[ベストプラクティス](/ja/best-practices)を参照してください。
10 10
11## 新しいコードベースを理解する11このページでは以下をカバーしています：
12 12
13### コードベースの概要を素早く把握する13* [プロンプトレシピ](#prompt-recipes)：コード探索、バグ修正、リファクタリング、テスト、PR、ドキュメント用
14* [以前の会話を再開する](#resume-previous-conversations)：タスクを複数回に分けて実行できるようにする
15* [worktree を使用して並列セッションを実行する](#run-parallel-sessions-with-worktrees)：同時編集が衝突しないようにする
16* [編集前に計画する](#plan-before-editing)：ディスクに変更を加える前に確認する
17* [研究を subagent に委譲する](#delegate-research-to-subagents)：メインコンテキストをクリーンに保つ
18* [Claude をスクリプトにパイプする](#pipe-claude-into-scripts)：CI とバッチ処理用
19
20## プロンプトレシピ
21
22これらは、未知のコード探索、デバッグ、リファクタリング、テスト作成、PR 作成などの日常的なタスク用のプロンプトパターンです。各パターンは任意の Claude Code サーフェスで機能します。プロジェクトに合わせて表現を調整してください。
23
24### 新しいコードベースを理解する
25
26#### コードベースの概要を素早く把握する
14 27
15新しいプロジェクトに参加したばかりで、その構造を素早く理解する必要があるとします。28新しいプロジェクトに参加したばかりで、その構造を素早く理解する必要があるとします。
16 29
56 * プロジェクト固有の用語の用語集をリクエストする69 * プロジェクト固有の用語の用語集をリクエストする
57</Tip>70</Tip>
58 71
59### 関連するコードを見つける72#### 関連するコードを見つける
60 73
61特定の機能または機能に関連するコードを見つける必要があるとします。74特定の機能または機能に関連するコードを見つける必要があるとします。
62 75
90 103
91***104***
92 105
93## バグを効率的に修正する106### バグを効率的に修正する
94 107
95エラーメッセージが表示され、そのソースを見つけて修正する必要があるとします。108エラーメッセージが表示され、そのソースを見つけて修正する必要があるとします。
96 109
124 137
125***138***
126 139
127## コードをリファクタリングする140### コードをリファクタリングする
128 141
129古いコードを最新のパターンとプラクティスを使用するように更新する必要があるとします。142古いコードを最新のパターンとプラクティスを使用するように更新する必要があるとします。
130 143
164 177
165***178***
166 179
167## 特化した subagent を使用する180### テストを使用する
168
169特定のタスクをより効果的に処理するために、特化した AI subagent を使用したいとします。
170
171<Steps>
172 <Step title="利用可能な subagent を表示する">
173 ```text theme={null}
174 /agents
175 ```
176
177 これにより、利用可能なすべての subagent が表示され、新しいものを作成できます。
178 </Step>
179
180 <Step title="subagent を自動的に使用する">
181 Claude Code は自動的に適切なタスクを特化した subagent に委譲します：
182
183 ```text theme={null}
184 review my recent code changes for security issues
185 ```
186
187 ```text theme={null}
188 run all tests and fix any failures
189 ```
190 </Step>
191
192 <Step title="特定の subagent を明示的にリクエストする">
193 ```text theme={null}
194 use the code-reviewer subagent to check the auth module
195 ```
196
197 ```text theme={null}
198 have the debugger subagent investigate why users can't log in
199 ```
200 </Step>
201
202 <Step title="ワークフロー用のカスタム subagent を作成する">
203 ```text theme={null}
204 /agents
205 ```
206
207 次に「Create New subagent」を選択し、プロンプトに従って以下を定義します：
208
209 * subagent の目的を説明する一意の識別子（例：`code-reviewer`、`api-designer`）。
210 * Claude がこのエージェントを使用する場合
211 * アクセスできるツール
212 * エージェントの役割と動作を説明するシステムプロンプト
213 </Step>
214</Steps>
215
216<Tip>
217 ヒント：
218
219 * チーム共有用に `.claude/agents/` にプロジェクト固有の subagent を作成する
220 * 自動委譲を有効にするために説明的な `description` フィールドを使用する
221 * ツールアクセスを各 subagent が実際に必要なものに制限する
222 * 詳細な例については、[subagents ドキュメント](/ja/sub-agents)を確認する
223</Tip>
224
225***
226
227## Plan Mode を使用して安全なコード分析を行う
228
229Plan Mode は Claude に読み取り専用操作でコードベースを分析して計画を作成するよう指示します。これはコードベースの探索、複雑な変更の計画、またはコードの安全なレビューに最適です。Plan Mode では、Claude は [`AskUserQuestion`](/ja/tools-reference)を使用して要件を収集し、計画を提案する前に目標を明確にします。
230
231### Plan Mode を使用する場合
232
233* **マルチステップの実装**：機能が多くのファイルへの編集を必要とする場合
234* **コード探索**：何かを変更する前にコードベースを徹底的に調査したい場合
235* **インタラクティブな開発**：Claude との方向性について反復したい場合
236
237### Plan Mode の使用方法
238
239**セッション中に Plan Mode をオンにする**
240
241**Shift+Tab** を使用してセッション中に Plan Mode に切り替えることができます。
242
243Normal Mode にいる場合、**Shift+Tab** は最初に Auto-Accept Mode に切り替わります。これはターミナルの下部に `⏵⏵ accept edits on` で示されます。その後の **Shift+Tab** は Plan Mode に切り替わります。これは `⏸ plan mode on` で示されます。
244
245**Plan Mode で新しいセッションを開始する**
246
247Plan Mode で新しいセッションを開始するには、`--permission-mode plan` フラグを使用します：
248
249```bash theme={null}
250claude --permission-mode plan
251```
252
253**Plan Mode で「ヘッドレス」クエリを実行する**
254
255[「ヘッドレスモード」](/ja/headless)で `-p` を使用して Plan Mode でクエリを直接実行することもできます：
256
257```bash theme={null}
258claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"
259```
260
261### 例：複雑なリファクタリングの計画
262
263```bash theme={null}
264claude --permission-mode plan
265```
266
267```text theme={null}
268I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
269```
270
271Claude は現在の実装を分析し、包括的な計画を作成します。フォローアップで改善します：
272
273```text theme={null}
274What about backward compatibility?
275```
276
277```text theme={null}
278How should we handle database migration?
279```
280
281<Tip>`Ctrl+G` を押してデフォルトのテキストエディタで計画を開き、Claude が進める前に直接編集できます。</Tip>
282
283計画を受け入れると、Claude は計画コンテンツからセッションに自動的に名前を付けます。名前はプロンプトバーとセッションピッカーに表示されます。既に `--name` または `/rename` で名前を設定している場合、計画を受け入れてもそれは上書きされません。
284
285### Plan Mode をデフォルトとして設定する
286
287```json theme={null}
288// .claude/settings.json
289{
290 "permissions": {
291 "defaultMode": "plan"
292 }
293}
294```
295
296詳細な設定オプションについては、[設定ドキュメント](/ja/settings#available-settings)を参照してください。
297
298***
299
300## テストを使用する
301 181
302カバーされていないコードのテストを追加する必要があるとします。182カバーされていないコードのテストを追加する必要があるとします。
303 183
333 213
334***214***
335 215
336## プルリクエストを作成する216### プルリクエストを作成する
337 217
338Claude に直接プルリクエストを作成するよう依頼するか（「create a pr for my changes」）、ステップバイステップで Claude をガイドできます：218Claude に直接プルリクエストを作成するよう依頼するか（「create a pr for my changes」）、ステップバイステップで Claude をガイドできます：
339 219
357 </Step>237 </Step>
358</Steps>238</Steps>
359 239
360`gh pr create` を使用して PR を作成すると、セッションはその PR に自動的にリンクされます。後で `claude --from-pr <number>` で再開できます。240`gh pr create` を使用して PR を作成すると、セッションはその PR に自動的にリンクされます。後で `claude --from-pr <number>` で再開するか、[`/resume` ピッカー](/ja/sessions#use-the-session-picker)の検索に PR URL を貼り付けることで再開できます。
361 241
362<Tip>242<Tip>
363 Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。243 Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。
364</Tip>244</Tip>
365 245
366## ドキュメントを処理する246### ドキュメントを処理する
367 247
368コードのドキュメントを追加または更新する必要があるとします。248コードのドキュメントを追加または更新する必要があるとします。
369 249
403 283
404***284***
405 285
406## ノートと非コードフォルダで作業する286### ノートと非コードフォルダで作業する
407 287
408Claude Code はどのディレクトリでも機能します。ノートボルト、ドキュメントフォルダ、またはマークダウンファイルの任意のコレクション内で実行して、コードと同じ方法でコンテンツを検索、編集、再編成します。288Claude Code はどのディレクトリでも機能します。ノートボルト、ドキュメントフォルダ、またはマークダウンファイルの任意のコレクション内で実行して、コードと同じ方法でコンテンツを検索、編集、再編成します。
409 289
411 291
412***292***
413 293
414## 画像を使用する294### 画像を使用する
415 295
416コードベース内の画像を使用する必要があり、Claude の画像コンテンツ分析を支援したいとします。296コードベース内の画像を使用する必要があり、Claude の画像コンテンツ分析を支援したいとします。
417 297
471 351
472***352***
473 353
474## ファイルとディレクトリを参照する354### ファイルとディレクトリを参照する
475 355
476@ を使用して、Claude に読み込まれるのを待たずにファイルまたはディレクトリをすばやく含めます。356@ を使用して、Claude に読み込まれるのを待たずにファイルまたはディレクトリをすばやく含めます。
477 357
512 392
513***393***
514 394
515## 拡張思考（思考モード）を使用する395### スケジュールで Claude を実行する
516
517[拡張思考](https://platform.claude.com/docs/ja/build-with-claude/extended-thinking)はデフォルトで有効になっており、Claude が複雑な問題をステップバイステップで推論するためのスペースを提供します。この推論は詳細モードで表示され、`Ctrl+O` でオンに切り替えることができます。拡張思考中、スピナーは「still thinking」や「almost done thinking」などのインラインの進捗ヒントを表示し、Claude が積極的に作業していることを示します。
518
519さらに、[努力レベルをサポートするモデル](/ja/model-config#adjust-effort-level)は適応的推論を使用します。固定された思考トークン予算の代わりに、モデルは努力レベル設定とタスクに基づいて動的に思考を決定します。適応的推論により、Claude は日常的なプロンプトにより速く応答し、それから恩恵を受けるステップのためにより深い思考を予約できます。
520
521拡張思考は、複雑なアーキテクチャの決定、難しいバグ、マルチステップの実装計画、異なるアプローチ間のトレードオフの評価に特に価値があります。
522
523<Note>
524 「think」、「think hard」、「think more」などのフレーズは通常のプロンプト指示として解釈され、思考トークンを割り当てません。
525</Note>
526
527### 思考モードを設定する
528
529思考はデフォルトで有効になっていますが、調整または無効にできます。
530
531| スコープ | 設定方法 | 詳細 |
532| ---------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
533| **努力レベル** | `/effort` を実行するか、`/model` で調整するか、[`CLAUDE_CODE_EFFORT_LEVEL`](/ja/env-vars)を設定する | [サポートされているモデル](/ja/model-config#adjust-effort-level)での思考の深さを制御する |
534| **`ultrathink` キーワード** | プロンプトの任意の場所に「ultrathink」を含める | そのターンでモデルがより多く推論するよう指示するコンテキスト内指示を追加します。努力レベル自体は変更しません。[努力レベルを調整](/ja/model-config#adjust-effort-level)を参照してください |
535| **トグルショートカット** | `Option+T`（macOS）または `Alt+T`（Windows/Linux）を押す | 現在のセッションの思考をオン/オフに切り替えます（すべてのモデル）。[ターミナル設定](/ja/terminal-config)を有効にして Option キーショートカットを有効にする必要がある場合があります |
536| **グローバルデフォルト** | `/config` を使用して思考モードをトグルする | すべてのプロジェクト全体でデフォルトを設定します（すべてのモデル）。<br />`~/.claude/settings.json` に `alwaysThinkingEnabled` として保存されます |
537| **トークン予算を制限する** | [`MAX_THINKING_TOKENS`](/ja/env-vars)環境変数を設定する | 思考予算を特定のトークン数に制限します。適応的推論を備えたモデルでは、適応的推論が無効になっていない限り `0` に設定されている場合のみ適用されます。例：`export MAX_THINKING_TOKENS=10000` |
538
539Claude の思考プロセスを表示するには、`Ctrl+O` を押して詳細モードをトグルし、グレーのイタリック体で表示される内部推論を確認します。
540
541### 拡張思考の仕組み
542
543拡張思考は、Claude が応答する前に実行する内部推論の量を制御します。より多くの思考により、ソリューションを探索し、エッジケースを分析し、間違いを自己修正するためのより多くのスペースが提供されます。
544
545[努力レベルをサポートするモデル](/ja/model-config#adjust-effort-level)では、思考は適応的推論を使用します。モデルは、選択した努力レベルに基づいて思考トークンを動的に割り当てます。これは速度と推論の深さのトレードオフを調整するための推奨される方法です。努力レベル自体を変更せずに、Claude がそのターンでより多くまたはより少なく思考することを望む場合は、プロンプトで直接そう言うか、`CLAUDE.md` で言うこともできます。
546
547古いモデルでは、思考は出力予算から最大 31,999 トークンの固定予算を使用します。[`MAX_THINKING_TOKENS`](/ja/env-vars)環境変数でこれを制限するか、`/config` または `Option+T`/`Alt+T` トグルで思考を完全に無効にできます。
548
549適応的推論を備えたモデルでは、`MAX_THINKING_TOKENS` は `0` に設定されている場合のみ適用されます。または `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` は、これらのモデルを固定予算に戻します。`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` は Opus 4.6 と Sonnet 4.6 にのみ適用されます。Opus 4.7 は常に適応的推論を使用し、固定思考予算をサポートしていません。[環境変数](/ja/env-vars)を参照してください。
550
551<Warning>
552 思考の要約が編集されている場合でも、使用されたすべての思考トークンに対して課金されます。インタラクティブモードでは、思考はデフォルトで折りたたまれたスタブとして表示されます。`settings.json` で `showThinkingSummaries: true` を設定して、完全な要約を表示します。
553</Warning>
554
555***
556
557## 以前の会話を再開する
558
559Claude Code を開始するときは、以前のセッションを再開できます：
560
561* `claude --continue` は現在のディレクトリで最新の会話を続行します
562* `claude --resume` は会話ピッカーを開くか、名前で再開します
563* `claude --from-pr 123` は特定のプルリクエストにリンクされたセッションを再開します
564
565アクティブなセッション内から、`/resume` を使用して別の会話に切り替えます。
566
567選択したセッションが古く、それを再度読み込むことが使用制限の実質的な部分を消費するほど大きい場合、`--resume`、`--continue`、および `/resume` は完全なトランスクリプトを読み込む代わりに、サマリーから再開することを提案します。このプロンプトは Amazon Bedrock、Google Cloud Vertex AI、または Microsoft Foundry では利用できません。
568
569セッションはプロジェクトディレクトリごとに保存されます。デフォルトでは、`/resume` ピッカーは現在の worktree からのインタラクティブセッションを表示し、リストを他の worktree またはプロジェクトに広げるためのキーボードショートカット、検索、プレビュー、名前変更があります。[以下のセッションピッカーを使用](#use-the-session-picker)を参照してください。
570
571別の worktree の同じリポジトリからセッションを選択すると、Claude Code はディレクトリを切り替える必要なく直接再開します。関連のないプロジェクトからセッションを選択すると、`cd` と再開コマンドをクリップボードにコピーします。
572
573名前で再開すると、現在のリポジトリとその worktree 全体で解決されます。`claude --resume <name>` と `/resume <name>` の両方が完全一致を探し、セッションが別の worktree に存在する場合でも直接再開します。
574
575名前があいまいな場合、`claude --resume <name>` はピッカーを開き、名前を検索用語として事前入力します。`/resume <name>` をセッション内から実行すると、代わりにエラーが報告されるため、`/resume` を引数なしで実行してピッカーを開き、選択します。
576
577`claude -p` または SDK 呼び出しで作成されたセッションはピッカーに表示されませんが、セッション ID をそのまま `claude --resume <session-id>` に渡すことで再開できます。
578
579### セッションに名前を付ける
580
581セッションに説明的な名前を付けて、後で見つけやすくします。これは複数のタスクまたは機能に取り組むときのベストプラクティスです。
582
583<Steps>
584 <Step title="セッションに名前を付ける">
585 起動時に `-n` でセッションに名前を付けます：
586
587 ```bash theme={null}
588 claude -n auth-refactor
589 ```
590
591 またはセッション中に `/rename` を使用します。これはプロンプトバーに名前も表示します：
592
593 ```text theme={null}
594 /rename auth-refactor
595 ```
596
597 ピッカーから任意のセッションの名前を変更することもできます。`/resume` を実行し、セッションに移動して、`Ctrl+R` を押します。
598 </Step>
599
600 <Step title="後で名前で再開する">
601 コマンドラインから：
602
603 ```bash theme={null}
604 claude --resume auth-refactor
605 ```
606
607 またはアクティブなセッション内から：
608
609 ```text theme={null}
610 /resume auth-refactor
611 ```
612 </Step>
613</Steps>
614
615### セッションピッカーを使用する
616
617`/resume` コマンド（または引数なしの `claude --resume`）は、次の機能を備えたインタラクティブセッションピッカーを開きます：
618
619**ピッカーのキーボードショートカット：**
620
621| ショートカット | アクション |
622| :--------------------------- | :------------------------------------------------------------------------------------------ |
623| `↑` / `↓` | セッション間を移動する |
624| `→` / `←` | グループ化されたセッションを展開または折りたたむ |
625| `Enter` | ハイライトされたセッションを選択して再開する |
626| `Space` | セッションコンテンツをプレビューする。`Ctrl+V` も、ターミナルがペーストとしてキャプチャしないターミナルで機能します |
627| `Ctrl+R` | ハイライトされたセッションの名前を変更する |
628| `/` または `Space` 以外の任意の印字可能文字 | 検索モードに入り、セッションをフィルタリングする |
629| `Ctrl+A` | このマシン上のすべてのプロジェクトからセッションを表示します。もう一度押すと現在のリポジトリを復元します |
630| `Ctrl+W` | 現在のリポジトリのすべての worktree からセッションを表示します。もう一度押すと現在の worktree を復元します。マルチ worktree リポジトリでのみ表示されます |
631| `Ctrl+B` | 現在の git ブランチからのセッションにフィルタリングします。もう一度押すとすべてのブランチからのセッションを表示します |
632| `Esc` | ピッカーまたは検索モードを終了する |
633
634**セッション組織：**
635
636ピッカーは有用なメタデータを含むセッションを表示します：
637
638* セッション名（設定されている場合）、そうでない場合は会話の要約または最初のユーザープロンプト
639* 最後のアクティビティからの経過時間
640* メッセージ数
641* Git ブランチ（該当する場合）
642* `Ctrl+A` ですべてのプロジェクトに広げた後に表示されるプロジェクトパス
643
644フォークされたセッション（`/branch`、`/rewind`、または `--fork-session` で作成）はルートセッションの下にグループ化され、関連する会話を見つけやすくなります。
645
646<Tip>
647 ヒント：
648
649 * **セッションを早期に名前付ける**：異なるタスクで作業を開始するときに `/rename` を使用します。後で「payment-integration」を見つける方が「explain this function」よりもはるかに簡単です
650 * 現在のディレクトリで最新の会話にすばやくアクセスするには `--continue` を使用します
651 * 必要なセッションがわかっている場合は `--resume session-name` を使用します
652 * 参照して選択する必要がある場合は `--resume`（名前なし）を使用します
653 * スクリプトの場合は、`claude --continue --print "prompt"` を使用して非対話モードで再開します
654 * ピッカーで `Space` を押して、セッションを再開する前にプレビューします
655 * 再開された会話は、元のセッションと同じモデルと設定で開始されます
656
657 仕組み：
658
659 1. **会話ストレージ**：すべての会話は完全なメッセージ履歴とともにローカルに自動保存されます
660 2. **メッセージ逆シリアル化**：再開時に、コンテキストを維持するために全メッセージ履歴が復元されます
661 3. **ツール状態**：前の会話からのツール使用と結果が保持されます
662 4. **コンテキスト復元**：会話は前のすべてのコンテキストを保持して再開されます
663</Tip>
664
665***
666
667## Git worktree を使用して並列 Claude Code セッションを実行する
668
669複数のタスクに同時に取り組む場合、各 Claude セッションがコードベースの独自のコピーを持つ必要があります。そうしないと変更が衝突します。Git worktree は、同じリポジトリ履歴とリモート接続を共有しながら、独自のファイルとブランチを持つ個別の作業ディレクトリを作成することで、この問題を解決します。つまり、Claude が 1 つの worktree で機能に取り組んでいる間に、別の worktree でバグを修正でき、どちらのセッションも相互に干渉しません。
670
671`--worktree`（`-w`）フラグを使用して、分離された worktree を作成し、Claude をその中で開始します。渡す値は worktree ディレクトリ名とブランチ名になります：
672
673```bash theme={null}
674# "feature-auth" という名前の worktree で Claude を開始する
675# 新しいブランチで .claude/worktrees/feature-auth/ を作成する
676claude --worktree feature-auth
677
678# 別の worktree で別のセッションを開始する
679claude --worktree bugfix-123
680```
681
682名前を省略すると、Claude は自動的にランダムな名前を生成します：
683
684```bash theme={null}
685# "bright-running-fox" のような名前を自動生成する
686claude --worktree
687```
688
689Worktree は `<repo>/.claude/worktrees/<name>` に作成され、デフォルトのリモートブランチから分岐します。これは `origin/HEAD` が指すところです。worktree ブランチは `worktree-<name>` という名前が付けられます。
690
691ベースブランチは Claude Code フラグまたは設定を通じて設定できません。`origin/HEAD` はクローン時に Git が設定したローカル `.git` ディレクトリに保存される参照です。リポジトリのデフォルトブランチが後で GitHub または GitLab で変更された場合、ローカル `origin/HEAD` は古いものを指し続け、worktree はそこから分岐します。ローカル参照をリモートが現在デフォルトと見なしているものと再同期するには：
692
693```bash theme={null}
694git remote set-head origin -a
695```
696
697これは、ローカル `.git` ディレクトリのみを更新する標準 Git コマンドです。リモートサーバーでは何も変わりません。worktree が特定のブランチではなくリモートのデフォルトに基づくようにしたい場合は、`git remote set-head origin your-branch-name` で明示的に設定します。
698
699worktree の作成方法を完全に制御するには、[WorktreeCreate フック](/ja/hooks#worktreecreate)を設定します。フックは Claude Code のデフォルト `git worktree` ロジックを完全に置き換えるため、必要な ref から取得してブランチできます。
700
701セッション中に Claude に「work in a worktree」または「start a worktree」を依頼することもでき、自動的に作成されます。
702
703### Subagent worktree
704
705Subagent は worktree 分離を使用して、競合なしに並列で作業することもできます。Claude に「use worktrees for your agents」を依頼するか、[カスタム subagent](/ja/sub-agents#supported-frontmatter-fields)で `isolation: worktree` をエージェントのフロントマターに追加して設定します。各 subagent は独自の worktree を取得し、変更なしで subagent が終了すると自動的にクリーンアップされます。
706
707### Worktree クリーンアップ
708
709worktree セッションを終了すると、Claude は変更があったかどうかに基づいてクリーンアップを処理します：
710
711* **変更なし**：worktree とそのブランチは自動的に削除されます
712* **変更またはコミットが存在する**：Claude は worktree を保持するか削除するかをプロンプトします。保持するとディレクトリとブランチが保存され、後で戻ることができます。削除すると worktree ディレクトリとそのブランチが削除され、すべてのコミットされていない変更とコミットが破棄されます
713
714Subagent worktree は、subagent が変更なしで終了すると自動的にクリーンアップされます。クラッシュまたは中断された並列実行によって孤立した subagent worktree は、[`cleanupPeriodDays`](/ja/settings#available-settings)設定より古い場合、コミットされていない変更、追跡されていないファイル、プッシュされていないコミットがない場合、起動時に自動的に削除されます。`--worktree` で作成した worktree は、このスイープによって削除されることはありません。
715
716Claude セッション外で worktree をクリーンアップするには、[worktree を手動で管理](#manage-worktrees-manually)を使用します。
717
718<Tip>
719 `.claude/worktrees/` を `.gitignore` に追加して、worktree コンテンツがメインリポジトリに追跡されていないファイルとして表示されるのを防ぎます。
720</Tip>
721
722### Worktree に gitignored ファイルをコピーする
723
724Git worktree は新しいチェックアウトなので、メインリポジトリから `.env` や `.env.local` などの追跡されていないファイルは含まれません。Claude が worktree を作成するときにこれらのファイルを自動的にコピーするには、プロジェクトルートに `.worktreeinclude` ファイルを追加します。
725
726ファイルは `.gitignore` 構文を使用して、コピーするファイルをリストします。パターンに一致し、gitignored されているファイルのみがコピーされるため、追跡されたファイルは決して複製されません。
727
728```text .worktreeinclude theme={null}
729.env
730.env.local
731config/secrets.json
732```
733
734これは `--worktree`、subagent worktree、および[デスクトップアプリ](/ja/desktop#work-in-parallel-with-sessions)の並列セッションで作成された worktree に適用されます。
735
736### Worktree を手動で管理する
737
738worktree の場所とブランチ設定をより細かく制御するには、Git を使用して worktree を直接作成します。これは特定の既存ブランチをチェックアウトするか、worktree をリポジトリの外に配置する必要がある場合に便利です。
739
740```bash theme={null}
741# 新しいブランチで worktree を作成する
742git worktree add ../project-feature-a -b feature-a
743
744# 既存のブランチで worktree を作成する
745git worktree add ../project-bugfix bugfix-123
746
747# worktree で Claude を開始する
748cd ../project-feature-a && claude
749
750# 完了したらクリーンアップする
751git worktree list
752git worktree remove ../project-feature-a
753```
754
755詳細については、[公式 Git worktree ドキュメント](https://git-scm.com/docs/git-worktree)を参照してください。
756
757<Tip>
758 プロジェクトのセットアップに従って、各新しい worktree で開発環境を初期化することを忘れないでください。スタックに応じて、これには依存関係のインストール（`npm install`、`yarn`）、仮想環境のセットアップ、またはプロジェクトの標準セットアップ手順に従うことが含まれる場合があります。
759</Tip>
760
761### Git 以外のバージョン管理
762
763Worktree 分離はデフォルトで git で機能します。SVN、Perforce、Mercurial などの他のバージョン管理システムの場合は、[WorktreeCreate と WorktreeRemove フック](/ja/hooks#worktreecreate)を設定して、カスタム worktree 作成とクリーンアップロジックを提供します。設定されている場合、これらのフックは `--worktree` を使用するときにデフォルトの git 動作を置き換えます。そのため、[`.worktreeinclude`](#copy-gitignored-files-to-worktrees)は処理されません。フックスクリプト内でローカル設定ファイルをコピーしてください。
764
765共有タスクとメッセージングを使用した並列セッションの自動調整については、[エージェントチーム](/ja/agent-teams)を参照してください。
766
767***
768
769## Claude が注意を必要とするときに通知を受け取る
770
771長時間実行されるタスクを開始して別のウィンドウに切り替えるときは、Claude が終了したときまたは入力が必要なときに知ることができるようにデスクトップ通知を設定できます。これは `Notification` [フックイベント](/ja/hooks-guide#get-notified-when-claude-needs-input)を使用します。これは Claude が許可を待っている、アイドル状態で新しいプロンプトの準備ができている、または認証を完了しているときはいつでも発火します。
772
773<Steps>
774 <Step title="設定にフックを追加する">
775 `~/.claude/settings.json` を開き、プラットフォームのネイティブ通知コマンドを呼び出す `Notification` フックを追加します：
776
777 <Tabs>
778 <Tab title="macOS">
779 ```json theme={null}
780 {
781 "hooks": {
782 "Notification": [
783 {
784 "matcher": "",
785 "hooks": [
786 {
787 "type": "command",
788 "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
789 }
790 ]
791 }
792 ]
793 }
794 }
795 ```
796 </Tab>
797
798 <Tab title="Linux">
799 ```json theme={null}
800 {
801 "hooks": {
802 "Notification": [
803 {
804 "matcher": "",
805 "hooks": [
806 {
807 "type": "command",
808 "command": "notify-send 'Claude Code' 'Claude Code needs your attention'"
809 }
810 ]
811 }
812 ]
813 }
814 }
815 ```
816 </Tab>
817
818 <Tab title="Windows">
819 ```json theme={null}
820 {
821 "hooks": {
822 "Notification": [
823 {
824 "matcher": "",
825 "hooks": [
826 {
827 "type": "command",
828 "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
829 }
830 ]
831 }
832 ]
833 }
834 }
835 ```
836 </Tab>
837 </Tabs>
838
839 設定ファイルに既に `hooks` キーがある場合は、上書きするのではなく `Notification` エントリをマージします。CLI で説明したいことを説明することで、Claude にフックを書くよう依頼することもできます。
840 </Step>
841
842 <Step title="オプションでマッチャーを絞り込む">
843 デフォルトでは、フックはすべての通知タイプで発火します。特定のイベントのみで発火させるには、`matcher` フィールドを次のいずれかの値に設定します：
844
845 | マッチャー | 発火する場合 |
846 | :--------------------- | :-------------------------- |
847 | `permission_prompt` | Claude がツール使用を承認する必要がある場合 |
848 | `idle_prompt` | Claude が完了し、次のプロンプトを待っている場合 |
849 | `auth_success` | 認証が完了する場合 |
850 | `elicitation_dialog` | MCP サーバーが誘導フォームを開く場合 |
851 | `elicitation_complete` | MCP 誘導フォームが送信またはキャンセルされる場合 |
852 | `elicitation_response` | MCP 誘導応答がサーバーに送り返される場合 |
853 </Step>
854
855 <Step title="フックを検証する">
856 `/hooks` と入力し、`Notification` を選択して、フックが表示されることを確認します。選択すると、実行されるコマンドが表示されます。エンドツーエンドでテストするには、Claude に許可が必要なコマンドを実行するよう依頼してターミナルから離れるか、Claude に通知を直接トリガーするよう依頼します。
857 </Step>
858</Steps>
859
860完全なイベントスキーマと通知タイプについては、[通知リファレンス](/ja/hooks#notification)を参照してください。
861
862***
863
864## Claude を unix スタイルのユーティリティとして使用する
865
866### 検証プロセスに Claude を追加する
867
868Claude Code をリンターまたはコードレビューアーとして使用したいとします。
869
870**ビルドスクリプトに Claude を追加する：**
871
872```json theme={null}
873// package.json
874{
875 ...
876 "scripts": {
877 ...
878 "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.'"
879 }
880}
881```
882
883<Tip>
884 ヒント：
885
886 * CI/CD パイプラインで自動コードレビューに Claude を使用する
887 * プロンプトをカスタマイズして、プロジェクトに関連する特定の問題をチェックする
888 * 異なるタイプの検証用に複数のスクリプトを作成することを検討する
889</Tip>
890
891### パイプイン、パイプアウト
892
893Claude にデータをパイプインし、構造化された形式でデータを取得したいとします。
894
895**Claude を通じてデータをパイプする：**
896
897```bash theme={null}
898cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt
899```
900
901<Tip>
902 ヒント：
903
904 * パイプを使用して Claude を既存のシェルスクリプトに統合する
905 * 他の Unix ツールと組み合わせて強力なワークフローを作成する
906 * 構造化出力に `--output-format` を使用することを検討する
907</Tip>
908
909### 出力形式を制御する
910
911特に Claude Code をスクリプトまたは他のツールに統合する場合、Claude の出力が特定の形式である必要があるとします。
912
913<Steps>
914 <Step title="テキスト形式を使用する（デフォルト）">
915 ```bash theme={null}
916 cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt
917 ```
918
919 これは Claude のプレーンテキスト応答のみを出力します（デフォルトの動作）。
920 </Step>
921
922 <Step title="JSON 形式を使用する">
923 ```bash theme={null}
924 cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json
925 ```
926
927 これは、コストと期間を含むメタデータを含むメッセージの JSON 配列を出力します。
928 </Step>
929
930 <Step title="ストリーミング JSON 形式を使用する">
931 ```bash theme={null}
932 cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json
933 ```
934
935 これは、Claude がリクエストを処理するときにリアルタイムで一連の JSON オブジェクトを出力します。各メッセージは有効な JSON オブジェクトですが、連結された場合、全体の出力は有効な JSON ではありません。
936 </Step>
937</Steps>
938
939<Tip>
940 ヒント：
941
942 * Claude の応答だけが必要な単純な統合には `--output-format text` を使用する
943 * 完全な会話ログが必要な場合は `--output-format json` を使用する
944 * 各会話ターンのリアルタイム出力には `--output-format stream-json` を使用する
945</Tip>
946
947***
948
949## Claude をスケジュールで実行する
950 396
951Claude に長時間実行されるタスクを自動的に定期的に処理させたいとします。例えば、毎朝オープン PR をレビューしたり、毎週依存関係を監査したり、夜間に CI の失敗をチェックしたりします。397Claude に長時間実行されるタスクを自動的に定期的に処理させたいとします。例えば、毎朝オープン PR をレビューしたり、毎週依存関係を監査したり、夜間に CI の失敗をチェックしたりします。
952 398
953実行場所に基づいてスケジューリングオプションを選択します：399実行場所に基づいてスケジューリングオプションを選択します：
954 400
955| オプション | 実行場所 | 最適な用途 |401| オプション | 実行場所 | 最適な用途 |
956| :----------------------------------------------- | :--------------------- | :------------------------------------------------------------------------------------------- |402| :----------------------------------------------- | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
957| [ルーチン](/ja/routines) | Anthropic 管理インフラストラクチャ | コンピュータがオフの場合でも実行する必要があるタスク。[claude.ai/code/routines](https://claude.ai/code/routines)で設定します。 |403| [ルーチン](/ja/routines) | Anthropic 管理インフラストラクチャ | コンピュータがオフの場合でも実行する必要があるタスク。[claude.ai/code/routines](https://claude.ai/code/routines)で設定します。API 呼び出しまたは GitHub イベントに加えてスケジュールでトリガーすることもできます。 |
958| [デスクトップスケジュール済みタスク](/ja/desktop-scheduled-tasks) | デスクトップアプリ経由のマシン | ローカルファイル、ツール、またはコミットされていない変更への直接アクセスが必要なタスク。 |404| [デスクトップスケジュール済みタスク](/ja/desktop-scheduled-tasks) | デスクトップアプリ経由のマシン | ローカルファイル、ツール、またはコミットされていない変更への直接アクセスが必要なタスク。 |
959| [GitHub Actions](/ja/github-actions) | CI パイプライン | オープン PR などのリポジトリイベント、またはワークフロー設定と一緒に存在する必要がある cron スケジュールに関連するタスク。 |405| [GitHub Actions](/ja/github-actions) | CI パイプライン | オープン PR などのリポジトリイベント、またはワークフロー設定と一緒に存在する必要がある cron スケジュールに関連するタスク。 |
960| [`/loop`](/ja/scheduled-tasks) | 現在の CLI セッション | セッションが開いている間のクイックポーリング。タスクは新しい会話を開始すると停止します。`--resume` と `--continue` は期限切れでないものを復元します。 |406| [`/loop`](/ja/scheduled-tasks) | 現在の CLI セッション | セッションが開いている間のクイックポーリング。タスクは新しい会話を開始すると停止します。`--resume` と `--continue` は期限切れでないものを復元します。 |
961 407
962<Tip>408<Tip>
963 スケジュール済みタスク用のプロンプトを作成するときは、成功がどのように見えるか、および結果をどうするかについて明示的に説明してください。タスクは自律的に実行されるため、質問を明確にすることはできません。例えば：'`needs-review` ラベルが付いたオープン PR をレビューし、問題に関するインラインコメントを残し、`#eng-reviews` Slack チャネルに要約を投稿します。'409 スケジュール済みタスク用のプロンプトを作成するときは、成功がどのように見えるか、および結果をどうするかについて明示的に説明してください。タスクは自律的に実行されるため、質問を明確にすることはできません。例えば：「`needs-review` ラベルが付いたオープン PR をレビューし、問題に関するインラインコメントを残し、`#eng-reviews` Slack チャネルに要約を投稿します。」
964</Tip>410</Tip>
965 411
966***412***
967 413
968## Claude にその機能について質問する414### Claude にその機能について質問する
969 415
970Claude は自分のドキュメントへの組み込みアクセスを持っており、自分の機能と制限について質問に答えることができます。416Claude は自分のドキュメントへの組み込みアクセスを持っており、自分の機能と制限について質問に答えることができます。
971 417
972### 質問例418#### 質問例
973 419
974```text theme={null}420```text theme={null}
975can Claude Code create pull requests?421can Claude Code create pull requests?
1009 455
1010***456***
1011 457
458## 以前の会話を再開する
459
460タスクが複数回に分けて実行される場合は、コンテキストを再度説明するのではなく、中断したところから再開してください。Claude Code はすべての会話をローカルに保存します。
461
462```bash theme={null}
463claude --continue
464```
465
466これにより、現在のディレクトリで最新のセッションが再開されます。まだセッションがない場合は、`No conversation found to continue` と出力して終了します。`claude --resume` を使用してリストから選択するか、実行中のセッション内から `/resume` を使用してください。[セッションを管理する](/ja/sessions)を参照して、名前付け、ブランチ、および完全なピッカーリファレンスを確認してください。
467
468## worktree を使用して並列セッションを実行する
469
4701 つのターミナルで機能に取り組みながら、別のターミナルで Claude がバグを修正するようにします。編集が衝突しないようにしてください。各 worktree は独自のブランチ上の個別のチェックアウトです。
471
472```bash theme={null}
473claude --worktree feature-auth
474```
475
476別の名前で 2 番目のターミナルで同じコマンドを実行して、分離された並列セッションを開始します。[Worktrees](/ja/worktrees)を参照して、クリーンアップ、`.worktreeinclude`、および非 git VCS サポートを確認してください。1 つの画面から並列セッションを監視するには、[バックグラウンドエージェント](/ja/agent-view)を参照してください。
477
478## 編集前に計画する
479
480ディスクに変更を加える前に確認したい変更については、計画モードに切り替えてください。Claude はファイルを読み込んで計画を提案しますが、承認されるまで編集は行いません。
481
482```bash theme={null}
483claude --permission-mode plan
484```
485
486セッション中に `Shift+Tab` を押して計画モードに切り替えることもできます。[計画モード](/ja/permission-modes#analyze-before-you-edit-with-plan-mode)を参照して、承認フローとテキストエディタで計画を編集することを確認してください。
487
488## 研究を subagent に委譲する
489
490大規模なコードベースの探索はコンテキストをファイル読み込みで満たします。探索を委譲して、結果のみが戻るようにしてください。
491
492```text theme={null}
493use a subagent to investigate how our auth system handles token refresh
494```
495
496subagent は独自のコンテキストウィンドウでファイルを読み込み、要約を報告します。[Subagents](/ja/sub-agents)を参照して、独自のツールとプロンプトを持つカスタムエージェントを定義することを確認してください。
497
498## Claude をスクリプトにパイプする
499
500CI、プリコミットフック、またはバッチ処理用に Claude を非対話的に実行します。stdin と stdout は任意の Unix ツールのように機能します。
501
502```bash theme={null}
503git log --oneline -20 | claude -p "summarize these recent commits"
504```
505
506[非対話モード](/ja/headless)を参照して、出力形式、許可フラグ、およびファンアウトパターンを確認してください。
507
1012## 次のステップ508## 次のステップ
1013 509
1014<CardGroup cols={2}>510<CardGroup cols={2}>
1016 Claude Code から最大限の価値を得るためのパターン512 Claude Code から最大限の価値を得るためのパターン
1017 </Card>513 </Card>
1018 514
1019 <Card title="Claude Code の仕組み" icon="gear" href="/ja/how-claude-code-works">515 <Card title="セッションを管理する" icon="rotate-left" href="/ja/sessions">
1020 agentic ループとコンテキスト管理を理解する516 会話を再開、名前付け、ブランチする
1021 </Card>517 </Card>
1022 518
1023 <Card title="Claude Code を拡張する" icon="puzzle-piece" href="/ja/features-overview">519 <Card title="Worktrees" icon="code-branch" href="/ja/worktrees">
1024 skill、フック、MCP、subagent、プラグインを追加する520 分離された並列セッションを実行する
1025 </Card>521 </Card>
1026 522
1027 <Card title="リファレンス実装" icon="code" href="https://github.com/anthropics/claude-code/tree/main/.devcontainer">523 <Card title="Claude Code を拡張する" icon="puzzle-piece" href="/ja/features-overview">
1028 開発コンテナリファレンス実装をクローンする524 skill、フック、MCP、subagent、プラグインを追加する
1029 </Card>525 </Card>
1030</CardGroup>526</CardGroup>
