SpyBara
Go Premium

best-practices.md 2026-07-11 19:03 UTC to 2026-07-13 23:57 UTC

2 added, 2 removed.

2026
Tue 14 18:57 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

Claude Code のベストプラクティス

環境蚭定から䞊列セッションでのスケヌリングたで、Claude Code を最倧限に掻甚するためのヒントずパタヌン。

Claude Code は agentic coding 環境です。質問に答えお埅぀チャットボットずは異なり、Claude Code はファむルを読み取り、コマンドを実行し、倉曎を加え、あなたが芋守ったり、方向を倉えたり、完党に任せたりしながら、自埋的に問題を解決できたす。

これはあなたの䜜業方法を倉えたす。自分でコヌドを曞いお Claude にレビュヌしおもらう代わりに、やりたいこずを説明するず Claude がそれをどのように構築するかを考え出したす。Claude は探玢し、蚈画し、実装したす。

しかし、この自埋性にも孊習曲線がありたす。Claude は理解する必芁がある特定の制玄の䞭で動䜜したす。

このガむドでは、Anthropic の内郚チヌムず、様々なコヌドベヌス、蚀語、環境で Claude Code を䜿甚しおいる゚ンゞニアの間で効果的であるこずが蚌明されたパタヌンに぀いお説明したす。agentic ルヌプがどのように機胜するかに぀いおは、Claude Code の仕組みを参照しおください。


ほずんどのベストプラクティスは 1 ぀の制玄に基づいおいたす。Claude のコンテキストりィンドりはすぐにいっぱいになり、満杯になるに぀れおパフォヌマンスが䜎䞋したす。

Claude のコンテキストりィンドりは、すべおのメッセヌゞ、Claude が読み取ったすべおのファむル、およびすべおのコマンド出力を含む、䌚話党䜓を保持したす。ただし、これはすぐにいっぱいになる可胜性がありたす。単䞀のデバッグセッションたたはコヌドベヌス探玢でも、数䞇のトヌクンを生成および消費する可胜性がありたす。

LLM のパフォヌマンスはコンテキストが満杯になるに぀れお䜎䞋するため、これは重芁です。コンテキストりィンドりがいっぱいになるず、Claude は以前の指瀺を「忘れる」か、より倚くの間違いを犯す可胜性がありたす。コンテキストりィンドりは管理する最も重芁なリ゜ヌスです。セッションがどのように満杯になるかを実際に確認するには、スタヌトアップで䜕が読み蟌たれるか、各ファむル読み取りのコストに぀いおのむンタラクティブなりォヌクスルヌを参照しおください。カスタムステヌタスラむンでコンテキスト䜿甚量を継続的に远跡し、トヌクン䜿甚量を削枛するための戊略に぀いおはトヌクン䜿甚量を削枛を参照しおください。


Claude に自分の䜜業を怜蚌する方法を䞎える

Claude は、䜜業が完了したように芋えるずきに停止したす。実行できるチェックがないず、「完了したように芋える」が唯䞀の利甚可胜なシグナルであり、あなたが怜蚌ルヌプになりたす。すべおの間違いはあなたがそれに気付くのを埅ちたす。Claude が実行できるパスたたはフェむルを生成するものを䞎えるず、ルヌプは自動的に閉じたす。Claude は䜜業を行い、チェックを実行し、結果を読み、チェックが合栌するたで反埩したす。

チェックは、䌚話で Claude が読むこずができるシグナルを返すものです。テストスむヌト、ビルド終了コヌド、リンタヌ、出力を固定倀ず比范するスクリプト、たたはデザむンず比范されるブラりザスクリヌンショットです。

戊略 前 埌
怜蚌基準を提䟛する 「メヌルアドレスを怜蚌する関数を実装する」 「validateEmail 関数を曞く。テストケヌスの䟋user@example.com は true、invalid は false、user@.com は false。実装埌にテストを実行する」
UI の倉曎を芖芚的に怜蚌する 「ダッシュボヌドをより良く芋えるようにする」 「[スクリヌンショットを貌り付け] このデザむンを実装する。結果のスクリヌンショットを撮り、元のものず比范する。違いをリストアップしお修正する」
症状ではなく根本原因に察凊する 「ビルドが倱敗しおいる」 「ビルドがこの゚ラヌで倱敗しおいる[゚ラヌを貌り付け]。修正しお、ビルドが成功するこずを確認する。根本原因に察凊し、゚ラヌを抑制しない」

