Анатомия папки .claude/

Анатомия папки .claude/

Папка .claude/ — это конфигурационный центр Claude Code для конкретного проекта. Разберём каждый элемент.

Полная структура .claude/

.claude/
├── settings.json          # Настройки разрешений и поведения
├── mcp.json              # MCP-серверы для проекта
├── skills/               # Кастомные slash-команды
│   ├── component.md
│   ├── commit.md
│   └── review.md
├── rules/                # Модульные правила (альтернатива CLAUDE.md)
│   ├── typescript.md
│   └── testing.md
└── memory/               # Автоматическая память (создаётся Claude)
    ├── MEMORY.md         # Индекс воспоминаний
    └── user_prefs.md     # Конкретные воспоминания

settings.json

{
  "permissions": {
    "allow": [
      "Read",
      "Edit",
      "Bash(npm run *)",
      "Bash(git add *)",
      "Bash(git commit *)",
      "Bash(git status)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)"
    ]
  },
  "model": "claude-sonnet-4-6",
  "env": {
    "NODE_ENV": "development"
  }
}

mcp.json

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://localhost/mydb"
      }
    }
  }
}

Коммитить или нет?

Файл	Коммитить?
settings.json	Да (без секретов)
mcp.json	Осторожно (не коммитить API ключи)
skills/	Да
rules/	Да
memory/	Нет (.gitignore)

Рекомендуемый .gitignore:

.claude/memory/
.claude/mcp.json  # если содержит ключи

Глобальная папка ~/.claude/

Аналогичная структура, но для всех проектов:

~/.claude/
├── settings.json    # Глобальные настройки
├── CLAUDE.md        # Глобальные инструкции
├── skills/          # Глобальные skills
└── memory/          # Глобальная память

Проектные настройки переопределяют/дополняют глобальные.

Итог

• .claude/ — конфигурационный центр проекта для Claude Code
• settings.json — разрешения и модель
• mcp.json — подключение внешних сервисов
• skills/ — slash-команды проекта
• memory/ — в .gitignore