1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 一般的なワークフロー

6 

7> Claude Code を使用してコードベースの探索、バグ修正、リファクタリング、テスト、その他の日常的なタスクを実行するためのステップバイステップガイド。

8 

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

10 

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

12 

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

14 

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

16 

17<Steps>

18 <Step title="プロジェクトルートディレクトリに移動する">

19 ```bash theme={null}

20 cd /path/to/project

21 ```

22 </Step>

23 

24 <Step title="Claude Code を起動する">

25 ```bash theme={null}

26 claude

27 ```

28 </Step>

29 

30 <Step title="高レベルの概要をリクエストする">

31 ```text theme={null}

32 give me an overview of this codebase

33 ```

34 </Step>

35 

36 <Step title="特定のコンポーネントについてさらに詳しく調べる">

37 ```text theme={null}

38 explain the main architecture patterns used here

39 ```

40 

41 ```text theme={null}

42 what are the key data models?

43 ```

44 

45 ```text theme={null}

46 how is authentication handled?

47 ```

48 </Step>

49</Steps>

50 

51<Tip>

52 ヒント：

53 

54 * 広い質問から始めて、特定の領域に絞り込んでいく

55 * プロジェクトで使用されているコーディング規約とパターンについて質問する

56 * プロジェクト固有の用語の用語集をリクエストする

57</Tip>

58 

59### 関連するコードを見つける

60 

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

62 

63<Steps>

64 <Step title="Claude に関連ファイルを見つけるよう依頼する">

65 ```text theme={null}

66 find the files that handle user authentication

67 ```

68 </Step>

69 

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

71 ```text theme={null}

72 how do these authentication files work together?

73 ```

74 </Step>

75 

76 <Step title="実行フローを理解する">

77 ```text theme={null}

78 trace the login process from front-end to database

79 ```

80 </Step>

81</Steps>

82 

83<Tip>

84 ヒント：

85 

86 * 探しているものについて具体的に説明する

87 * プロジェクトのドメイン言語を使用する

