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

​

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

​

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

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 を実行してファイルの内容を直接送信します。
• 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

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/CLAUDE.md）：すべての Claude セッションに適用されます
• プロジェクトルート（./CLAUDE.md）：git にチェックインしてチームと共有します
• 親ディレクトリ：root/CLAUDE.md と root/foo/CLAUDE.md の両方が自動的にプルされるモノレポに役立ちます
• 子ディレクトリ：Claude はそれらのディレクトリ内のファイルを操作するときに、子 CLAUDE.md ファイルをオンデマンドでプルします

​

パーミッションを設定する

• パーミッションホワイトリスト：安全であることがわかっているツール（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 を使用し、メッセージチェックポイントを選択し、ここから要約を選択します。これにより、そのポイント以降のメッセージが凝縮され、以前のコンテキストは保持されます。
• 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.

use a subagent to review this code for edge cases

​

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

​

会話を再開する

claude --continue    # Resume the most recent conversation
claude --resume      # Select from recent conversations

​

自動化とスケール

​

非対話型モードを実行する

# 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

​

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

• Claude Code デスクトップアプリ：複数のローカルセッションを視覚的に管理します。各セッションは独自の分離されたワークツリーを取得します。
• Web 上の Claude Code：Anthropic のセキュアなクラウドインフラストラクチャで分離された VM で実行します。
• エージェントチーム：共有タスク、メッセージング、チームリーダーを備えた複数のセッションの自動調整。

​

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

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

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

​

一般的な失敗パターンを避ける

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

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

• 何度も修正する。 Claude が何か間違ったことをし、修正し、まだ間違っています。修正します。コンテキストは失敗したアプローチで乱雑です。

  修正：2 回の失敗した修正の後、/clear を実行し、学んだことを組み込んだより良い初期プロンプトを書きます。

• 過度に指定された CLAUDE.md。 CLAUDE.md が長すぎる場合、Claude は重要なルールがノイズに失われるため、半分を無視します。

  修正：容赦なく削除します。Claude が指示なしで既に何かを正しく行う場合、削除するか、フックに変換します。

• 信頼してから検証するギャップ。 Claude はもっともらしく見える実装を生成しますが、エッジケースを処理しません。

  修正：常に検証を提供します（テスト、スクリプト、スクリーンショット）。検証できない場合は、出荷しないでください。

• 無限探索。 スコープなしで何かを「調査」するよう Claude に依頼します。Claude は数百のファイルを読み取り、コンテキストを満たします。

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

​

直感を開発する

​

関連リソース

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