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

​

Claude に自分の作業を検証する方法を与える

• 1 つのプロンプトで：Claude にチェックを実行し、同じメッセージ内で反復するよう求めます。上記の表のように。
• セッション全体で：チェックを/goal 条件として設定します。別の評価者がすべてのターンの後に再度チェックし、Claude はそれが保持されるまで作業を続けます。Claude が停止した場合、Claude Code は最終的にゴールがまだ設定されたままでランを停止します。/goal 評価がどのように機能するかを参照してください。
• 決定論的ゲートとして：Stop hook がスクリプトとしてチェックを実行し、合格するまでターンが終了するのをブロックします。Stop input は連続ブロックの上限をカバーします。
• 第二の意見によって：検証サブエージェントまたは動的ワークフローが独自の調査結果をチェックし、新しいモデルが結果を反論しようとするため、作業を行っているエージェントがそれを採点しているわけではありません。

​

最初に探索し、次に計画し、その後コーディングする

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

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

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

commit with a descriptive message and open a PR

​

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

​

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

• @ でファイルを参照する コードがどこにあるかを説明する代わりに。Claude は応答する前にファイルを読み取ります。
• 画像を直接貼り付ける。画像をコピー/貼り付けまたはドラッグアンドドロップしてプロンプトに入れます。
• ドキュメントと API リファレンスの URL を指定する。/permissions を使用して、頻繁に使用されるドメインを許可リストに登録します。
• データをパイプする cat error.log | claude -p "explain this error" を実行してファイルの内容を直接送信します。
• Claude に必要なものを取得させる。Bash コマンド、MCP ツール、またはファイルを読み取ることを使用して、Claude 自身がコンテキストをプルするよう指示します。

​

環境を設定する

​

効果的な 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

​

権限を設定する

• 権限ホワイトリスト：npm run lint や git commit など、安全であることがわかっているツールを許可します
• サンドボックス：OS レベルの分離を有効にして、ファイルシステムとネットワークアクセスを制限し、Claude が定義された境界内でより自由に動作できるようにします

​

CLI ツールを使用する

​

MCP サーバーを接続する

​

フックを設定する

​

スキルを作成する

---
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

​

カスタムサブエージェントを作成する

---
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.

​

プラグインをインストールする

​

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

​

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

• ロギングはどのように機能しますか？
• 新しい API エンドポイントを作成するにはどうすればよいですか？
• foo.rs の 134 行目の async move { ... } は何をしていますか？
• CustomerOnboardingFlowImpl はどのエッジケースを処理しますか？
• このコードが 333 行目で bar() の代わりに foo() を呼び出すのはなぜですか？

​

Claude にあなたにインタビューさせる

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.

​

セッションを管理する

​

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

• Esc：Esc キーで Claude の途中のアクションを停止します。コンテキストは保持されるため、リダイレクトできます。
• Esc + Esc または /rewind：Esc を 2 回押すか /rewind を実行して、巻き戻しメニューを開き、以前の会話とコード状態を復元するか、選択したメッセージから要約します。
• "Undo that"：Claude に変更を元に戻すよう依頼します。
• /clear：関連のないタスク間でコンテキストをリセットします。関連のないコンテキストを持つ長いセッションはパフォーマンスを低下させる可能性があります。

​

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

• タスク間で頻繁に /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 を使用します。答えは会話履歴に入らないため、コンテキストを増やさずに詳細をチェックできます。

​

調査にサブエージェントを使用する

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

​

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

​

会話を再開する

​

自動化とスケール

​

非対話モードを実行する

# 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 で実行できます
• クラウドで Claude Code を使用する：デフォルトで Anthropic が管理するインフラストラクチャ上でセッションを実行します
• エージェントビュー：リサーチプレビュー。claude agents を実行して、バックグラウンドで実行し続けるセッションをディスパッチし、1 つの画面から監視します
• エージェントチーム：実験的で、デフォルトで無効です。共有タスク、メッセージング、チームリーダーを備えた複数のセッションの自動調整

​

ファイル全体にファンアウトする

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

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

​

auto モードで自律的に実行する

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

​

敵対的なレビューステップを追加する

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 は数百のファイルを読み取り、コンテキストを満たします。

  修正：調査を狭くスコープするか、サブエージェントを使用して、探索がメインコンテキストを消費しないようにします。

​

直感を開発する

​

関連リソース

• Claude Code の仕組み：agentic ループ、ツール、コンテキスト管理
• Claude Code を拡張：スキル、フック、MCP、サブエージェント、プラグイン
• 一般的なワークフロー：デバッグ、テスト、PR などのステップバイステップレシピ
• CLAUDE.md：プロジェクト規約と永続的なコンテキストを保存する