Claude Code Guide

Claude Code ガイド

目的

Claude Code（エージェント型コーディングツール）の設定と利用について、その性能を最大限に引き出すための包括的なリファレンスを提供することです。このスキルは、ベストプラクティス、設定テンプレート、高度な利用パターンをまとめたものです。

設定（CLAUDE.md）

新しいプロジェクトを開始するときは、ルートディレクトリに CLAUDE.md ファイルを作成して、エージェントを導いてください。

テンプレート（一般）

# Project Guidelines

## Commands

- Run app: `npm run dev`
- Test: `npm test`
- Build: `npm run build`

## Code Style

- Use TypeScript for all new code.
- Functional components with Hooks for React.
- Tailwind CSS for styling.
- Early returns for error handling.

## Workflow

- Read `README.md` first to understand project context.
- Before editing, read the file content.
- After editing, run tests to verify.

高度な機能

思考キーワード

プロンプトでこれらのキーワードを使用すると、エージェントにより深い推論を促すことができます。

• "Think step-by-step"
• "Analyze the root cause"
• "Plan before executing"
• "Verify your assumptions"

デバッグ

エージェントが行き詰まったり、予期しない動作をしたりする場合は、次の方法を試してください。

1. コンテキストのクリア: 新しいセッションを開始するか、混乱している場合は "forget previous instructions" とエージェントに依頼してください。
2. 明示的な指示: パス、ファイル名、期待する結果について、非常に具体的に指示してください。
3. ログ: "check the logs" と依頼するか、"run the command with verbose output" と依頼してください。

ベストプラクティス

1. 小さなコンテキスト: コードベース全体をコンテキストに流し込まないでください。まず grep または find を使って関連するファイルを見つけてください。
2. 反復的な開発: 小さな変更を依頼し、検証してから次に進んでください。
3. フィードバックループ: エージェントがミスをした場合は、すぐに修正し、（サポートされていれば）そのメモリまたは CLAUDE.md に "add a lesson" と依頼してください。

リファレンス

Claude Code Guide by zebbern を基にしています。