チェックが存圚したら、停止をどの皋床厳しくゲヌトするかを決定したす。

  • 1 ぀のプロンプトでClaude にチェックを実行し、同じメッセヌゞ内で反埩するよう求めたす。䞊蚘の衚のように。
  • セッション党䜓でチェックを/goal 条件ずしお蚭定したす。別の評䟡者がすべおのタヌンの埌に再床チェックし、Claude はそれが保持されるたで䜜業を続けたす。
  • 決定論的ゲヌトずしおStop hook がスクリプトずしおチェックを実行し、合栌するたでタヌンが終了するのをブロックしたす。Claude Code はフックをオヌバヌラむドし、8 回連続でブロックされた埌、タヌンを終了したす。
  • 第二の意芋によっお怜蚌サブ゚ヌゞェントたたは動的ワヌクフロヌが独自の調査結果をチェックし、新しいモデルが結果を反論しようずするため、䜜業を行っおいる゚ヌゞェントがそれを採点しおいるわけではありたせん。

各ステップは、セットアップず泚意をトレヌドオフしたす。プロンプト版は今日、任意のタスクで機胜したす。/goal ず Stop hook 版は、あなたなしで無人実行が正しく完了できるようにするものです。

Claude に成功を䞻匵するのではなく、蚌拠を瀺すよう指瀺しおください。テスト出力、実行したコマンドずその戻り倀、たたは結果のスクリヌンショットです。蚌拠を確認するこずは、怜蚌を自分で再実行するよりも高速であり、監芖しおいなかったセッションでも機胜したす。


最初に探玢し、次に蚈画し、その埌コヌディングする

Claude が盎接コヌディングにゞャンプさせるず、間違った問題を解決するコヌドが生成される可胜性がありたす。Plan Mode を䜿甚しお、探玢を実行から分離したす。

掚奚されるワヌクフロヌには 4 ぀のフェヌズがありたす。

1

探玢

Plan Mode に入りたす。Claude はファむルを読み取り、倉曎を加えずに質問に答えたす。

read /src/auth and understand how we handle sessions and login.
also look at how we manage environment variables for secrets.
2

蚈画

Claude に詳现な実装蚈画を䜜成するよう䟝頌したす。

I want to add Google OAuth. What files need to change?
What's the session flow? Create a plan.

Ctrl+G を抌しお、Claude が進む前に、テキスト゚ディタで蚈画を開いお盎接線集したす。

3

実装

Plan Mode を終了し、Claude にコヌディングさせ、蚈画に察しお怜蚌したす。

implement the OAuth flow from your plan. write tests for the
callback handler, run the test suite and fix any failures.
4

コミット

Claude に説明的なメッセヌゞでコミットし、PR を䜜成するよう䟝頌したす。

commit with a descriptive message and open a PR

プロンプトで具䜓的なコンテキストを提䟛する

Claude は意図を掚枬できたすが、あなたの心を読むこずはできたせん。特定のファむルを参照し、制玄を述べ、䟋のパタヌンを指摘したす。

戊略 前 埌
タスクをスコヌプする。 どのファむル、どのシナリオ、テスト蚭定を指定したす。 「foo.py のテストを远加する」 「ナヌザヌがログアりトしおいる゚ッゞケヌスをカバヌする foo.py のテストを曞く。モックを避ける。」
゜ヌスを指摘する。 Claude を質問に答えるこずができる゜ヌスに向けたす。 「ExecutionFactory がこんなに奇劙な API を持っおいるのはなぜですか」 「ExecutionFactory の git 履歎を調べお、その API がどのようになったかを芁玄する」
既存のパタヌンを参照する。 Claude をコヌドベヌスのパタヌンに向けたす。 「カレンダヌりィゞェットを远加する」 「ホヌムペヌゞで既存のりィゞェットがどのように実装されおいるかを芋お、パタヌンを理解する。HotDogWidget.php は良い䟋です。パタヌンに埓っお、ナヌザヌが月を遞択し、前埌にペヌゞネヌションしお幎を遞択できる新しいカレンダヌりィゞェットを実装する。コヌドベヌスで既に䜿甚されおいるもの以倖のラむブラリを䜿甚せずにれロから構築する。」
症状を説明する。 症状、可胜性のある堎所、「修正」の倖芳を提䟛したす。 「ログむンバグを修正する」 「ナヌザヌはセッションタむムアりト埌にログむンが倱敗するず報告しおいたす。src/auth/ の認蚌フロヌ、特にトヌクン曎新を確認したす。問題を再珟する倱敗するテストを曞き、修正する」

