2025-07-18

[MtkN1]

Today I Learned ...

[MtkN1]

https://www.anthropic.com/engineering/claude-code-best-practices

Claude Code: エージェンティックコーディングのベストプラクティス

公開日：2025年4月18日

Claude Codeは、エージェンティックコーディングのためのコマンドラインツールです。この記事では、様々なコードベース、言語、環境でClaude Codeを使用する際に効果的であることが実証されたコツやテクニックをカバーしています。

---

私たちは最近Claude Codeをリリースしました。これは、エージェンティックコーディング用のコマンドラインツールです。研究プロジェクトとして開発されたClaude Codeは、Anthropicのエンジニアや研究者がClaude を彼らのコーディングワークフローにより自然に統合するための方法を提供します。

Claude Codeは意図的に低レベルで意見を持たない設計になっており、特定のワークフローを強制することなく、生のモデルアクセスに近いものを提供しています。この設計哲学により、柔軟で、カスタマイズ可能で、スクリプト化可能で、安全なパワーツールが生まれます。強力である一方で、この柔軟性は、エージェンティックコーディングツールに慣れていないエンジニアにとって学習曲線を生み出します—少なくとも彼らが独自のベストプラクティスを開発するまでは。

この記事では、Anthropicの内部チームと、様々なコードベース、言語、環境でClaude Codeを使用している外部エンジニアの両方にとって効果的であることが実証された一般的なパターンをまとめています。このリストの項目は確定したものでも、普遍的に適用可能なものでもありません。これらの提案を出発点として考えてください。あなたに最適な方法を実験して見つけることをお勧めします！

より詳細な情報をお探しですか？claude.ai/codeにある包括的なドキュメントでは、この記事で言及されているすべての機能をカバーし、追加の例、実装の詳細、高度な技術を提供しています。

1. セットアップをカスタマイズする

Claude Codeは、プロンプトにコンテキストを自動的に取り込むエージェンティックコーディングアシスタントです。このコンテキスト収集は時間とトークンを消費しますが、環境調整によって最適化することができます。

a. CLAUDE.mdファイルを作成する

CLAUDE.mdは、Claudeが会話を開始する際に自動的にコンテキストに取り込む特別なファイルです。これは、以下のような項目を文書化するのに理想的な場所です：

• よく使うbashコマンド
• コアファイルとユーティリティ関数
• コードスタイルガイドライン
• テスト手順
• リポジトリエチケット（例：ブランチ命名、merge vs. rebase など）
• 開発者環境セットアップ（例：pyenv use、どのコンパイラが動作するかなど）
• プロジェクト特有の予期しない動作や警告
• Claudeに覚えておいてほしいその他の情報

CLAUDE.mdファイルに必須のフォーマットはありません。簡潔で人間が読みやすい形で保つことをお勧めします。例えば：

# Bash commands
- npm run build: Build the project
- npm run typecheck: Run the typechecker

# 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ファイルは以下の複数の場所に配置できます：

• リポジトリのルート、またはclaudeを実行する場所（最も一般的な使用法）。CLAUDE.mdという名前にしてgitにチェックインし、セッション間およびチームとの共有ができるようにする（推奨）、またはCLAUDE.local.mdという名前にして.gitignoreする
• claudeを実行するディレクトリの任意の親ディレクトリ。これはモノレポで最も有用で、root/fooからclaudeを実行し、root/CLAUDE.mdとroot/foo/CLAUDE.mdの両方にCLAUDE.mdファイルがある場合です。これらの両方が自動的にコンテキストに取り込まれます
• claudeを実行するディレクトリの任意の子ディレクトリ。これは上記の逆で、この場合、Claudeは子ディレクトリ内のファイルで作業するときにオンデマンドでCLAUDE.mdファイルを取り込みます
• ホームフォルダ（~/.claude/CLAUDE.md）で、すべてのclaudeセッションに適用されます

/initコマンドを実行すると、Claudeは自動的にCLAUDE.mdを生成します。

b. CLAUDE.mdファイルを調整する

CLAUDE.mdファイルはClaude のプロンプトの一部になるため、頻繁に使用されるプロンプトのように洗練されるべきです。よくある間違いは、その効果を反復検証することなく、広範な内容を追加することです。実験に時間をかけて、モデルから最高の指示実行を生み出すものを決定してください。