88 * 言語の[コード インテリジェンス プラグイン](/ja/discover-plugins#code-intelligence)をインストールして、Claude に正確な'定義に移動'と'参照を検索'のナビゲーションを提供する

89</Tip>

90 

91***

92 

93## バグを効率的に修正する

94 

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

96 

97<Steps>

98 <Step title="Claude とエラーを共有する">

99 ```text theme={null}

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

101 ```

102 </Step>

103 

104 <Step title="修正の推奨事項をリクエストする">

105 ```text theme={null}

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

107 ```

108 </Step>

109 

110 <Step title="修正を適用する">

111 ```text theme={null}

112 update user.ts to add the null check you suggested

113 ```

114 </Step>

115</Steps>

116 

117<Tip>

118 ヒント：

119 

120 * Claude に問題を再現するコマンドとスタックトレースを伝える

121 * エラーを再現するための手順を記載する

122 * エラーが断続的か一貫しているかを Claude に知らせる

123</Tip>

124 

125***

126 

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

128 

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

130 

131<Steps>

132 <Step title="リファクタリング対象のレガシーコードを特定する">

133 ```text theme={null}

134 find deprecated API usage in our codebase

135 ```

136 </Step>

137 

138 <Step title="リファクタリングの推奨事項を取得する">

139 ```text theme={null}

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

141 ```

142 </Step>

143 

144 <Step title="変更を安全に適用する">

145 ```text theme={null}

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

147 ```

148 </Step>

149 

150 <Step title="リファクタリングを検証する">

151 ```text theme={null}

152 run tests for the refactored code

153 ```

154 </Step>

155</Steps>

156 

157<Tip>

158 ヒント：

159 

160 * Claude に最新のアプローチの利点を説明するよう依頼する

161 * 必要に応じて変更が後方互換性を維持することをリクエストする

162 * リファクタリングを小さくテスト可能な増分で実行する

163</Tip>

164 

165***

166 

167## 特化した subagent を使用する

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 

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

303 

304<Steps>

305 <Step title="テストされていないコードを特定する">

306 ```text theme={null}

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

308 ```

309 </Step>

310 

311 <Step title="テストスキャフォルディングを生成する">

312 ```text theme={null}

313 add tests for the notification service

314 ```

315 </Step>

316 

317 <Step title="意味のあるテストケースを追加する">

318 ```text theme={null}

319 add test cases for edge conditions in the notification service

320 ```

321 </Step>

322 

323 <Step title="テストを実行して検証する">

324 ```text theme={null}

325 run the new tests and fix any failures

326 ```

327 </Step>

328</Steps>

329 

330Claude は、プロジェクトの既存のパターンと規約に従うテストを生成できます。テストをリクエストするときは、検証したい動作について具体的に説明してください。Claude は既存のテストファイルを調べて、既に使用されているスタイル、フレームワーク、アサーションパターンに一致させます。

331 

332包括的なカバレッジのために、Claude に見落とした可能性のあるエッジケースを特定するよう依頼してください。Claude はコードパスを分析し、エラー条件、境界値、見落としやすい予期しない入力のテストを提案できます。

333 

334***

335 

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

337 

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

339 

340<Steps>

341 <Step title="変更内容を要約する">

342 ```text theme={null}

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

344 ```

345 </Step>

346 

347 <Step title="プルリクエストを生成する">

348 ```text theme={null}

349 create a pr

350 ```

351 </Step>

352 

353 <Step title="レビューと改善">

354 ```text theme={null}

355 enhance the PR description with more context about the security improvements

356 ```

357 </Step>

358</Steps>

359 

360`gh pr create` を使用して PR を作成すると、セッションはその PR に自動的にリンクされます。後で `claude --from-pr <number>` で再開できます。

361 

362<Tip>

363 Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。

364</Tip>

365 

366## ドキュメントを処理する

367 

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

369 

370<Steps>

371 <Step title="ドキュメント化されていないコードを特定する">

372 ```text theme={null}

373 find functions without proper JSDoc comments in the auth module

374 ```

375 </Step>

376 

377 <Step title="ドキュメントを生成する">

378 ```text theme={null}

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

380 ```

381 </Step>

382 

383 <Step title="レビューと改善">

384 ```text theme={null}

385 improve the generated documentation with more context and examples

386 ```

387 </Step>

388 

389 <Step title="ドキュメントを検証する">

390 ```text theme={null}

391 check if the documentation follows our project standards

392 ```

393 </Step>

394</Steps>

395 

396<Tip>

397 ヒント：

398 

399 * 必要なドキュメントスタイル（JSDoc、docstring など）を指定する

400 * ドキュメント内の例をリクエストする

401 * パブリック API、インターフェース、複雑なロジックのドキュメントをリクエストする

402</Tip>

403 

404***

405 

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

407 

408Claude Code はどのディレクトリでも機能します。ノートボルト、ドキュメントフォルダ、またはマークダウンファイルの任意のコレクション内で実行して、コードと同じ方法でコンテンツを検索、編集、再編成します。

409 

410`.claude/` ディレクトリと `CLAUDE.md` は他のツールの設定ディレクトリと並んで競合なく存在します。Claude は各ツール呼び出しで新しくファイルを読み込むため、別のアプリケーションで行った編集は次回そのファイルを読み込むときに表示されます。

411 

412***

413 

414## 画像を使用する

415 

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

417 

418<Steps>

419 <Step title="会話に画像を追加する">

420 次のいずれかの方法を使用できます：

421 

422 1. Claude Code ウィンドウに画像をドラッグアンドドロップする

423 2. 画像をコピーして、CLI に ctrl+v で貼り付ける（cmd+v は使用しないでください）

424 3. Claude に画像パスを提供する。例：「Analyze this image: /path/to/your/image.png」

425 </Step>

426 

427 <Step title="Claude に画像を分析するよう依頼する">

428 ```text theme={null}

429 What does this image show?

430 ```

431 

432 ```text theme={null}

433 Describe the UI elements in this screenshot

434 ```

435 

436 ```text theme={null}

437 Are there any problematic elements in this diagram?

438 ```

439 </Step>

440 

441 <Step title="コンテキストに画像を使用する">

442 ```text theme={null}

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

444 ```

445 

446 ```text theme={null}

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

448 ```

449 </Step>

450 

451 <Step title="ビジュアルコンテンツからコード提案を取得する">

452 ```text theme={null}

453 Generate CSS to match this design mockup

454 ```

455 

456 ```text theme={null}

457 What HTML structure would recreate this component?

458 ```

459 </Step>

460</Steps>

461 

462<Tip>

463 ヒント：

464 

465 * テキスト説明が不明確または面倒な場合は画像を使用する

466 * より良いコンテキストのために、エラー、UI デザイン、図のスクリーンショットを含める

467 * 会話で複数の画像を使用できます

468 * 画像分析は図、スクリーンショット、モックアップなどで機能します

469 * Claude が画像を参照する場合（例：`[Image #1]`）、`Cmd+Click`（Mac）または `Ctrl+Click`（Windows/Linux）リンクをクリックして、デフォルトビューアで画像を開きます

470</Tip>

471 

472***

473 

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

475 

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

477 

478<Steps>

479 <Step title="単一ファイルを参照する">

480 ```text theme={null}

481 Explain the logic in @src/utils/auth.js

482 ```

483 

484 これにより、ファイルの完全な内容が会話に含まれます。

485 </Step>

486 

487 <Step title="ディレクトリを参照する">

488 ```text theme={null}

489 What's the structure of @src/components?

490 ```

491 

492 これにより、ファイル情報を含むディレクトリリストが提供されます。

493 </Step>

494 

495 <Step title="MCP リソースを参照する">

496 ```text theme={null}

497 Show me the data from @github:repos/owner/repo/issues

498 ```

499 

500 これにより、@server:resource 形式を使用して接続された MCP サーバーからデータを取得します。詳細については、[MCP リソース](/ja/mcp#use-mcp-resources)を参照してください。

501 </Step>

502</Steps>

503 

504<Tip>

505 ヒント：

506 

507 * ファイルパスは相対パスまたは絶対パスにできます

508 * @ ファイル参照は、ファイルのディレクトリと親ディレクトリに `CLAUDE.md` を追加してコンテキストに含めます

509 * ディレクトリ参照はコンテンツではなくファイルリストを表示します

510 * 単一のメッセージで複数のファイルを参照できます（例：「@file1.js and @file2.js」）

511</Tip>

512 

513***

514 

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

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 

951Claude に長時間実行されるタスクを自動的に定期的に処理させたいとします。例えば、毎朝オープン PR をレビューしたり、毎週依存関係を監査したり、夜間に CI の失敗をチェックしたりします。

952 

953実行場所に基づいてスケジューリングオプションを選択します：

954 

955| オプション | 実行場所 | 最適な用途 |

956| :----------------------------------------------- | :--------------------- | :------------------------------------------------------------------------------------------- |

957| [ルーチン](/ja/routines) | Anthropic 管理インフラストラクチャ | コンピュータがオフの場合でも実行する必要があるタスク。[claude.ai/code/routines](https://claude.ai/code/routines)で設定します。 |

958| [デスクトップスケジュール済みタスク](/ja/desktop-scheduled-tasks) | デスクトップアプリ経由のマシン | ローカルファイル、ツール、またはコミットされていない変更への直接アクセスが必要なタスク。 |

959| [GitHub Actions](/ja/github-actions) | CI パイプライン | オープン PR などのリポジトリイベント、またはワークフロー設定と一緒に存在する必要がある cron スケジュールに関連するタスク。 |

960| [`/loop`](/ja/scheduled-tasks) | 現在の CLI セッション | セッションが開いている間のクイックポーリング。タスクは新しい会話を開始すると停止します。`--resume` と `--continue` は期限切れでないものを復元します。 |

961 

962<Tip>

963 スケジュール済みタスク用のプロンプトを作成するときは、成功がどのように見えるか、および結果をどうするかについて明示的に説明してください。タスクは自律的に実行されるため、質問を明確にすることはできません。例えば：'`needs-review` ラベルが付いたオープン PR をレビューし、問題に関するインラインコメントを残し、`#eng-reviews` Slack チャネルに要約を投稿します。'

964</Tip>

965 

966***

967 

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

969 

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

971 

972### 質問例

973 

974```text theme={null}

975can Claude Code create pull requests?

976```

977 

978```text theme={null}

979how does Claude Code handle permissions?

980```

981 

982```text theme={null}

983what skills are available?

984```

985 

986```text theme={null}

987how do I use MCP with Claude Code?

988```

989 

990```text theme={null}

991how do I configure Claude Code for Amazon Bedrock?

992```

993 

994```text theme={null}

995what are the limitations of Claude Code?

996```

997 

998<Note>

999 Claude はこれらの質問に対してドキュメントベースの回答を提供します。実行可能な例と実践的なデモンストレーションについては、`/powerup` を実行してアニメーション化されたデモを含むインタラクティブレッスンを受けるか、上記の特定のワークフローセクションを参照してください。

1000</Note>

1001 

1002<Tip>

1003 ヒント：

1004 

1005 * Claude は使用しているバージョンに関係なく、常に最新の Claude Code ドキュメントにアクセスできます

1006 * 詳細な回答を得るために具体的な質問をする

1007 * Claude は MCP 統合、エンタープライズ設定、高度なワークフローなどの複雑な機能を説明できます

1008</Tip>

1009 

1010***

1011 

1012## 次のステップ

1013 

1014<CardGroup cols={2}>

1015 <Card title="ベストプラクティス" icon="lightbulb" href="/ja/best-practices">

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

1017 </Card>

1018 

1019 <Card title="Claude Code の仕組み" icon="gear" href="/ja/how-claude-code-works">

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

1021 </Card>

1022 

1023 <Card title="Claude Code を拡張する" icon="puzzle-piece" href="/ja/features-overview">

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

1025 </Card>

1026 

1027 <Card title="リファレンス実装" icon="code" href="https://github.com/anthropics/claude-code/tree/main/.devcontainer">

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

1029 </Card>

1030</CardGroup>