曖昧なプロンプトは、探玢しおいお方向転換を䜙裕を持っおできるずきに圹立぀こずがありたす。「このファむルで䜕を改善したすか」のようなプロンプトは、あなたが尋ねるこずを考えなかったこずを衚面化させるこずができたす。

リッチコンテンツを提䟛する

Claude にリッチデヌタを提䟛するにはいく぀かの方法がありたす。

  • @ でファむルを参照する コヌドがどこにあるかを説明する代わりに。Claude は応答する前にファむルを読み取りたす。
  • 画像を盎接貌り付ける。画像をコピヌ/貌り付けたたはドラッグアンドドロップしおプロンプトに入れたす。
  • ドキュメントず API リファレンスの URL を指定する。/permissions を䜿甚しお、頻繁に䜿甚されるドメむンをホワむトリストに登録したす。
  • デヌタをパむプする cat error.log | claude を実行しおファむルの内容を盎接送信したす。
  • Claude に必芁なものを取埗させる。Bash コマンド、MCP ツヌル、たたはファむルを読み取るこずを䜿甚しお、Claude 自身がコンテキストをプルするよう指瀺したす。

環境を蚭定する

いく぀かのセットアップステップにより、Claude Code はすべおのセッション党䜓で倧幅に効果的になりたす。拡匵機胜の完党な抂芁ず各機胜をい぀䜿甚するかに぀いおは、Claude Code を拡匵を参照しおください。

効果的な CLAUDE.md を曞く

CLAUDE.md は Claude がすべおの䌚話の開始時に読む特別なファむルです。Bash コマンド、コヌドスタむル、ワヌクフロヌルヌルを含めたす。これにより、Claude はコヌドだけからは掚枬できない氞続的なコンテキストを取埗したす。

/init コマンドはコヌドベヌスを分析しおビルドシステム、テストフレヌムワヌク、コヌドパタヌンを怜出し、改善するための堅牢な基盀を提䟛したす。

CLAUDE.md ファむルに必須の圢匏はありたせんが、短く人間が読める状態に保ちたす。䟋えば

# Code style
- Use ES modules (import/export) syntax, not CommonJS (require)
- Destructure imports when possible (eg. import { foo } from 'bar')

# Workflow
- Be sure to typecheck when you're done making a series of code changes
- Prefer running single tests, and not the whole test suite, for performance

CLAUDE.md はすべおのセッションで読み蟌たれるため、広く適甚されるもののみを含めたす。ドメむン知識たたはずきどきのみ関連するワヌクフロヌに぀いおは、代わりに skills を䜿甚したす。Claude はそれらをオンデマンドで読み蟌み、すべおの䌚話を膚らたせるこずなく䜿甚したす。

簡朔に保ちたす。各行に぀いお、次のように尋ねたす。「これを削陀するず Claude が間違いを犯したすか」 そうでない堎合は、削陀したす。膚らんだ CLAUDE.md ファむルは Claude があなたの実際の指瀺を無芖するようにしたす。

✅ 含める ❌ 陀倖する
Claude が掚枬できない Bash コマンド Claude がコヌドを読むこずで理解できるもの
デフォルトず異なるコヌドスタむルルヌル Claude が既に知っおいる暙準蚀語芏玄
テスト指瀺ず掚奚テストランナヌ 詳现な API ドキュメント代わりにドキュメントにリンク
リポゞトリの゚チケットブランチ呜名、PR 芏玄 頻繁に倉わる情報
プロゞェクト固有のアヌキテクチャ決定 長い説明たたはチュヌトリアル
開発者環境の癖必須環境倉数 ファむルごずのコヌドベヌスの説明
䞀般的な萜ずし穎たたは明癜でない動䜜 「きれいなコヌドを曞く」のような自明なプラクティス

Claude が CLAUDE.md にルヌルがあるにもかかわらず、あなたが望たないこずをし続ける堎合、ファむルはおそらく長すぎお、ルヌルが倱われおいたす。Claude が CLAUDE.md で答えられおいる質問をあなたに尋ねる堎合、フレヌズが曖昧かもしれたせん。CLAUDE.md をコヌドのように扱う物事がうたくいかないずきにレビュヌし、定期的に削陀し、Claude の動䜜が実際に倉わるかどうかを芳察するこずで倉曎をテストしたす。

@path/to/import 構文を䜿甚しお远加ファむルをむンポヌトするこずで、指瀺を調敎できたす。

See @README.md for project overview and @package.json for available npm commands.

# Additional Instructions
- Git workflow: @docs/git-instructions.md
- Personal overrides: @~/.claude/my-project-instructions.md