CLAUDE.mdにコンテンツを手動で追加するか、#キーを押してClaude に指示を与えると、Claudeは自動的にそれを関連するCLAUDE.mdに組み込みます。多くのエンジニアが、コーディング中に#を頻繁に使用してコマンド、ファイル、スタイルガイドラインを文書化し、その後CLAUDE.mdの変更をコミットに含めて、チームメンバーも恩恵を受けられるようにしています。

Anthropicでは、時々CLAUDE.mdファイルをプロンプト改善機能に通し、多くの場合指示を調整して（例：「IMPORTANT」や「YOU MUST」で強調を追加）遵守を改善します。

c. Claudeの許可されたツールのリストをキュレートする

デフォルトでは、Claude Codeはシステムを変更する可能性のある任意のアクションに対して許可を要求します：ファイル書き込み、多くのbashコマンド、MCPツールなど。Claude Codeをこのような故意に保守的なアプローチで設計したのは、安全性を優先するためです。安全であることがわかっている追加のツールを許可したり、簡単に元に戻せる危険な可能性のあるツール（例：ファイル編集、git commit）を許可するように許可リストをカスタマイズできます。

許可されたツールを管理する4つの方法があります：

• セッション中にプロンプトが表示されたときに「Always allow」を選択する
• Claude Codeを開始した後に/permissionsコマンドを使用して、許可リストにツールを追加または削除する。例えば、ファイル編集を常に許可するためにEditを追加したり、gitコミットを許可するためにBash(git commit:*)を追加したり、Puppeteer MCPサーバーでナビゲートを許可するためにmcp__puppeteer__puppeteer_navigateを追加したりできます
• .claude/settings.jsonまたは~/.claude.jsonを手動で編集（チームと共有するために前者をソースコントロールにチェックインすることをお勧めします）
• セッション固有の許可に--allowedTools CLIフラグを使用

d. GitHubを使用している場合は、gh CLIをインストールする

Claudeはgh CLIを使用してGitHubと相互作用し、課題の作成、プルリクエストのオープン、コメントの読み取りなどを行う方法を知っています。ghがインストールされていなくても、Claudeは引き続きGitHub APIまたはMCPサーバー（インストールされている場合）を使用できます。

2. Claudeにより多くのツールを与える

Claudeはシェル環境にアクセスでき、そこで自分自身のために行うのと同じように、便利なスクリプトや関数のセットを構築できます。また、MCPやREST APIを通じてより複雑なツールを活用することもできます。

a. Claudeをbashツールと組み合わせて使用する

Claude Codeはbash環境を継承し、すべてのツールにアクセスできます。Claudeはunixツールやghなどの一般的なユーティリティを知っていますが、指示なしにはカスタムbashツールについて知りません：

1. Claudeにツール名と使用例を伝える
2. Claudeに--helpを実行してツールのドキュメントを見るよう伝える
3. 頻繁に使用するツールをCLAUDE.mdに文書化する

b. ClaudeをMCPと組み合わせて使用する

Claude CodeはMCPサーバーとクライアントの両方として機能します。クライアントとして、任意の数のMCPサーバーに接続して、3つの方法でツールにアクセスできます：

• プロジェクト設定で（そのディレクトリでClaude Codeを実行しているときに利用可能）
• グローバル設定で（すべてのプロジェクトで利用可能）
• チェックインされた.mcp.jsonファイルで（コードベースで作業している誰でも利用可能）。例えば、PuppeteerとSentryサーバーを.mcp.jsonに追加して、リポジトリで作業するすべてのエンジニアがこれらをそのまま使用できるようにできます

MCPで作業するときは、設定の問題を特定するのに役立つ--mcp-debugフラグでClaude を起動することも有用です。

c. カスタムスラッシュコマンドを使用する

デバッグループ、ログ解析などの繰り返しワークフローの場合、.claude/commandsフォルダ内のMarkdownファイルにプロンプトテンプレートを保存します。これらは、/と入力したときにスラッシュコマンドメニューから利用できるようになります。これらのコマンドをgitにチェックインして、チームの他のメンバーが利用できるようにできます。

カスタムスラッシュコマンドには、特別なキーワード$ARGUMENTSを含めて、コマンド呼び出しからパラメータを渡すことができます。

