Claude Code — Архитектура и настройки

Раздел: architect/claude-code/
Назначение: Вся документация, история и структура настроек Claude Code и других LLM на платформе.

LLM на платформе

LLM	Раздел	Статус
Claude (Anthropic)	claude/	✅ Активен
Gemini (Google / OpenRouter)	gemini/	🔲 Заготовка
OpenAI	openai/	🔲 Заготовка

Рабочие файлы Claude Code в платформе

Здесь не хранятся — здесь указывается где они живут и зачем.

Системные инструкции (Output Styles)

Файл	Путь	Назначение
default.md	`.claude/output-styles/default.md`	Основная системная инструкция (активна автоматически)
SafeDialog.md	`.claude/output-styles/SafeDialog.md`	Резервная инструкция (идентична Default)

Как работает: При старте Claude Code читает стиль из defaultStyle в settings.json.
keep-coding-instructions: false — стиль полностью заменяет базовый системный промпт Anthropic (Layer 1).

Настройки

Файл	Путь	Назначение
settings.json (глобальный)	`/root/.claude/settings.json`	`outputStyle`, `model`, `theme`, `env`, плагины — только здесь
settings.json (проект)	`.claude/settings.json`	Только permissions и hooks

Запрещено:
- ❌ outputStyle / model / theme в проектном .claude/settings.json
- ❌ любые настройки Claude Code на хосте вне контейнера
- ❌ дублировать одно поле в нескольких файлах

Хуки

Файл	Путь	Назначение
session-setup.sh	`.claude/hooks/session-setup.sh`	SessionStart — инжектирует CLAUDE.md в контекст при каждом старте/resume/compact

Зачем хук: CLAUDE.md (платформенные знания) имеет низший приоритет (Layer 5) и теряется после /compact. Хук восстанавливает его через additionalContext (Layer 3).

Инструкции для Claude (контекст и правила поведения)

Поведенческие инструкции, контекст и правила пишутся в CLAUDE.md-файлах — не в settings.json.

Файл	Область	Git	Для чего
`~/.claude/CLAUDE.md`	Глобальная	нет	Личные правила, стиль общения — для всех проектов
`.claude/CLAUDE.md` в проекте	Проектная	✅	Правила команды, контекст проекта
`.claude/CLAUDE.local.md` в проекте	Проектная	нет	Личные переопределения конкретного проекта

Загружаются все вместе: глобальный → проектный → локальный. Локальный перекрывает проектный.

Важно: CLAUDE.md в платформе — навигатор (куда идти), не правила. Правила поведения — только в default.md.

Навигатор платформы

Файл	Путь	Назначение
CLAUDE.md	`CLAUDE.md` (корень воркспейса)	Карта платформы: серверы, проекты, триггеры, хаки

Скрипты сессий

Файл	Путь	Назначение
session	`/usr/local/bin/session`	Запуск/выбор сессий. Обязателен `cd /opt/claude-workspace` перед `claude --resume`

Документация раздела

Документ	Путь	Назначение
История изменений	claude/CHANGES.md	Полный реестр всех правок с 2025 года
Аудит инструкции	claude/AUDIT.md	Что было потеряно при рефакторингах, что восстановить
Структура инструкции	claude/INSTRUCTIONS.md	Предлагаемая структура новой Default.md

Файловая система Claude Code на сервере

`/root/.claude/` — глобальные данные (вне git)

Папка / файл	Что хранит
`settings.json`	Глобальные настройки: `outputStyle`, `model`, `theme`, `env`, плагины
`settings.local.json`	Локальные переопределения глобальных настроек
`output-styles/`	Стили — не использовать: канонический источник `.claude/output-styles/` в git
`sessions/`	Активные сессии Claude Code
`projects/`	Транскрипты разговоров по проектам (190 MB)
`plugins/`	Установленные плагины (playwright, gitlab, context7, telegram)
`plans/`	Планы задач (`/plan`)
`tasks/`	Задачи (`/task`)
`todos/`	Списки todo
`file-history/`	История файлов для `/rewind` (22 MB)
`cache/`	Кэш MCP и прочее
`history.jsonl`	История команд оператора
`stats-cache.json`	Статистика использования
`session_resume_state.json`	Состояние для `--resume`

`/opt/claude-workspace/.claude/` — проектные данные (в git, кроме отмеченных)

Папка / файл	Git	Что хранит
`output-styles/default.md`	✅	Основная системная инструкция (протокол поведения)
`output-styles/SafeDialog.md`	✅	Резервная инструкция
`settings.json`	✅	Permissions, hooks — только это
`settings.local.json`	❌	Личные переопределения проекта
`hooks/`	✅	Хуки (SessionStart, PostToolUse и др.)
`commands/`	✅	Кастомные slash-команды
`scripts/`	✅	Вспомогательные скрипты
`sessions/`	❌	Логи сессий платформы
`stack/`	❌	Context stack (PUSH/POP незавершённых тем)
`worktrees/`	❌	Git worktrees для изолированных задач

Приоритеты слоёв (Layer Model)

Layer 1  Output Style (default.md) ← ПРАВИЛА ПОВЕДЕНИЯ (самый высокий)
Layer 2  Base Anthropic system prompt    ← отключён (keep-coding-instructions: false)
Layer 3  Hook additionalContext          ← CLAUDE.md (платформенные знания)
Layer 4  —
Layer 5  CLAUDE.md в проекте            ← дублирует Layer 3, низший приоритет