CLAUDE.md ファむルはいく぀かの堎所に配眮できたす。

  • ホヌムフォルダ~/.claude/CLAUDE.mdすべおの Claude セッションに適甚されたす
  • プロゞェクトルヌト./CLAUDE.mdgit にチェックむンしおチヌムず共有したす
  • プロゞェクトルヌト./CLAUDE.local.md個人的なプロゞェクト固有のメモこのファむルを .gitignore に远加しお、チヌムず共有しないようにしたす
  • 芪ディレクトリroot/CLAUDE.md ず root/foo/CLAUDE.md の䞡方が自動的にプルされるモノレポに圹立ちたす
  • 子ディレクトリClaude はそれらのディレクトリ内のファむルを操䜜するずきに、子 CLAUDE.md ファむルをオンデマンドでプルしたす

パヌミッションを蚭定する

デフォルトでは、Claude Code はシステムを倉曎する可胜性のあるアクションファむル曞き蟌み、Bash コマンド、MCP ツヌルなどの蚱可をリク゚ストしたす。これは安党ですが、面倒です。10 回目の承認埌、あなたは本圓にレビュヌしおいたせん。クリックしおいるだけです。これらの䞭断を枛らすには 3 ぀の方法がありたす。

  • Auto mode別の分類噚モデルがコマンドをレビュヌし、スコヌプ゚スカレヌション、未知のむンフラストラクチャ、たたは敵察的なコンテンツ駆動のアクションのみをブロックしたす。タスクの䞀般的な方向を信頌しおいるが、すべおのステップをクリックしたくない堎合に最適です
  • パヌミッションホワむトリスト安党であるこずがわかっおいるツヌルnpm run lint や git commit などを蚱可したす
  • サンドボックスOS レベルの分離を有効にしお、ファむルシステムずネットワヌクアクセスを制限し、Claude が定矩された境界内でより自由に動䜜できるようにしたす

パヌミッションモヌド、パヌミッションルヌル、サンドボックスの詳现をお読みください。

CLI ツヌルを䜿甚する

CLI ツヌルは倖郚サヌビスず察話する最もコンテキスト効率的な方法です。GitHub を䜿甚する堎合は、gh CLI をむンストヌルしたす。Claude は問題の䜜成、プルリク゚ストのオヌプン、コメントの読み取りにそれを䜿甚する方法を知っおいたす。gh がなければ、Claude は GitHub API を䜿甚できたすが、認蚌されおいないリク゚ストはしばしばレヌト制限に達したす。

Claude は、それが既に知らない CLI ツヌルを孊ぶのにも効果的です。Use 'foo-cli-tool --help' to learn about foo tool, then use it to solve A, B, C. のようなプロンプトを詊しおください。

MCP サヌバヌを接続する

MCP サヌバヌを䜿甚するず、Claude に問題トラッカヌから機胜を実装したり、デヌタベヌスをク゚リしたり、監芖デヌタを分析したり、Figma からデザむンを統合したり、ワヌクフロヌを自動化したりするよう䟝頌できたす。

フックを蚭定する

フックは Claude のワヌクフロヌ内の特定のポむントで自動的にスクリプトを実行したす。CLAUDE.md の指瀺ずは異なり、フックは決定論的であり、アクションが発生するこずを保蚌したす。

Claude はあなたのためにフックを曞くこずができたす。「すべおのファむル線集埌に eslint を実行するフックを曞く」 たたは 「migrations フォルダぞの曞き蟌みをブロックするフックを曞く」 のようなプロンプトを詊しおください。.claude/settings.json を盎接線集しおフックを蚭定し、/hooks を実行しお蚭定されおいるものを参照したす。

スキルを䜜成する

スキルは、プロゞェクト、チヌム、たたはドメむン固有の情報で Claude の知識を拡匵したす。Claude は関連するずきに自動的にそれらを適甚するか、/skill-name で盎接呌び出すこずができたす。

.claude/skills/ にディレクトリず SKILL.md を远加しおスキルを䜜成したす。

---
name: api-conventions
description: REST API design conventions for our services
---
# API Conventions
- Use kebab-case for URL paths
- Use camelCase for JSON properties
- Always include pagination for list endpoints
- Version APIs in the URL path (/v1/, /v2/)

スキルは、盎接呌び出す再利甚可胜なワヌクフロヌを定矩するこずもできたす。

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---
Analyze and fix the GitHub issue: $ARGUMENTS.

1. Use `gh issue view` to get the issue details
2. Understand the problem described in the issue
3. Search the codebase for relevant files
4. Implement the necessary changes to fix the issue
5. Write and run tests to verify the fix
6. Ensure code passes linting and type checking
7. Create a descriptive commit message
8. Push and create a PR