例えば、GitHubの課題を自動的にプルして修正するために使用できるスラッシュコマンドは次のとおりです：

Please analyze and fix the GitHub issue: $ARGUMENTS.

Follow these steps:

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

Remember to use the GitHub CLI (`gh`) for all GitHub-related tasks.

上記の内容を.claude/commands/fix-github-issue.mdに配置すると、Claude Codeで/project:fix-github-issueコマンドとして利用できるようになります。例えば、/project:fix-github-issue 1234を使用してClaude に課題#1234を修正させることができます。同様に、すべてのセッションで利用したいコマンドについては、~/.claude/commandsフォルダに個人的なコマンドを追加できます。

3. 一般的なワークフローを試す

Claude Codeは特定のワークフローを押し付けることはなく、使いたい方法で使用する柔軟性を提供します。この柔軟性が提供する空間の中で、Claude Codeを効果的に使用するためのいくつかの成功パターンがユーザーコミュニティ全体で出現しています：

a. 探索、計画、コーディング、コミット

この汎用的なワークフローは多くの問題に適しています：

1. Claudeに関連するファイル、画像、またはURLを読むよう依頼し、一般的なポインタ（「ログを処理するファイルを読んで」）または特定のファイル名（「logging.pyを読んで」）を提供しますが、まだコードを書かないよう明示的に伝えます

   1. これは、特に複雑な問題について、サブエージェントの強力な利用を検討すべきワークフローの部分です。会話やタスクの早い段階で、特に、詳細を確認したり特定の質問を調査したりするためにサブエージェントを使用するようClaude に伝えることは、効率性の大きな損失を伴うことなく、コンテキストの可用性を保持する傾向があります

2. 特定の問題にアプローチする方法の計画をClaude に作成するよう依頼します。「think」という言葉を使用して拡張思考モードをトリガーすることをお勧めします。これにより、Claudeが代替案をより徹底的に評価するための追加の計算時間が与えられます。これらの特定のフレーズは、システム内の思考予算の増加レベルに直接マッピングされています：「think」<「think hard」<「think harder」<「ultrathink」。各レベルは、Claudeが使用する思考予算を徐々に増やします

   1. このステップの結果が合理的に見える場合、実装（ステップ3）が望むものでない場合にこの地点にリセットできるように、Claudeに計画の文書やGitHub課題を作成させることができます

3. Claudeにソリューションをコードで実装するよう依頼します。これは、ソリューションの部分を実装する際にそのソリューションの合理性を明示的に検証するよう求める良い場所でもあります

4. Claudeに結果をコミットしてプルリクエストを作成するよう依頼します。関連する場合、これはまた、Claudeに今行ったことの説明でREADMEやchangelogを更新させる良いタイミングでもあります

ステップ#1-#2は重要です—これらなしに、Claudeはすぐにソリューションのコーディングに飛び込む傾向があります。時にはそれが望むことかもしれませんが、まずClaude に研究と計画を依頼することで、最初により深い思考を必要とする問題のパフォーマンスが大幅に向上します。

b. テストを書く、コミット；コード、反復、コミット

これは、単体、統合、またはエンドツーエンドテストで簡単に検証できる変更に対するAnthropicお気に入りのワークフローです。テスト駆動開発（TDD）は、エージェンティックコーディングでさらに強力になります：

1. 期待される入力/出力ペアに基づいてテストを書くようClaude に依頼します。テスト駆動開発を行っていることを明示して、コードベースにまだ存在しない機能に対してもモック実装の作成を避けるようにしてください

2. Claudeにテストを実行して失敗することを確認するよう伝えます。この段階では実装コードを書かないよう明示的に伝えることがしばしば有用です

3. テストに満足したらClaude にテストをコミットするよう依頼します

4. Claudeにテストに合格するコードを書くよう依頼し、テストを変更しないよう指示します。すべてのテストに合格するまで続けるようClaude に伝えます。Claudeがコードを書き、テストを実行し、コードを調整し、再びテストを実行するのに、通常数回の反復が必要です

   1. この段階では、実装がテストにオーバーフィットしていないことを独立したサブエージェントで検証するよう依頼することが有用です

5. 変更に満足したらClaude にコードをコミットするよう依頼します

