.claude/フォルダとは？構造と活用法を徹底解説

Anthropic社のAIアシスタント「Claude」をCLI環境で活用していますか？.claude/フォルダは、Claude CLIの設定やカスタマイズ情報を一元管理する重要なディレクトリです。本稿では、その構造と効果的な活用法を解説します。

.claude/フォルダの基本構造

.claude/フォルダは、Claude CLIのホームディレクトリに自動生成される隠しフォルダです。主要なサブディレクトリとして以下が存在します。

.claude/
├── settings.json      # グローバル設定
├── commands/          # カスタムコマンド定義
├── context/           # コンテキスト管理ファイル
└── logs/              # 実行ログ

各ファイルやディレクトリは、CLI動作の特定の側面を制御します。プロジェクトごとに独自の.claude/フォルダを作成し、ローカル設定を適用することも可能です。

settings.jsonで設定をカスタマイズする

settings.jsonは、Claude CLIの動作を制御する核心ファイルです。主な設定項目を確認しましょう。

{
  "model": "claude-opus-4",
  "maxTokens": 8192,
  "temperature": 0.7,
  "permissions": {
    "allowEdits": true,
    "allowExecute": false
  }
}

プロジェクトルートに.claude.jsonを配置すると、グローバル設定をオーバーライドできます。この仕組みにより、開発環境ごとに異なる設定を活用できます。

カスタムコマンドで効率を最大化

commands/ディレクトリには、独自のスラッシュコマンドを定義できます。

.claude/commands/
├── code-review.md
├── test-generator.md
└── docs-summary.md

コマンド定義ファイルはMarkdown形式で記述します。

name: code-review
description: コードレビューを実施
tools: read, write, bash
、指定されたファイルを静的解析し、
潜在的な問題点和改善点を報告します。

定義したコマンドは、/code-reviewのようにClaudeから呼び出せます。

.claude/フォルダの管理ベストプラクティス
効果的な運用には、いくつかのポイントがあります。プロジェクトごとに`.gitignore`に`.claude/`を追加し機密情報を除外すること、定期的なバックアップを取得すること、そして設定変更前にバックアップを取ることが重要です。
特に`permissions`設定はセキュリティに直結するため、意図しない変更を避けるべきです。