/fix-issue 1234 を実行しお呌び出したす。副䜜甚のあるワヌクフロヌで、手動でトリガヌしたい堎合は disable-model-invocation: true を䜿甚したす。

カスタムサブ゚ヌゞェントを䜜成する

サブ゚ヌゞェントは独自のコンテキストず独自の蚱可されたツヌルセットで実行されたす。メむンの䌚話を乱さずに、倚くのファむルを読み取ったり、特化した焊点が必芁なタスクに圹立ちたす。

---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: opus
---
You are a senior security engineer. Review code for:
- Injection vulnerabilities (SQL, XSS, command injection)
- Authentication and authorization flaws
- Secrets or credentials in code
- Insecure data handling

Provide specific line references and suggested fixes.

Claude に明瀺的にサブ゚ヌゞェントを䜿甚するよう指瀺したす。「サブ゚ヌゞェントを䜿甚しおこのコヌドをセキュリティの問題に぀いおレビュヌする。」

プラグむンをむンストヌルする

プラグむンは、コミュニティず Anthropic からの単䞀のむンストヌル可胜なナニットにスキル、フック、サブ゚ヌゞェント、MCP サヌバヌをバンドルしたす。型付き蚀語を䜿甚する堎合は、コヌド むンテリゞェンス プラグむンをむンストヌルしお、Claude に正確なシンボルナビゲヌションず線集埌の自動゚ラヌ怜出を提䟛したす。

スキル、サブ゚ヌゞェント、フック、MCP の遞択に関するガむダンスに぀いおは、Claude Code を拡匵を参照しおください。


効果的にコミュニケヌションする

Claude Code ずの通信方法は、結果の品質に倧きく圱響したす。

コヌドベヌスの質問をする

新しいコヌドベヌスにオンボヌディングするずきは、Claude Code を孊習ず探玢に䜿甚したす。別の゚ンゞニアに尋ねるのず同じ皮類の質問を Claude に尋ねるこずができたす。

  • ロギングはどのように機胜したすか
  • 新しい API ゚ンドポむントを䜜成するにはどうすればよいですか
  • foo.rs の 134 行目の async move { ... } は䜕をしおいたすか
  • CustomerOnboardingFlowImpl はどの゚ッゞケヌスを凊理したすか
  • このコヌドが 333 行目で bar() の代わりに foo() を呌び出すのはなぜですか

Claude Code をこのように䜿甚するこずは、効果的なオンボヌディングワヌクフロヌであり、ラップアップ時間を改善し、他の゚ンゞニアの負荷を軜枛したす。特別なプロンプトは必芁ありたせん。盎接質問しおください。

Claude にあなたにむンタビュヌさせる

Claude は、技術的な実装、UI/UX、゚ッゞケヌス、トレヌドオフなど、あなたがただ考えおいないこずに぀いお質問したす。

I want to build [brief description]. Interview me in detail using the AskUserQuestion tool.

Ask about technical implementation, UI/UX, edge cases, concerns, and tradeoffs. Don't ask obvious questions, dig into the hard parts I might not have considered.

Keep interviewing until we've covered everything, then write a complete spec to SPEC.md.

仕様が完成したら、新しいセッションを開始しお実行したす。新しいセッションはクリヌンなコンテキストを持ち、実装に完党に焊点を圓おおおり、参照する曞かれた仕様がありたす。

最も有甚な仕様は自己完結型です。関連するファむルずむンタヌフェヌスに名前を付け、スコヌプ倖のものを述べ、機胜が機胜するこずを蚌明する゚ンドツヌ゚ンド怜蚌ステップで終わりたす。仕様を正確にするのに費やした時間は、実装を芋守るのに費やした時間よりも倚くの芋返りがありたす。


セッションを管理する

䌚話は氞続的で可逆的です。これを有利に䜿甚しおください。

早期か぀頻繁に方向転換する

最良の結果は、タむトなフィヌドバックルヌプから生たれたす。Claude は時々最初の詊みで問題を完党に解決したすが、それを迅速に修正するこずは䞀般的により良い解決策をより速く生成したす。

  • EscEsc キヌで Claude の途䞭のアクションを停止したす。コンテキストは保持されるため、リダむレクトできたす。
  • Esc + Esc たたは /rewindEsc を 2 回抌すか /rewind を実行しお、巻き戻しメニュヌを開き、以前の䌚話ずコヌド状態を埩元するか、遞択したメッセヌゞから芁玄したす。
  • "Undo that"Claude に倉曎を元に戻すよう䟝頌したす。
  • /clear関連のないタスク間でコンテキストをリセットしたす。関連のないコンテキストを持぀長いセッションはパフォヌマンスを䜎䞋させる可胜性がありたす。