Claudeは、ビジュアルモック、テストケース、または他の種類の出力など、反復するための明確なターゲットがあるときに最高のパフォーマンスを発揮します。テストなどの期待される出力を提供することで、Claudeは変更を行い、結果を評価し、成功するまで段階的に改善できます。

c. コードを書く、結果をスクリーンショット、反復

テストワークフローと同様に、Claudeにビジュアルターゲットを提供できます：

1. Claudeにブラウザスクリーンショットを撮る方法を与える（例：Puppeteer MCPサーバー、iOS シミュレータMCPサーバー、またはClaude にスクリーンショットを手動でコピー/ペーストする）

2. Claudeにビジュアルモックを与える（画像のコピー/ペーストまたはドラッグ&ドロップ、またはClaude に画像ファイルパスを与える）

3. Claudeにコードでデザインを実装し、結果のスクリーンショットを撮り、その結果がモックと一致するまで反復するよう依頼

4. 満足したらClaude にコミットするよう依頼

人間と同様に、Claudeの出力は反復により大幅に改善される傾向があります。最初のバージョンは良いかもしれませんが、2-3回の反復後には通常はるかに良く見えます。最良の結果のために、Claudeに出力を見るツールを与えてください。

d. 安全なYOLOモード

Claudeを監視する代わりに、claude --dangerously-skip-permissionsを使用してすべての許可チェックをバイパスし、Claudeが完了まで中断されずに作業できるようにできます。これは、lintエラーの修正やボイラープレートコードの生成などのワークフローでうまく機能します。

Claudeに任意のコマンドを実行させることは危険で、データ損失、システム破損、さらにはデータ流出（例：プロンプトインジェクション攻撃による）を引き起こす可能性があります。これらのリスクを最小限に抑えるため、インターネットアクセスのないコンテナで--dangerously-skip-permissionsを使用してください。Docker Dev Containersを使用したこの参考実装に従うことができます。

e. コードベースQ&A

新しいコードベースにオンボーディングするときは、学習と探索にClaude Codeを使用してください。ペアプログラミング時にプロジェクトの他のエンジニアに尋ねるのと同じ種類の質問をClaude に尋ねることができます。Claudeは以下のような一般的な質問に答えるために、エージェンティックにコードベースを検索できます：

• ログはどのように動作しますか？
• 新しいAPIエンドポイントを作るにはどうすればよいですか？
• foo.rsの134行目のasync move { ... }は何をしますか？
• CustomerOnboardingFlowImplはどのような極端なケースを処理しますか？
• なぜ333行目でbar()の代わりにfoo()を呼んでいるのですか？
• baz.pyの334行目のJavaでの同等物は何ですか？

Anthropicでは、この方法でClaude Codeを使用することが我々の核心的なオンボーディングワークフローになり、立ち上がり時間を大幅に改善し、他のエンジニアへの負荷を削減しています。特別なプロンプティングは必要ありません！単純に質問すれば、Claudeがコードを探索して答えを見つけます。

f. Claudeを使ったgitとの相互作用

Claudeは多くのgit操作を効果的に処理できます。多くのAnthropicエンジニアは、git相互作用の90%以上にClaude を使用しています：

• githistoryを検索して、「v1.2.3にはどのような変更が含まれましたか？」、「この特定の機能の所有者は誰ですか？」、または「なぜこのAPIはこのように設計されたのですか？」といった質問に答える。このような質問に答えるために、githistoryを調べるようClaude に明示的にプロンプトすることが有用です

• コミットメッセージの作成。Claudeは変更と最近の履歴を自動的に見て、関連するすべてのコンテキストを考慮したメッセージを作成します

• 複雑なgit操作の処理（ファイルの復元、rebaseコンフリクトの解決、パッチの比較と移植など）

g. Claudeを使ったGitHubとの相互作用

Claude CodeはGitHubの多くの相互作用を管理できます：

• プルリクエストの作成：Claudeは「pr」という省略形を理解し、差分と周囲のコンテキストに基づいて適切なコミットメッセージを生成します

• 単純なコードレビューコメントに対するワンショット解決の実装：PRのコメントを修正するよう伝える（任意で、より具体的な指示を与える）だけで、完了したらPRブランチにプッシュバックします

