環境設定

CLAUDE.md

CLAUDE.md はプロジェクト固有の指示を Claude に永続的に伝えるためのファイルです。

基本的な使い方

claude /init

このコマンドで CLAUDE.md のひな形が自動生成されます。

含めるべき内容

# コードスタイル
- ES modules (import/export) を使用
- シングルクォートを使用
- セミコロンなし

# ワークフロー
- 変更後は `npm run typecheck` を実行
- テストは `npm test` で実行

# プロジェクト構造
- src/: ソースコード
- tests/: テストファイル

含めるべきでないもの

標準的な慣例: Claude は一般的なパターンを理解している
過度に詳細な説明: 長すぎると重要な情報が埋もれる
頻繁に変わる情報: その都度指示した方がよい

配置場所

場所	用途
`~/.claude/CLAUDE.md`	全プロジェクト共通の設定
`./CLAUDE.md`	プロジェクト固有の設定
`./src/CLAUDE.md`	ディレクトリ固有の設定

権限設定

Claude Code の権限を細かく制御できます。

コマンドの許可

claude /permissions

よく使うコマンドをホワイトリストに追加：

# 安全なコマンドを許可
npm test
npm run build
git status

サンドボックス

claude /sandbox

OS レベルの分離を有効にし、より安全な実行環境を構築します。

MCP サーバー

MCP（Model Context Protocol）サーバーを使うと、外部ツールと連携できます。

サーバーの追加

claude mcp add notion
claude mcp add postgresql

活用例

サーバー	用途
Notion	ドキュメント検索・更新
PostgreSQL	データベースクエリ
Figma	デザインデータ取得
Slack	通知送信

Hooks

Hooks は特定のイベントで自動実行されるスクリプトです。

CLAUDE.md との違い

項目	CLAUDE.md	Hooks
性質	助言的（従わないこともある）	決定論的（必ず実行）
実行タイミング	常に参照	イベント発生時
用途	スタイルガイド、ルール	自動処理、検証

設定例

pre-commit:
  - npm run lint
  - npm run typecheck

post-edit:
  - npm run format

Skills

Skills は再利用可能な指示セットです。

作成方法

.claude/skills/ ディレクトリに SKILL.md を配置：

# デプロイスキル

## 手順
1. テストを実行
2. ビルドを作成
3. ステージング環境にデプロイ
4. 動作確認

呼び出し方

/skill deploy

カスタムサブエージェント

専門的なタスク用に独立したコンテキストを持つサブエージェントを定義できます。

用途

大きなコードベースの特定部分に特化
特定のドメイン知識を持たせる
コンテキストを分離して効率化

まとめ

CLAUDE.md でプロジェクト固有の指示を永続化
権限設定 でセキュリティを確保
MCP で外部サービスと連携
Hooks で自動処理を実現
Skills で再利用可能な指示を作成

Q1. CLAUDE.mdに含めるべきでないものは？

Q2. Hooksの特徴として正しいのは？

Q3. MCPサーバーでできることは？