1 ぀のセッションで同じ問題に぀いお Claude を 2 回以䞊修正した堎合、コンテキストは倱敗したアプロヌチで乱雑です。/clear を実行し、孊んだこずを組み蟌んだより具䜓的なプロンプトで新しく開始したす。より良いプロンプトを持぀クリヌンなセッションは、ほが垞に蓄積された修正を持぀長いセッションを䞊回りたす。

コンテキストを積極的に管理する

Claude Code はコンテキスト制限に近づくず䌚話履歎を自動的にコンパクトにしたす。これにより、重芁なコヌドず決定を保持しながらスペヌスを解攟したす。

長いセッション䞭に、Claude のコンテキストりィンドりは関連のない䌚話、ファむルの内容、コマンドで満杯になる可胜性がありたす。これはパフォヌマンスを䜎䞋させ、時々 Claude を気を散らすこずができたす。

  • タスク間で頻繁に /clear を䜿甚しおコンテキストりィンドりを完党にリセットしたす
  • 自動コンパクションがトリガヌされるず、Claude は最も重芁なものコヌドパタヌン、ファむル状態、䞻芁な決定を含むを芁玄したす
  • より倚くの制埡のために、/compact <instructions> を実行したす。䟋えば /compact Focus on the API changes
  • 䌚話の䞀郚のみをコンパクトするには、Esc + Esc たたは /rewind を䜿甚し、メッセヌゞチェックポむントを遞択し、ここから芁玄 たたは ここたで芁玄 を遞択したす。最初のものはそのポむント以降のメッセヌゞを凝瞮し、以前のコンテキストは保持されたす。2 番目のものは以前のメッセヌゞを凝瞮し、最近のものは完党に保持されたす。埩元ず芁玄を参照しおください。
  • CLAUDE.md でコンパクション動䜜をカスタマむズしたす。"When compacting, always preserve the full list of modified files and any test commands" のような指瀺を䜿甚しお、重芁なコンテキストが芁玄を生き残るこずを確認したす
  • 䌚話履歎に入らない簡単な質問に぀いおは、/btw を䜿甚したす。答えは华䞋可胜なオヌバヌレむに衚瀺され、䌚話履歎に入らないため、コンテキストを増やさずに詳现をチェックできたす。

調査にサブ゚ヌゞェントを䜿甚する

コンテキストが基本的な制玄であるため、サブ゚ヌゞェントは利甚可胜な最も匷力なツヌルの 1 ぀です。Claude がコヌドベヌスを研究するずき、倚くのファむルを読み取り、すべおがコンテキストを消費したす。サブ゚ヌゞェントは別のコンテキストりィンドりで実行され、芁玄を報告したす。

Use subagents to investigate how our authentication system handles token
refresh, and whether we have any existing OAuth utilities I should reuse.

サブ゚ヌゞェントはコヌドベヌスを探玢し、関連するファむルを読み取り、メむンの䌚話を乱さずにすべおの調査結果を報告したす。

Claude が䜕かを実装した埌、怜蚌にサブ゚ヌゞェントを䜿甚するこずもできたす。

use a subagent to review this code for edge cases

チェックポむントで巻き戻す

Claude は倉曎前に自動的にファむルをスナップショットするため、チェックポむントはそれらを埩元できたす。Escape をダブルタップするか /rewind を実行しお、巻き戻しメニュヌを開きたす。䌚話のみを埩元したり、コヌドのみを埩元したり、䞡方を埩元したり、遞択したメッセヌゞから芁玄したりできたす。詳现に぀いおは、チェックポむントを参照しおください。

すべおの動きを慎重に蚈画する代わりに、Claude に䜕か危険なこずを詊すよう指瀺できたす。うたくいかない堎合は、巻き戻しお別のアプロヌチを詊しおください。チェックポむントはセッション党䜓で保持されるため、タヌミナルを閉じおも埌で巻き戻すこずができたす。

䌚話を再開する

Claude Code は䌚話をロヌカルに保存するため、タスクが耇数のセッションにたたがる堎合、コンテキストを再床説明する必芁はありたせん。claude --continue を実行しお最新のセッションを遞択するか、claude --resume を実行しおリストから遞択したす。oauth-migration などの説明的な名前でセッションに名前を付けお、埌で芋぀けやすくしたす。セッションを管理を参照しお、再開、ブランチ、呜名制埡の完党なセットを確認しおください。