• 失敗したビルドやリンターの警告の修正

• オープンな課題の分類とトリアージ（Claudeにオープンなgithub課題をループするよう依頼）

これにより、ghコマンドライン構文を覚える必要がなくなり、ルーチンタスクを自動化できます。

h. Claudeを使ったJupyterノートブックでの作業

AnthropicのResearchersとdata scientistsは、Jupyter notebooksの読み書きにClaude Codeを使用しています。Claudeは画像を含む出力を解釈でき、データの探索と相互作用のための高速な方法を提供します。必須のプロンプトやワークフローはありませんが、推奨するワークフローは、VS CodeでClaude Codeと.ipynbファイルを並べて開くことです。

また、同僚に見せる前に、Jupyter notebookのクリーンアップや美的改善をClaude に依頼することもできます。ノートブックやそのデータ可視化を「美的に魅力的」にするよう明確に伝えることで、人間の視聴体験に最適化していることをClaude に思い出させることができます。

4. ワークフローを最適化する

以下の提案はすべてのワークフローに適用されます：

a. 指示を具体的にする

Claude Codeの成功率は、特に最初の試行において、より具体的な指示で大幅に向上します。最初に明確な方向性を与えることで、後での修正の必要性を減らします。

例えば：

悪い	良い
foo.pyのテストを追加	foo.pyの新しいテストケースを書いて、ユーザーがログアウトしているエッジケースをカバーする。モックは避ける
なぜExecutionFactoryはそんな奇妙なAPIを持っているの？	ExecutionFactoryのgit履歴を調べて、そのAPIがどのようになったかを要約する
カレンダーウィジェットを追加	ホームページの既存のウィジェットがどのように実装されているかを調べて、パターンとコードとインターフェースがどのように分離されているかを理解する。HotDogWidget.phpが開始するのに良い例。その後、パターンに従って、ユーザーが月を選択し、前後にページネートして年を選ぶことができる新しいカレンダーウィジェットを実装する。コードベースの残りで既に使用されているライブラリ以外のライブラリなしでゼロから構築

Claudeは意図を推測できますが、心を読むことはできません。具体性は期待との整合性向上につながります。

b. Claudeに画像を与える

Claudeは複数の方法で画像や図表に優れています：

• スクリーンショットの貼り付け（プロチップ：macOSでcmd+ctrl+shift+4でクリップボードにスクリーンショットし、ctrl+vでペースト。これはmacで通常ペーストに使用するcmd+vではなく、リモートでは動作しないことに注意）
• 画像をプロンプト入力に直接ドラッグ&ドロップ
• 画像のファイルパスを提供

これは、UI開発の参照点としてデザインモックで作業する際や、分析とデバッグのための視覚的チャートで特に有用です。コンテキストにビジュアルを追加していない場合でも、結果が視覚的に魅力的であることがどれほど重要かをClaude に明確にすることが役立つ場合があります。

c. Claudeに見てもらいたい、または作業してもらいたいファイルを言及する

タブ補完を使用して、リポジトリ内の任意の場所のファイルやフォルダを素早く参照し、Claudeが適切なリソースを見つけたり更新したりするのを助けます。

d. Claudeに URLを与える

プロンプトと一緒に特定のURLを貼り付けて、Claudeが取得して読むようにします。同じドメイン（例：docs.foo.com）の許可プロンプトを避けるために、/permissionsを使用してドメインを許可リストに追加してください。

e. 早期に頻繁に軌道修正する

オートアクセプトモード（shift+tabでトグル）によりClaude は自律的に作業できますが、通常は積極的な協力者になってClaude のアプローチを導くことでより良い結果が得られます。始めにタスクをClaude に徹底的に説明することで最良の結果を得ることができますが、いつでもClaude を軌道修正することもできます。

これらの4つのツールが軌道修正に役立ちます：

• Claudeにコーディング前に計画を立てるよう依頼し、計画が良さそうだと確認するまでコーディングしないよう明示的に伝える
• Escapeを押してClaude を中断（思考、ツール呼び出し、ファイル編集の任意のフェーズで）、コンテキストを保持して指示をリダイレクトまたは拡張できる
• Escapeをダブルタップして履歴に戻る、以前のプロンプトを編集し、異なる方向を探る。探している結果が得られるまでプロンプトを編集し、繰り返すことができる
• Claudeに変更を元に戻すよう依頼、しばしばオプション#2と併用して異なるアプローチを取る

