17* [研究を subagent に委譲する](#delegate-research-to-subagents)：メインコンテキストをクリーンに保つ17* [研究を subagent に委譲する](#delegate-research-to-subagents)：メインコンテキストをクリーンに保つ
18* [Claude をスクリプトにパイプする](#pipe-claude-into-scripts)：CI とバッチ処理用18* [Claude をスクリプトにパイプする](#pipe-claude-into-scripts)：CI とバッチ処理用
19 19
20<h2 id="prompt-recipes">20## プロンプトレシピ
21 プロンプトレシピ
22</h2>
23 21
24これらは、未知のコード探索、デバッグ、リファクタリング、テスト作成、PR 作成などの日常的なタスク用のプロンプトパターンです。各パターンは任意の Claude Code サーフェスで機能します。プロジェクトに合わせて表現を調整してください。22これらは、未知のコード探索、デバッグ、リファクタリング、テスト作成、PR 作成などの日常的なタスク用のプロンプトパターンです。各パターンは任意の Claude Code サーフェスで機能します。プロジェクトに合わせて表現を調整してください。
25 23
26<h3 id="understand-new-codebases">24### 新しいコードベースを理解する
27 新しいコードベースを理解する
28</h3>
29 25
30モノレポまたは大規模なコードベースで Claude Code を設定する場合は、[モノレポと大規模リポジトリ](/docs/ja/large-codebases)を参照してください。26モノレポまたは大規模なコードベースで Claude Code を設定する場合は、[モノレポと大規模リポジトリ](/docs/ja/large-codebases)を参照してください。
31 27
32<h4 id="get-a-quick-codebase-overview">28#### コードベースの概要を素早く把握する
33 コードベースの概要を素早く把握する
34</h4>
35 29
36新しいプロジェクトに参加したばかりで、その構造を素早く理解する必要があるとします。30新しいプロジェクトに参加したばかりで、その構造を素早く理解する必要があるとします。
37 31
38<Steps>32**1. プロジェクトルートディレクトリに移動する**
39 <Step title="プロジェクトルートディレクトリに移動する">33
40 ```bash theme={null}34```bash theme={null}
41 cd /path/to/project 35cd /path/to/project
42 ```36```
43 37
44 `/path/to/project` をプロジェクトへのパスに置き換えてください。38`/path/to/project` をプロジェクトへのパスに置き換えてください。
45 </Step>39
46 40**2. Claude Code を起動する**
47 <Step title="Claude Code を起動する">41
48 ```bash theme={null}42```bash theme={null}
49 claude 43claude
50 ```44```
51 </Step>45
52 46**3. 高レベルの概要をリクエストする**
53 <Step title="高レベルの概要をリクエストする">47
54 ```text wrap theme={null}48```text wrap theme={null}
55 give me an overview of this codebase49give me an overview of this codebase
56 ```50```
57 </Step>51
58 52**4. 特定のコンポーネントについてさらに詳しく調べる**
59 <Step title="特定のコンポーネントについてさらに詳しく調べる">53
60 ```text wrap theme={null}54```text wrap theme={null}
61 explain the main architecture patterns used here55explain the main architecture patterns used here
62 ```56```
63 57
64 ```text wrap theme={null}58```text wrap theme={null}
65 what are the key data models?59what are the key data models?
66 ```60```
67 61
68 ```text wrap theme={null}62```text wrap theme={null}
69 how is authentication handled?63how is authentication handled?
70 ```64```
71 </Step>65
72</Steps>66> [!TIP]
73 67>
74<Tip>68> ヒント：
75 ヒント：69>
76 70> * 広い質問から始めて、特定の領域に絞り込んでいく
77 * 広い質問から始めて、特定の領域に絞り込んでいく71> * プロジェクトで使用されているコーディング規約とパターンについて質問する
78 * プロジェクトで使用されているコーディング規約とパターンについて質問する72> * プロジェクト固有の用語の用語集をリクエストする
79 * プロジェクト固有の用語の用語集をリクエストする73
80</Tip>74#### 関連するコードを見つける
81
82<h4 id="find-relevant-code">
83 関連するコードを見つける
84</h4>
85 75
86特定の機能または機能に関連するコードを見つける必要があるとします。76特定の機能または機能に関連するコードを見つける必要があるとします。
87 77
88<Steps>78**1. Claude に関連ファイルを見つけるよう依頼する**
89 <Step title="Claude に関連ファイルを見つけるよう依頼する">79
90 ```text wrap theme={null}80```text wrap theme={null}
91 find the files that handle user authentication81find the files that handle user authentication
92 ```82```
93 </Step>83
94 84**2. コンポーネントがどのように相互作用するかについてのコンテキストを取得する**
95 <Step title="コンポーネントがどのように相互作用するかについてのコンテキストを取得する">85
96 ```text wrap theme={null}86```text wrap theme={null}
97 how do these authentication files work together?87how do these authentication files work together?
98 ```88```
99 </Step>89
100 90**3. 実行フローを理解する**
101 <Step title="実行フローを理解する">91
102 ```text wrap theme={null}92```text wrap theme={null}
103 trace the login process from front-end to database93trace the login process from front-end to database
104 ```94```
105 </Step>95
106</Steps>96> [!TIP]
107 97>
108<Tip>98> ヒント：
109 ヒント：99>
110 100> * 探しているものについて具体的に説明する
111 * 探しているものについて具体的に説明する101> * プロジェクトのドメイン言語を使用する
112 * プロジェクトのドメイン言語を使用する102> * 言語の[コード インテリジェンス プラグイン](/docs/ja/plugins/code-intelligence)をインストールして、Claude に正確な「定義に移動」と「参照を検索」のナビゲーションを提供する
113 * 言語の[コード インテリジェンス プラグイン](/docs/ja/plugins/code-intelligence)をインストールして、Claude に正確な「定義に移動」と「参照を検索」のナビゲーションを提供する
114</Tip>
115 103
116***104***
117 105
118<h3 id="fix-bugs-efficiently">106### バグを効率的に修正する
119 バグを効率的に修正する
120</h3>
121 107
122エラーメッセージが表示され、そのソースを見つけて修正する必要があるとします。108エラーメッセージが表示され、そのソースを見つけて修正する必要があるとします。
123 109
124<Steps>110**1. Claude とエラーを共有する**
125 <Step title="Claude とエラーを共有する">111
126 ```text wrap theme={null}112```text wrap theme={null}
127 I'm seeing an error when I run npm test113I'm seeing an error when I run npm test
128 ```114```
129 </Step>115
130 116**2. 修正の推奨事項をリクエストする**
131 <Step title="修正の推奨事項をリクエストする">117
132 ```text wrap theme={null}118```text wrap theme={null}
133 suggest a few ways to fix the @ts-ignore in user.ts119suggest a few ways to fix the @ts-ignore in user.ts
134 ```120```
135 </Step>121
136 122**3. 修正を適用する**
137 <Step title="修正を適用する">123
138 ```text wrap theme={null}124```text wrap theme={null}
139 update user.ts to add the null check you suggested125update user.ts to add the null check you suggested
140 ```126```
141 </Step>127
142</Steps>128> [!TIP]
143 129>
144<Tip>130> ヒント：
145 ヒント：131>
146 132> * Claude に問題を再現するコマンドとスタックトレースを伝える
147 * Claude に問題を再現するコマンドとスタックトレースを伝える133> * エラーを再現するための手順を記載する
148 * エラーを再現するための手順を記載する134> * エラーが断続的か一貫しているかを Claude に知らせる
149 * エラーが断続的か一貫しているかを Claude に知らせる
150</Tip>
151 135
152***136***
153 137
154<h3 id="refactor-code">138### コードをリファクタリングする
155 コードをリファクタリングする
156</h3>
157 139
158古いコードを最新のパターンとプラクティスを使用するように更新する必要があるとします。140古いコードを最新のパターンとプラクティスを使用するように更新する必要があるとします。
159 141
160コードベース全体を新しい言語に移植する場合は、ブログの[Anthropic が Claude Code で大規模なコード移行を実行する方法](https://claude.com/blog/ai-code-migration)を参照してください。142コードベース全体を新しい言語に移植する場合は、ブログの[Anthropic が Claude Code で大規模なコード移行を実行する方法](https://claude.com/blog/ai-code-migration)を参照してください。
161 143
162<Steps>144**1. リファクタリング対象のレガシーコードを特定する**
163 <Step title="リファクタリング対象のレガシーコードを特定する">145
164 ```text wrap theme={null}146```text wrap theme={null}
165 find deprecated API usage in our codebase147find deprecated API usage in our codebase
166 ```148```
167 </Step>149
168 150**2. リファクタリングの推奨事項を取得する**
169 <Step title="リファクタリングの推奨事項を取得する">151
170 ```text wrap theme={null}152```text wrap theme={null}
171 suggest how to refactor utils.js to use modern JavaScript features153suggest how to refactor utils.js to use modern JavaScript features
172 ```154```
173 </Step>155
174 156**3. 変更を安全に適用する**
175 <Step title="変更を安全に適用する">157
176 ```text wrap theme={null}158```text wrap theme={null}
177 refactor utils.js to use ES2024 features while maintaining the same behavior159refactor utils.js to use ES2024 features while maintaining the same behavior
178 ```160```
179 </Step>161
180 162**4. リファクタリングを検証する**
181 <Step title="リファクタリングを検証する">163
182 ```text wrap theme={null}164```text wrap theme={null}
183 run tests for the refactored code165run tests for the refactored code
184 ```166```
185 </Step>167
186</Steps>168> [!TIP]
187 169>
188<Tip>170> ヒント：
189 ヒント：171>
190 172> * Claude に最新のアプローチの利点を説明するよう依頼する
191 * Claude に最新のアプローチの利点を説明するよう依頼する173> * 必要に応じて変更が後方互換性を維持することをリクエストする
192 * 必要に応じて変更が後方互換性を維持することをリクエストする174> * リファクタリングを小さくテスト可能な増分で実行する
193 * リファクタリングを小さくテスト可能な増分で実行する
194</Tip>
195 175
196***176***
197 177
198<h3 id="work-with-tests">178### テストを使用する
199 テストを使用する
200</h3>
201 179
202カバーされていないコードのテストを追加する必要があるとします。180カバーされていないコードのテストを追加する必要があるとします。
203 181
204<Steps>182**1. テストされていないコードを特定する**
205 <Step title="テストされていないコードを特定する">183
206 ```text wrap theme={null}184```text wrap theme={null}
207 find functions in NotificationsService.swift that are not covered by tests185find functions in NotificationsService.swift that are not covered by tests
208 ```186```
209 </Step>187
210 188**2. テストスキャフォルディングを生成する**
211 <Step title="テストスキャフォルディングを生成する">189
212 ```text wrap theme={null}190```text wrap theme={null}
213 add tests for the notification service191add tests for the notification service
214 ```192```
215 </Step>193
216 194**3. 意味のあるテストケースを追加する**
217 <Step title="意味のあるテストケースを追加する">195
218 ```text wrap theme={null}196```text wrap theme={null}
219 add test cases for edge conditions in the notification service197add test cases for edge conditions in the notification service
220 ```198```
221 </Step>199
222 200**4. テストを実行して検証する**
223 <Step title="テストを実行して検証する">201
224 ```text wrap theme={null}202```text wrap theme={null}
225 run the new tests and fix any failures203run the new tests and fix any failures
226 ```204```
227 </Step>
228</Steps>
229 205
230Claude は、プロジェクトの既存のパターンと規約に従うテストを生成できます。テストをリクエストするときは、検証したい動作について具体的に説明してください。Claude は既存のテストファイルを調べて、既に使用されているスタイル、フレームワーク、アサーションパターンに一致させます。206Claude は、プロジェクトの既存のパターンと規約に従うテストを生成できます。テストをリクエストするときは、検証したい動作について具体的に説明してください。Claude は既存のテストファイルを調べて、既に使用されているスタイル、フレームワーク、アサーションパターンに一致させます。
231 207
233 209
234***210***
235 211
236<h3 id="create-pull-requests">212### プルリクエストを作成する
237 プルリクエストを作成する
238</h3>
239 213
240Claude に直接プルリクエストを作成するよう依頼するか（「create a pr for my changes」）、ステップバイステップで Claude をガイドできます：214Claude に直接プルリクエストを作成するよう依頼するか（「create a pr for my changes」）、ステップバイステップで Claude をガイドできます：
241 215
242<Steps>216**1. 変更内容を要約する**
243 <Step title="変更内容を要約する">217
244 ```text wrap theme={null}218```text wrap theme={null}
245 summarize the changes I've made to the authentication module219summarize the changes I've made to the authentication module
246 ```220```
247 </Step>221
248 222**2. プルリクエストを生成する**
249 <Step title="プルリクエストを生成する">223
250 ```text wrap theme={null}224```text wrap theme={null}
251 create a pr225create a pr
252 ```226```
253 </Step>227
254 228**3. レビューと改善**
255 <Step title="レビューと改善">229
256 ```text wrap theme={null}230```text wrap theme={null}
257 enhance the PR description with more context about the security improvements231enhance the PR description with more context about the security improvements
258 ```232```
259 </Step>
260</Steps>
261 233
262後でセッションを見つけるには、`claude --from-pr 1234` を実行してください。1234 を PR 番号に置き換えてください。これにより、その PR にリンクされたセッションにフィルタリングされたセッションピッカーが開きます。または、[`/resume` ピッカー](/docs/ja/sessions#use-the-session-picker)の検索に PR URL を貼り付けてください。Claude が `gh pr create` または `glab mr create` でプルリクエストを作成するとき、および Claude が[既存の PR で作業する](/docs/ja/agent-view#pull-request-status)ときに、Claude Code はセッションを PR にリンクします。234後でセッションを見つけるには、`claude --from-pr 1234` を実行してください。1234 を PR 番号に置き換えてください。これにより、その PR にリンクされたセッションにフィルタリングされたセッションピッカーが開きます。または、[`/resume` ピッカー](/docs/ja/sessions#use-the-session-picker)の検索に PR URL を貼り付けてください。Claude が `gh pr create` または `glab mr create` でプルリクエストを作成するとき、および Claude が[既存の PR で作業する](/docs/ja/agent-view#pull-request-status)ときに、Claude Code はセッションを PR にリンクします。
263 235
264<Tip>236> [!TIP]
265 Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。237>
266</Tip>238> Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。
267 239
268<h3 id="handle-documentation">240### ドキュメントを処理する
269 ドキュメントを処理する
270</h3>
271 241
272コードのドキュメントを追加または更新する必要があるとします。242コードのドキュメントを追加または更新する必要があるとします。
273 243
274<Steps>244**1. ドキュメント化されていないコードを特定する**
275 <Step title="ドキュメント化されていないコードを特定する">245
276 ```text wrap theme={null}246```text wrap theme={null}
277 find functions without proper JSDoc comments in the auth module247find functions without proper JSDoc comments in the auth module
278 ```248```
279 </Step>249
280 250**2. ドキュメントを生成する**
281 <Step title="ドキュメントを生成する">251
282 ```text wrap theme={null}252```text wrap theme={null}
283 add JSDoc comments to the undocumented functions in auth.js253add JSDoc comments to the undocumented functions in auth.js
284 ```254```
285 </Step>255
286 256**3. レビューと改善**
287 <Step title="レビューと改善">257
288 ```text wrap theme={null}258```text wrap theme={null}
289 improve the generated documentation with more context and examples259improve the generated documentation with more context and examples
290 ```260```
291 </Step>261
292 262**4. ドキュメントを検証する**
293 <Step title="ドキュメントを検証する">263
294 ```text wrap theme={null}264```text wrap theme={null}
295 check if the documentation follows our project standards265check if the documentation follows our project standards
296 ```266```
297 </Step>267
298</Steps>268> [!TIP]
299 269>
300<Tip>270> ヒント：
301 ヒント：271>
302 272> * 必要なドキュメントスタイル（JSDoc、docstring など）を指定する
303 * 必要なドキュメントスタイル（JSDoc、docstring など）を指定する273> * ドキュメント内の例をリクエストする
304 * ドキュメント内の例をリクエストする274> * パブリック API、インターフェース、複雑なロジックのドキュメントをリクエストする
305 * パブリック API、インターフェース、複雑なロジックのドキュメントをリクエストする
306</Tip>
307 275
308***276***
309 277
310<h3 id="work-in-notes-and-non-code-folders">278### ノートと非コードフォルダで作業する
311 ノートと非コードフォルダで作業する
312</h3>
313 279
314Claude Code はどのディレクトリでも機能します。ノートボルト、ドキュメントフォルダ、またはマークダウンファイルの任意のコレクション内で実行して、コードと同じ方法でコンテンツを検索、編集、再編成します。280Claude Code はどのディレクトリでも機能します。ノートボルト、ドキュメントフォルダ、またはマークダウンファイルの任意のコレクション内で実行して、コードと同じ方法でコンテンツを検索、編集、再編成します。
315 281
317 283
318***284***
319 285
320<h3 id="work-with-images">286### 画像を使用する
321 画像を使用する
322</h3>
323 287
324コードベース内の画像を使用する必要があり、Claude の画像コンテンツ分析を支援したいとします。288コードベース内の画像を使用する必要があり、Claude の画像コンテンツ分析を支援したいとします。
325 289
326<Steps>290**1. 会話に画像を追加する**
327 <Step title="会話に画像を追加する">291
328 次のいずれかの方法を使用できます：292次のいずれかの方法を使用できます：
329 293
330 1. Claude Code ウィンドウに画像をドラッグアンドドロップする2941. Claude Code ウィンドウに画像をドラッグアンドドロップする
331 2. 画像をコピーして、CLI に `Ctrl+V` で貼り付ける。または [`Alt+V` を Windows と WSL で](/docs/ja/interactive-mode#general-controls)使用する2952. 画像をコピーして、CLI に `Ctrl+V` で貼り付ける。または [`Alt+V` を Windows と WSL で](/docs/ja/interactive-mode#general-controls)使用する
332 3. Claude に画像パスを提供する。例：「Analyze this image: /path/to/your/image.png」2963. Claude に画像パスを提供する。例：「Analyze this image: /path/to/your/image.png」
333 </Step>297
334 298**2. Claude に画像を分析するよう依頼する**
335 <Step title="Claude に画像を分析するよう依頼する">299
336 ```text wrap theme={null}300```text wrap theme={null}
337 What does this image show?301What does this image show?
338 ```302```
339 303
340 ```text wrap theme={null}304```text wrap theme={null}
341 Describe the UI elements in this screenshot305Describe the UI elements in this screenshot
342 ```306```
343 307
344 ```text wrap theme={null}308```text wrap theme={null}
345 Are there any problematic elements in this diagram?309Are there any problematic elements in this diagram?
346 ```310```
347 </Step>311
348 312**3. コンテキストに画像を使用する**
349 <Step title="コンテキストに画像を使用する">313
350 ```text wrap theme={null}314```text wrap theme={null}
351 Here's a screenshot of the error. What's causing it?315Here's a screenshot of the error. What's causing it?
352 ```316```
353 317
354 ```text wrap theme={null}318```text wrap theme={null}
355 This is our current database schema. How should we modify it for the new feature?319This is our current database schema. How should we modify it for the new feature?
356 ```320```
357 </Step>321
358 322**4. ビジュアルコンテンツからコード提案を取得する**
359 <Step title="ビジュアルコンテンツからコード提案を取得する">323
360 ```text wrap theme={null}324```text wrap theme={null}
361 Generate CSS to match this design mockup325Generate CSS to match this design mockup
362 ```326```
363 327
364 ```text wrap theme={null}328```text wrap theme={null}
365 What HTML structure would recreate this component?329What HTML structure would recreate this component?
366 ```330```
367 </Step>331
368</Steps>332> [!TIP]
369 333>
370<Tip>334> ヒント：
371 ヒント：335>
372 336> * テキスト説明が不明確または面倒な場合は画像を使用する
373 * テキスト説明が不明確または面倒な場合は画像を使用する337> * より良いコンテキストのために、エラー、UI デザイン、図のスクリーンショットを含める
374 * より良いコンテキストのために、エラー、UI デザイン、図のスクリーンショットを含める338> * 会話で複数の画像を使用できます
375 * 会話で複数の画像を使用できます339> * 画像分析は図、スクリーンショット、モックアップなどで機能します
376 * 画像分析は図、スクリーンショット、モックアップなどで機能します340> * Claude が画像を参照する場合（例：`[Image #1]`）、`Cmd+Click`（Mac）または `Ctrl+Click`（Windows/Linux）リンクをクリックして、デフォルトビューアで画像を開きます
377 * Claude が画像を参照する場合（例：`[Image #1]`）、`Cmd+Click`（Mac）または `Ctrl+Click`（Windows/Linux）リンクをクリックして、デフォルトビューアで画像を開きます
378</Tip>
379 341
380***342***
381 343
382<h3 id="reference-files-and-directories">344### ファイルとディレクトリを参照する
383 ファイルとディレクトリを参照する
384</h3>
385 345
386@ を使用して、Claude に読み込まれるのを待たずにファイルまたはディレクトリをすばやく含めます。346@ を使用して、Claude に読み込まれるのを待たずにファイルまたはディレクトリをすばやく含めます。
387 347
388<Steps>348**1. 単一ファイルを参照する**
389 <Step title="単一ファイルを参照する">
390 ```text wrap theme={null}
391 Explain the logic in @src/utils/auth.js
392 ```
393 349
394 これにより、ファイルが [Read ツール](/docs/ja/tools-reference#read-tool-behavior)のトークン制限（デフォルトでは 25,000 トークン）に収まる場合、ファイルの内容が会話に含まれます。256KB を超えるテキストファイルは含まれません。350```text wrap theme={null}
395 </Step>351Explain the logic in @src/utils/auth.js
352```
353
354これにより、ファイルが [Read ツール](/docs/ja/tools-reference#read-tool-behavior)のトークン制限（デフォルトでは 25,000 トークン）に収まる場合、ファイルの内容が会話に含まれます。256KB を超えるテキストファイルは含まれません。
396 355
397 <Step title="ディレクトリを参照する">356**2. ディレクトリを参照する**
398 ```text wrap theme={null}357
399 What's the structure of @src/components?358```text wrap theme={null}
400 ```359What's the structure of @src/components?
401 </Step>360```
402 361
403 <Step title="MCP リソースを参照する">362**3. MCP リソースを参照する**
404 ```text wrap theme={null}
405 Show me the data from @github:repos/owner/repo/issues
406 ```
407 363
408 これにより、@server:resource 形式を使用して接続された MCP サーバーからデータを取得します。詳細については、[MCP リソース](/docs/ja/mcp#use-mcp-resources)を参照してください。364```text wrap theme={null}
409 </Step>365Show me the data from @github:repos/owner/repo/issues
410</Steps>366```
411 367
412<Tip>368これにより、@server:resource 形式を使用して接続された MCP サーバーからデータを取得します。詳細については、[MCP リソース](/docs/ja/mcp#use-mcp-resources)を参照してください。
413 ヒント：
414 369
415 * ファイルパスは相対パスまたは絶対パスにできます370> [!TIP]
416 * `@` を入力してパス提案メニューを開き、Enter または Tab キーを押してハイライトされたパスを受け入れ、もう一度 Enter キーを押してメッセージを送信します371>
417 * @ ファイル参照は、ファイルのディレクトリと親ディレクトリに `CLAUDE.md` を追加してコンテキストに含めます372> ヒント：
418 * ディレクトリ参照はコンテンツではなくファイルリストを表示します373>
419 * 単一のメッセージで複数のファイルを参照できます（例：「@file1.js and @file2.js」）374> * ファイルパスは相対パスまたは絶対パスにできます
420</Tip>375> * `@` を入力してパス提案メニューを開き、Enter または Tab キーを押してハイライトされたパスを受け入れ、もう一度 Enter キーを押してメッセージを送信します
376> * @ ファイル参照は、ファイルのディレクトリと親ディレクトリに `CLAUDE.md` を追加してコンテキストに含めます
377> * ディレクトリ参照はコンテンツではなくファイルリストを表示します
378> * 単一のメッセージで複数のファイルを参照できます（例：「@file1.js and @file2.js」）
421 379
422`@` 参照によってメッセージにファイルの内容やディレクトリリストが含まれないようにするには、シェルまたはユーザー設定で [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/ja/env-vars#variables) を設定してください。その場合、Claude は参照されたパスを、ファイルツールを使って読み込むよう促すメモとともに受け取ります。この変数には Claude Code v2.1.299 以降が必要です。また、プロジェクト設定とローカル設定では Claude Code はこの変数を無視します。380`@` 参照によってメッセージにファイルの内容やディレクトリリストが含まれないようにするには、シェルまたはユーザー設定で [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/ja/env-vars#variables) を設定してください。その場合、Claude は参照されたパスを、ファイルツールを使って読み込むよう促すメモとともに受け取ります。この変数には Claude Code v2.1.299 以降が必要です。また、プロジェクト設定とローカル設定では Claude Code はこの変数を無視します。
423 381
424***382***
425 383
426<h3 id="run-claude-on-a-schedule">384### スケジュールで Claude を実行する
427 スケジュールで Claude を実行する
428</h3>
429 385
430Claude に長時間実行されるタスクを自動的に定期的に処理させたいとします。例えば、毎朝オープン PR をレビューしたり、毎週依存関係を監査したり、夜間に CI の失敗をチェックしたりします。386Claude に長時間実行されるタスクを自動的に定期的に処理させたいとします。例えば、毎朝オープン PR をレビューしたり、毎週依存関係を監査したり、夜間に CI の失敗をチェックしたりします。
431 387
433 389
434| オプション | 実行場所 | 最適な用途 |390| オプション | 実行場所 | 最適な用途 |
435| :- | :- | :- |391| :- | :- | :- |
436| [ルーチン](/docs/ja/routines) | クラウド、Anthropic 管理（デフォルト） | コンピュータがオフの場合でも実行する必要があるタスク。[claude.ai/code/routines](https://claude.ai/code/routines)で設定します。スケジュールに加えて API 呼び出しまたは GitHub イベントでトリガーすることもできます。 |392| [クラウドスケジュールタスク](/docs/ja/routines) | クラウド（デフォルトでは Anthropic 管理） | コンピューターがオフの場合でも実行する必要があるタスク。スケジュールに加えて API 呼び出しまたは GitHub イベントでトリガーすることもできます。[claude.ai/code/routines](https://claude.ai/code/routines) で設定します。 |
437| [デスクトップスケジュール済みタスク](/docs/ja/desktop-scheduled-tasks) | デスクトップアプリ経由のマシン | ローカルファイル、ツール、またはコミットされていない変更への直接アクセスが必要なタスク。 |393| [デスクトップスケジュール済みタスク](/docs/ja/desktop-scheduled-tasks) | デスクトップアプリ経由のマシン | ローカルファイル、ツール、またはコミットされていない変更への直接アクセスが必要なタスク。 |
438| [GitHub Actions](/docs/ja/github-actions) | CI パイプライン | オープン PR などのリポジトリイベント、またはワークフロー設定と一緒に存在する必要がある cron スケジュールに関連するタスク。 |394| [GitHub Actions](/docs/ja/github-actions) | CI パイプライン | オープン PR などのリポジトリイベント、またはワークフロー設定と一緒に存在する必要がある cron スケジュールに関連するタスク。 |
439| [`/loop`](/docs/ja/scheduled-tasks) | 現在の CLI セッション | セッションが開いている間のクイックポーリング。`--resume` と `--continue` は期限切れでないものを復元します。 |395| [`/loop`](/docs/ja/scheduled-tasks) | 現在の CLI セッション | セッションが開いている間のクイックポーリング。`--resume` と `--continue` は期限切れでないものを復元します。 |
440 396
441<Tip>397> [!TIP]
442 スケジュール済みタスク用のプロンプトを作成するときは、成功がどのように見えるか、および結果をどうするかについて明示的に説明してください。タスクは自律的に実行されるため、質問を明確にすることはできません。例えば：「`needs-review` ラベルが付いたオープン PR をレビューし、問題に関するインラインコメントを残し、`#eng-reviews` Slack チャネルに要約を投稿します。」398>
443</Tip>399> スケジュール済みタスク用のプロンプトを作成するときは、成功がどのように見えるか、および結果をどうするかについて明示的に説明してください。タスクは自律的に実行されるため、質問を明確にすることはできません。例えば：「`needs-review` ラベルが付いたオープン PR をレビューし、問題に関するインラインコメントを残し、`#eng-reviews` Slack チャネルに要約を投稿します。」
444 400
445***401***
446 402
447<h3 id="ask-claude-about-its-capabilities">403### Claude にその機能について質問する
448 Claude にその機能について質問する
449</h3>
450 404
451Claude は自分の機能と制限についての質問に答えることができます。回答は最新の Claude Code ドキュメントから調べるため、実行中のバージョンに限定されません。405Claude は自分の機能と制限についての質問に答えることができます。回答は最新の Claude Code ドキュメントから調べるため、実行中のバージョンに限定されません。
452 406
453<h4 id="example-questions">407#### 質問例
454 質問例
455</h4>
456 408
457```text wrap theme={null}409```text wrap theme={null}
458can Claude Code create pull requests?410can Claude Code create pull requests?
478what are the limitations of Claude Code?430what are the limitations of Claude Code?
479```431```
480 432
481<Note>433> [!NOTE]
482 Claude はこれらの質問に対してドキュメントベースの回答を提供します。実行可能な例と実践的なデモンストレーションについては、`/powerup` を実行してアニメーション化されたデモを含むインタラクティブレッスンを受けるか、上記の特定のワークフローセクションを参照してください。434>
483</Note>435> Claude はこれらの質問に対してドキュメントベースの回答を提供します。実行可能な例と実践的なデモンストレーションについては、`/powerup` を実行してアニメーション化されたデモを含むインタラクティブレッスンを受けるか、上記の特定のワークフローセクションを参照してください。
484
485<Tip>
486 ヒント：
487 436
488 * 詳細な回答を得るために具体的な質問をする437> [!TIP]
489 * Claude は MCP 統合、エンタープライズ設定、高度なワークフローなどの複雑な機能を説明できます438>
490</Tip>439> ヒント：
440>
441> * 詳細な回答を得るために具体的な質問をする
442> * Claude は MCP 統合、エンタープライズ設定、高度なワークフローなどの複雑な機能を説明できます
491 443
492***444***
493 445
494<h2 id="resume-previous-conversations">446## 以前の会話を再開する
495 以前の会話を再開する
496</h2>
497 447
498タスクが複数回に分けて実行される場合は、コンテキストを再度説明するのではなく、中断したところから再開してください。Claude Code はすべての会話をローカルに保存します。448タスクが複数回に分けて実行される場合は、コンテキストを再度説明するのではなく、中断したところから再開してください。Claude Code はすべての会話をローカルに保存します。
499 449
503 453
504これにより、現在のディレクトリで最新のセッションが再開されます。まだセッションがない場合は、`No conversation found to continue` と出力して終了します。`claude --resume` を使用してリストから選択するか、実行中のセッション内から `/resume` を使用してください。[セッションを管理する](/docs/ja/sessions)を参照して、名前付け、ブランチ、および完全なピッカーリファレンスを確認してください。454これにより、現在のディレクトリで最新のセッションが再開されます。まだセッションがない場合は、`No conversation found to continue` と出力して終了します。`claude --resume` を使用してリストから選択するか、実行中のセッション内から `/resume` を使用してください。[セッションを管理する](/docs/ja/sessions)を参照して、名前付け、ブランチ、および完全なピッカーリファレンスを確認してください。
505 455
506<h2 id="run-parallel-sessions-with-worktrees">456## worktree を使用して並列セッションを実行する
507 worktree を使用して並列セッションを実行する
508</h2>
509 457
5101 つのターミナルで機能に取り組みながら、別のターミナルで Claude がバグを修正するようにします。編集が衝突しないようにしてください。各 [git worktree](https://git-scm.com/docs/git-worktree) は既存のコミットから作成された独自のブランチ上の個別のチェックアウトです。そのため、リポジトリには最初に少なくとも 1 つのコミットが必要です。4581 つのターミナルで機能に取り組みながら、別のターミナルで Claude がバグを修正するようにします。編集が衝突しないようにしてください。各 [git worktree](https://git-scm.com/docs/git-worktree) は既存のコミットから作成された独自のブランチ上の個別のチェックアウトです。そのため、リポジトリには最初に少なくとも 1 つのコミットが必要です。
511 459
515 463
516別の名前で 2 番目のターミナルで同じコマンドを実行して、分離された並列セッションを開始します。コミットがないリポジトリでは、コマンドは `Failed to resolve base branch "HEAD": git rev-parse failed` というエラーで失敗します。クリーンアップ、`.worktreeinclude`、および非 git VCS サポートについては、[Worktrees](/docs/ja/worktrees) を参照してください。1 つの画面から並列セッションを監視するには、別のターミナルではなく、[バックグラウンドエージェント](/docs/ja/agent-view) を参照してください。464別の名前で 2 番目のターミナルで同じコマンドを実行して、分離された並列セッションを開始します。コミットがないリポジトリでは、コマンドは `Failed to resolve base branch "HEAD": git rev-parse failed` というエラーで失敗します。クリーンアップ、`.worktreeinclude`、および非 git VCS サポートについては、[Worktrees](/docs/ja/worktrees) を参照してください。1 つの画面から並列セッションを監視するには、別のターミナルではなく、[バックグラウンドエージェント](/docs/ja/agent-view) を参照してください。
517 465
518<h2 id="plan-before-editing">466## 編集前に計画する
519 編集前に計画する
520</h2>
521 467
522ディスクに変更を加える前に確認したい変更については、計画モードに切り替えてください。Claude はファイルを読み込んで計画を提案しますが、承認されるまで編集は行いません。ステータスバーは計画モードがアクティブな間、`⏸ plan mode on` と表示されます。468ディスクに変更を加える前に確認したい変更については、計画モードに切り替えてください。Claude はファイルを読み込んで計画を提案しますが、承認されるまで編集は行いません。ステータスバーは計画モードがアクティブな間、`⏸ plan mode on` と表示されます。
523 469
527 473
528セッション中に `Shift+Tab` を押してステータスバーが `⏸ plan mode on` と表示されるまで切り替えることもできます。承認フローとテキストエディタで計画を編集する方法については、[計画モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)を参照してください。474セッション中に `Shift+Tab` を押してステータスバーが `⏸ plan mode on` と表示されるまで切り替えることもできます。承認フローとテキストエディタで計画を編集する方法については、[計画モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)を参照してください。
529 475
530<h2 id="delegate-research-to-subagents">476## 研究を subagent に委譲する
531 研究を subagent に委譲する
532</h2>
533 477
534大規模なコードベースの探索はコンテキストをファイル読み込みで満たします。探索を委譲して、結果のみが戻るようにしてください。478大規模なコードベースの探索はコンテキストをファイル読み込みで満たします。探索を委譲して、結果のみが戻るようにしてください。
535 479
539 483
540subagent は独自のコンテキストウィンドウでファイルを読み込み、要約を報告します。[Subagents](/docs/ja/sub-agents)を参照して、独自のツールとプロンプトを持つカスタムエージェントを定義することを確認してください。484subagent は独自のコンテキストウィンドウでファイルを読み込み、要約を報告します。[Subagents](/docs/ja/sub-agents)を参照して、独自のツールとプロンプトを持つカスタムエージェントを定義することを確認してください。
541 485
542<h2 id="pipe-claude-into-scripts">486## Claude をスクリプトにパイプする
543 Claude をスクリプトにパイプする
544</h2>
545 487
546CI、プリコミットフック、またはバッチ処理用に Claude を非対話的に実行します。stdin と stdout は任意の Unix ツールのように機能します。488CI、プリコミットフック、またはバッチ処理用に Claude を非対話的に実行します。stdin と stdout は任意の Unix ツールのように機能します。
547 489
551 493
552[非対話モード](/docs/ja/headless)を参照して、出力形式、許可フラグ、およびファンアウトパターンを確認してください。494[非対話モード](/docs/ja/headless)を参照して、出力形式、許可フラグ、およびファンアウトパターンを確認してください。
553 495
554<h2 id="next-steps">496## 次のステップ
555 次のステップ
556</h2>
557 497
558<CardGroup cols={2}>498> **[ベストプラクティス](/docs/ja/best-practices)**
559 <Card title="ベストプラクティス" icon="lightbulb" href="/docs/ja/best-practices">499>
560 Claude Code から最大限の価値を得るためのパターン500> Claude Code から最大限の価値を得るためのパターン
561 </Card>
562 501
563 <Card title="セッションを管理する" icon="rotate-left" href="/docs/ja/sessions">502> **[セッションを管理する](/docs/ja/sessions)**
564 会話を再開、名前付け、ブランチする503>
565 </Card>504> 会話を再開、名前付け、ブランチする
566 505
567 <Card title="Worktrees" icon="code-branch" href="/docs/ja/worktrees">506> **[Worktrees](/docs/ja/worktrees)**
568 分離された並列セッションを実行する507>
569 </Card>508> 分離された並列セッションを実行する
570 509
571 <Card title="Claude Code を拡張する" icon="puzzle-piece" href="/docs/ja/features-overview">510> **[Claude Code を拡張する](/docs/ja/features-overview)**
572 skill、フック、MCP、subagent、プラグインを追加する511>
573 </Card>512> skill、フック、MCP、subagent、プラグインを追加する
574</CardGroup>