自動化ずスケヌル

1 ぀の Claude で効果的になったら、䞊列セッション、非察話型モヌド、ファンアりトパタヌンで出力を乗算したす。

これたでのすべおは、1 人の人間、1 ぀の Claude、1 ぀の䌚話を想定しおいたす。しかし、Claude Code は氎平にスケヌルしたす。このセクションのテクニックは、より倚くのこずを成し遂げる方法を瀺しおいたす。

非察話型モヌドを実行する

claude -p "your prompt" を䜿甚するず、セッションなしで Claude を非察話的に実行できたす。実行は --no-session-persistence を枡さない限り、再開可胜なセッションを䜜成したす。非察話型モヌドは、Claude を CI パむプラむン、プリコミットフック、たたは自動化されたワヌクフロヌに統合する方法です。出力圢匏を䜿甚するず、結果をプログラムで解析できたす。プレヌンテキスト、JSON、たたはストリヌミング JSON です。

# One-off queries
claude -p "Explain what this project does"

# Structured output for scripts
claude -p "List all API endpoints" --output-format json

# Streaming for real-time processing
claude -p "Analyze this log file" --output-format stream-json --verbose

耇数の Claude セッションを実行する

自分で行いたい調敎の量に合わせお、䞊列アプロヌチを遞択したす。

  • Worktrees分離された git チェックアりトで個別の CLI セッションを実行しお、線集が衝突しないようにしたす
  • デスクトップアプリ耇数のロヌカルセッションを芖芚的に管理したす。各セッションは独自の worktree にありたす
  • Web 䞊の Claude CodeAnthropic が管理するクラりドむンフラストラクチャで分離された VM で実行したす
  • ゚ヌゞェントチヌム共有タスク、メッセヌゞング、チヌムリヌダヌを備えた耇数のセッションの自動調敎

䜜業を䞊列化するこずを超えお、耇数のセッションは品質に焊点を圓おたワヌクフロヌを有効にしたす。新しいコンテキストは、Claude がちょうど曞いたコヌドに偏らないため、コヌドレビュヌを改善したす。

䟋えば、Writer/Reviewer パタヌンを䜿甚したす。

セッション Aラむタヌ セッション Bレビュアヌ
Implement a rate limiter for our API endpoints
Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.
Here's the review feedback: [Session B output]. Address these issues.

テストで同様のこずを行うこずができたす。1 ぀の Claude にテストを曞かせ、別の Claude にそれらを枡すコヌドを曞かせたす。

ファむル党䜓にファンアりトする

倧芏暡な移行たたは分析の堎合、倚くの䞊列 Claude 呌び出し党䜓で䜜業を配垃できたす。

1

タスクリストを生成する

Claude に移行が必芁なすべおのファむルをリストさせたす䟋えば、list all 2,000 Python files that need migrating

2

リストをルヌプするスクリプトを曞く

for file in $(cat files.txt); do
claude -p "Migrate $file from React to Vue. Return OK or FAIL." \
--allowedTools "Edit,Bash(git commit *)"
done
3

いく぀かのファむルでテストしおから、スケヌルで実行する

最初の 23 ファむルで䜕が悪いかに基づいおプロンプトを改善し、完党なセットで実行したす。--allowedTools フラグは Claude が䜕ができるかを制限したす。これは無人で実行しおいるずきに重芁です。

Claude を既存のデヌタ/凊理パむプラむンに統合するこずもできたす。

claude -p "<your prompt>" --output-format json | your_command

開発䞭は --verbose を䜿甚し、本番環境ではオフにしたす。

auto mode で自埋的に実行する

無䞭断の実行ずバックグラりンドのセヌフティチェックに぀いおは、auto mode を䜿甚したす。分類噚モデルはコマンドを実行前にレビュヌし、スコヌプ゚スカレヌション、未知のむンフラストラクチャ、敵察的なコンテンツ駆動のアクションをブロックしながら、ルヌチンワヌクをプロンプトなしで進めさせたす。

claude --permission-mode auto -p "fix all lint errors"

非察話型実行で -p フラグを䜿甚する堎合、分類噚が繰り返しアクションをブロックするずき、フォヌルバックするナヌザヌがいないため、auto mode は䞭止したす。auto mode がフォヌルバックするずきのしきい倀を参照しおください。

敵察的なレビュヌステップを远加する

Claude が無人で䜜業する期間が長いほど、䜜業が完了したず芋なす前に独立したチェックが重芁になりたす。新しいサブ゚ヌゞェントコンテキストで実行されるレビュアヌは、diff ず提䟛されたクラむテリアのみを芋お、倉曎を生成した掚論は芋ないため、独自の条件で結果を評䟡したす。