Claude Codeが最初の試行で問題を完璧に解決することもありますが、これらの修正ツールを使用することで、一般的により良いソリューションをより早く生み出します。

f. /clearを使用してコンテキストを集中させる

長いセッション中に、Claudeのコンテキストウィンドウは無関係な会話、ファイル内容、コマンドで満たされることがあります。これはパフォーマンスを低下させ、時にはClaude を気散らしさせる可能性があります。タスク間で頻繁に/clearコマンドを使用して、コンテキストウィンドウをリセットしてください。

g. 複雑なワークフローにはチェックリストとスクラッチパッドを使用する

コード移行、多数のlintエラーの修正、複雑なビルドスクリプトの実行など、複数のステップを持つ大きなタスクや網羅的な解決策を必要とするタスクでは、Claudeにチェックリストと作業用スクラッチパッドとしてMarkdownファイル（またはGitHub課題！）を使用させることでパフォーマンスを向上させます：

例えば、多数のlint問題を修正するには、以下を行うことができます：

1. Claudeにlintコマンドを実行するよう伝え、すべての結果エラー（ファイル名と行番号付き）をMarkdownチェックリストに書く
2. Claudeに各問題に一つずつ対処するよう指示し、修正して検証してからチェックし、次に移る

h. Claudeにデータを渡す

Claudeにデータを提供するための複数の方法があります：

• プロンプトに直接コピー&ペースト（最も一般的なアプローチ）
• Claude Codeにパイプ（例：cat foo.txt | claude）、ログ、CSV、大きなデータに特に有用
• bashコマンド、MCPツール、またはカスタムスラッシュコマンドでデータをプルするようClaude に伝える
• Claudeにファイルを読むかURLを取得するよう依頼（画像でも動作）

ほとんどのセッションはこれらのアプローチの組み合わせを含みます。例えば、ログファイルをパイプで送り、その後Claudeにツールを使用してログをデバッグするための追加コンテキストをプルするよう伝えることができます。

5. ヘッドレスモードを使用してインフラを自動化する

Claude Codeには、CI、pre-commitフック、ビルドスクリプト、自動化などの非対話型コンテキスト用のヘッドレスモードが含まれています。プロンプトと一緒に-pフラグを使用してヘッドレスモードを有効にし、ストリーミングJSON出力には--output-format stream-jsonを使用してください。

ヘッドレスモードはセッション間で持続しないことに注意してください。各セッションでトリガーする必要があります。

a. 課題トリアージでClaude を使用する

ヘッドレスモードは、リポジトリで新しい課題が作成されるときなど、GitHubイベントによってトリガーされる自動化を強化できます。例えば、公開Claude Codeリポジトリは、新しい課題が入ってくるとClaude を使用して検査し、適切なラベルを割り当てます。

b. リンターとしてClaude を使用する

Claude Codeは、伝統的なリンティングツールが検出するものを超えて主観的コードレビューを提供でき、誤字、古いコメント、誤解を招く関数や変数名などの問題を特定します。

6. マルチClaude ワークフローでレベルアップ

単体使用以外に、最も強力なアプリケーションのいくつかは、複数のClaude インスタンスを並行して実行することです：

a. 一つのClaude にコードを書かせ、別のClaude に検証させる

シンプルで効果的なアプローチは、一つのClaude にコードを書かせ、別のものにレビューまたはテストさせることです。複数のエンジニアと作業するのと同様に、時には別々のコンテキストを持つことが有益です：

1. Claudeを使用してコードを書く
2. /clearを実行するか、別のターミナルで2つ目のClaude を開始する
3. 2つ目のClaude に最初のClaude の作業をレビューさせる
4. 別のClaude を開始（または再び/clear）して、コードとレビューフィードバックの両方を読む
5. このClaude にフィードバックに基づいてコードを編集させる

テストでも同様のことができます：一つのClaude にテストを書かせ、その後別のClaude にテストを通すコードを書かせます。Claude インスタンスに別々の作業用スクラッチパッドを与え、どちらに書くべきか、どちらから読むべきかを伝えることで、お互いにコミュニケーションを取らせることもできます。

この分離は、しばしば単一のClaude にすべてを処理させるよりも良い結果をもたらします。

b. リポジトリの複数のチェックアウトを持つ

Claudeが各ステップを完了するのを待つ代わりに、Anthropicの多くのエンジニアが行うことは：

1. 3-4個のgitチェックアウトを作成する（別々のフォルダに）
2. 各フォルダを開く（別々のターミナルタブで）
3. 各フォルダでClaude を開始（異なるタスクで）
4. 循環して進捗をチェックし、許可リクエストを承認/拒否する

c. git worktreesを使用する

このアプローチは複数の独立したタスクで優れており、複数のチェックアウトに対する軽量な代替案を提供します。Git worktreesにより、同じリポジトリから複数のブランチを別々のディレクトリにチェックアウトできます。各worktreeは独自の作業ディレクトリを持ち、ファイルが分離されていながら、同じGit履歴とreflogを共有します。

git worktreesを使用することで、プロジェクトの異なる部分で複数のClaude セッションを同時に実行でき、それぞれが独自の独立したタスクに集中できます。例えば、一つのClaude に認証システムをリファクタリングさせながら、別のものに完全に無関係なデータ可視化コンポーネントを構築させることができます。タスクが重複しないため、各Claudeは他の変更を待ったりマージコンフリクトを処理したりすることなく、フルスピードで作業できます：

1. worktreesを作成：git worktree add ../project-feature-a feature-a
2. 各worktreeでClaude を起動：cd ../project-feature-a && claude
3. 必要に応じて追加のworktreesを作成（新しいターミナルタブでステップ1-2を繰り返す）

いくつかのコツ：

• 一貫したネーミング規則を使用する
• worktreeごとに1つのターミナルタブを維持する
• MacでiTerm2を使用している場合、Claudeが注意を必要とするときのために通知を設定する
• 異なるworktreesに別々のIDEウィンドウを使用する
• 完了したらクリーンアップ：git worktree remove ../project-feature-a

d. カスタムハーネスでヘッドレスモードを使用する

claude -p（ヘッドレスモード）は、内蔵ツールとシステムプロンプトを活用しながら、Claude Codeをより大きなワークフローにプログラム的に統合します。ヘッドレスモードを使用する2つの主要なパターンがあります：

1. ファンアウトは大きな移行や分析を処理します（例：数百のログの感情分析や数千のCSVの分析）：

   1. Claudeにタスクリストを生成するスクリプトを書かせます。例えば、フレームワークAからBに移行する必要がある2kファイルのリストを生成します
   2. タスクをループし、それぞれに対してClaude をプログラム的に呼び出し、タスクと使用できるツールのセットを与えます。例：claude -p "migrate foo.py from React to Vue. When you are done, you MUST return the string OK if you succeeded, or FAIL if the task failed." --allowedTools Edit Bash(git commit:*)
   3. スクリプトを数回実行し、望む結果を得るためにプロンプトを洗練します

2. パイプライニングは既存のデータ/処理パイプラインにClaude を統合します：

   1. claude -p "<your prompt>" --json | your_commandを呼び出します。ここでyour_commandは処理パイプラインの次のステップです
   2. それだけです！JSON出力（オプション）は、より簡単な自動処理のための構造を提供するのに役立ちます

これらのユースケースの両方で、Claudeの呼び出しをデバッグするために--verboseフラグを使用することが有用な場合があります。プロダクションでは、よりクリーンな出力のためにバーボーズモードをオフにすることを一般的にお勧めします。

Claude Codeで作業するためのコツやベストプラクティスは何ですか？@AnthropicAIをタグして、あなたが構築しているものを見せてください！

謝辞

執筆者：Boris Cherny。この作品は、創造的なアプローチとワークフローが我々にインスピレーションを与え続けているより広範なClaude Codeユーザーコミュニティ全体のベストプラクティスを基にしています。また、Claude Codeでの貴重な洞察と実践的経験が、これらの推奨事項の形成に役立ったDaisy Hollman、Ashwin Bhat、Cat Wu、Sid Bidasaria、Cal Rueb、Nodir Turakulov、Barry Zhang、Drew Hodun、その他多くのAnthropicエンジニアにも特別な感謝を捧げます。