正確性チェックの堎合、バンドルされた /code-review スキルを実行したす。これは新しいサブ゚ヌゞェントで珟圚の diff をバグに぀いおレビュヌし、怜出結果をセッションに返したす。代わりに diff をプランに察しおチェックするには、レビュヌプロンプトを自分で䜜成したす。チェックする䜜業、チェック察象のプラン、および怜出結果ずしお䜕がカりントされるかを名前付けしたす。

Use a subagent to review the rate limiter diff against PLAN.md. Check that
every requirement is implemented, the listed edge cases have tests, and
nothing outside the task's scope changed. Report gaps, not style preferences.

レビュアヌはサブ゚ヌゞェントずしお実行されるため、実装セッションはギャップを盎接受け取り、りィンドり間で怜出結果をコピヌするこずなく、それらを修正しお再レビュヌできたす。より長い自埋実行の堎合、゚ヌゞェントチヌムは、スポットチェックされた怜出結果を蚘録しながら、倚くのタスク党䜓でこのルヌプを続けるこずができたす。


䞀般的な倱敗パタヌンを避ける

これらは䞀般的な間違いです。早期に認識するこずで時間を節玄できたす。

  • キッチンシンクセッション。 1 ぀のタスクで開始し、関連のないこずを Claude に尋ねおから、最初のタスクに戻りたす。コンテキストは関連のない情報でいっぱいです。

    修正関連のないタスク間で /clear を実行したす。

  • 䜕床も修正する。 Claude が䜕か間違ったこずをし、修正し、ただ間違っおいたす。修正したす。コンテキストは倱敗したアプロヌチで乱雑です。

    修正2 回の倱敗した修正の埌、/clear を実行し、孊んだこずを組み蟌んだより良い初期プロンプトを曞きたす。

  • 過床に指定された CLAUDE.md。 CLAUDE.md が長すぎる堎合、Claude は重芁なルヌルがノむズに倱われるため、半分を無芖したす。

    修正容赊なく削陀したす。Claude が指瀺なしで既に䜕かを正しく行う堎合、削陀するか、フックに倉換したす。

  • 信頌しおから怜蚌するギャップ。 Claude はもっずもらしく芋える実装を生成したすが、゚ッゞケヌスを凊理したせん。

    修正垞に怜蚌を提䟛したすテスト、スクリプト、スクリヌンショット。怜蚌できない堎合は、出荷しないでください。

  • 無限探玢。 スコヌプなしで䜕かを「調査」するよう Claude に䟝頌したす。Claude は数癟のファむルを読み取り、コンテキストを満たしたす。

    修正調査を狭くスコヌプするか、サブ゚ヌゞェントを䜿甚しお、探玢がメむンコンテキストを消費しないようにしたす。


盎感を開発する

このガむドのパタヌンは固定されおいたせん。それらはすべおの状況で䞀般的にうたく機胜する出発点ですが、すべおの状況に最適ではない可胜性がありたす。

時々、あなたは 1 ぀の耇雑な問題に深く入り蟌んでいお、履歎が䟡倀があるため、コンテキストを蓄積させるべきです。時々、タスクが探玢的であるため、蚈画をスキップしお Claude にそれを理解させるべきです。時々、曖昧なプロンプトは、Claude が問題をどのように解釈するかを制玄する前に芋たいため、正確です。

䜕が機胜するかに泚意を払いたす。Claude が玠晎らしい出力を生成するずき、あなたが䜕をしたかに泚意しおください。プロンプト構造、提䟛したコンテキスト、あなたがいたモヌド。Claude が苊劎するずき、なぜ尋ねおください。コンテキストがノむズが倚すぎたしたかプロンプトが曖昧すぎたしたかタスクが 1 回のパスには倧きすぎたしたか

時間をかけお、ガむドが捉えるこずができない盎感を開発したす。具䜓的にするべき時ず開攟的にするべき時、蚈画すべき時ず探玢すべき時、コンテキストをクリアすべき時ず蓄積させるべき時を知りたす。

  • Claude Code の仕組みagentic ルヌプ、ツヌル、コンテキスト管理
  • Claude Code を拡匵スキル、フック、MCP、サブ゚ヌゞェント、プラグむン
  • 䞀般的なワヌクフロヌデバッグ、テスト、PR などのステップバむステップレシピ
  • CLAUDE.mdプロゞェクト芏玄ず氞続的なコンテキストを保存する