Claude Code: глубокий разбор ядра архитектуры топового AI-инструмента для кода

Большинство статей про Claude Code заканчиваются на «поставил CLI, показал diff». В реальной команде быстро видно: ядро архитектуры топового AI-инструмента для кода — это не один процесс Agent в терминале, а то, как в Cloud Mac AI Stack распределены Diff, Fact, Context и Workflow и как они замыкают цикл.

Это опорная карта L6-Q02 (L6-Q02): через Claude Code как вход рисуем полную архитектуру Stack, порядок подключения пяти модулей и замкнутый цикл системы. Операционное руководство — полное руководство L6-Q01; пороги по правам — вводная L3 — здесь только карта.

Сам Claude Code: разбор 10% (остальные 90% — Stack)

Архитектура · ядро Claude Code

Сначала определим Claude Code сам по себе, потом — на каком слое он сидит. Это терминальный coding Agent, не плагин IDE:

Один цикл Agent (может повторяться)

  Читает CLAUDE.md + контекст репозитория
           │
           ▼
  План (какие файлы, какие команды)
           │
           ▼
  Выполнение (Write / Edit / Bash / опционально MCP Tool)
           │
           ▼
  Проверка (ваш test / lint)
           │
           └──► На выходе Diff (изменения, аудируемые через git)

• Границы — CLAUDE.md и политика прав задают, что можно трогать; см. руководство · границы проекта
• Расширенные «чувства» — MCP подключает GitHub Issue, CodeGraph, API в Context; см. хаб MCP Triple Connect
• Разделение с Cursor — дополнение в редакторе vs Agent по нескольким файлам + shell; см. vs Cursor

Это только L3. «Ядро архитектуры», которому доверяет организация, — карта Stack ниже.

Полная карта Cloud Mac AI Stack (уровни ответственности)

Архитектура · общая карта сайта

Единая модель сайта L0–L5 — к ней можно возвращаться при чтении любой тематической статьи. Важно: это уровни ответственности, а не порядок вызовов в рантайме.

Артефакты: Inference · Diff · Fact · Context · Workflow

                 ┌──────────────┐
                 │  OpenHands   │  L5 · Workflow (вся задача завершена?)
                 └──────┬───────┘
                        │
                 ┌──────▼───────┐
                 │     MCP      │  L4 · Context (что видит Agent?)
                 └──────┬───────┘
                        │
                 ┌──────▼───────┐
                 │ Claude Code  │  L3 · Diff (что изменилось в этом раунде?) ← вход
                 └──────┬───────┘
                        │
                 ┌──────▼───────┐
                 │    Ollama    │  L2 · Inference (опционально · локальная приватная мощность)
                 └──────┬───────┘
                        │
                 ┌──────▼───────┐
                 │ GitHub Runner│  L1 · Fact (можно ли этому доверять?)
                 └──────┬───────┘
                        │
                 ┌──────▼───────┐
                 │  Cloud Mac   │  L0 · инфраструктура (macOS-узел 24/7)
                 └──────────────┘

L0 держит вычисления, L1 держит Fact — и только потом Diff, Context и Workflow. Каким бы сильным ни был Claude Code, без L1 Diff остаётся локальным экспериментом.

Пять модулей (+ база): роли и артефакты

Архитектура · справочник модулей

Связь Workflow (L5) и Fact (L1): OpenHands в ходе задачи многократно потребляет Context, производит Diff и проверяется через Fact — не «CI только после завершения Workflow». См. OpenHands · связь артефактов.

Рекомендуемый порядок подключения: сначала Fact, потом Diff

Архитектура · путь внедрения

«Модный» порядок обычно такой: сначала Claude Code → потом MCP → CI вспоминают в конце. Мы рекомендуем эту последовательность развёртывания (она отличается от порядка слоёв на схеме):

 ① Cloud Mac (база L0)
      │  Постоянный macOS · SSH · исходящий IP
      ▼
 ② GitHub Runner (L1 · Fact)
      │  push → повторяемый зелёный/красный · изоляция workspace
      ▼
 ③ Ollama (L2 · Inference, опционально)
      │  локальные embedding / малые модели · учитывать RAM L1/L3
      ▼
 ④ Claude Code (L3 · Diff)
      │  CLAUDE.md · права · пробный прогон в первый день
      ▼
 ⑤ MCP (L4 · Context)
      │  GitHub / CodeGraph / Fetch · минимальные права
      ▼
 ⑥ OpenHands (L5 · Workflow)
      │  многошаговые issue · agent loop · наслаивается на L3
      ▼
 ⑦ Замкнутый цикл системы
      делегация → Diff → PR → Runner Fact → review → merge

1. ① L0 — без macOS-узла 24/7 Runner и Agent делят RAM ноутбука; см. купить или арендовать
2. ② L1 — сначала дать организации надёжный Fact; изоляция: один job — один workspace
3. ③ L2 — опционально; на одном хосте с Claude Code и Runner см. параллельное планирование
4. ④–⑥ — AI-слои после стабилизации Fact; руководство: L6-Q01
5. ⑦ Замкнутый цикл — следующий раздел

Замкнутый цикл системы: от делегации Claude Code до зелёного PR

Архитектура · замкнутый цикл

Последний кусок «ядра архитектуры» — как данные возвращаются обратно. Agent не может жить в изолированном терминале:

Человек в контуре · L3
  Разработчик ──делегирует──► Claude Code (+ MCP Context)
                        │
                        │  Diff (commit)
                        ▼
                   feature-ветка / PR
                        │
Машинная приёмка · L1        ▼
              GitHub Runner (Fact)
                   xcodebuild / test / lint
                        │
                        ├── красный ──► обратная связь Agent (Diff ↔ Fact)
                        │
                        └── зелёный ──► человеческий review ──► merge

Опционально · L5
  OpenHands ночью разбирает очередь issue ──► тот же цикл PR + Runner

Три жёстких условия рабочего цикла: изоляция среды Runner и Agent, PR обязан пройти CI, продакшен-секреты не в shell Agent. Продакшен-чеклист: L6-Q01 · продакшен.

Хаб внутренних ссылок: переход по слоям

Эта статья — карта серии Stack. Выберите вход по текущей проблеме:

FAQ

Какова ядро архитектуры Claude Code? Цикл терминального Agent на выходе даёт Diff; в продакшене нужны ещё CLAUDE.md, MCP Context и независимый Runner Fact.

Нужно ли ставить Ollama до Claude Code? Нет. L2 опционален; схема показывает уровни ответственности, а не порядок вызовов.

Чем это отличается от руководства L6-Q01? Q01 — операционная главная линия (установка→CI); Q02 — полная карта Stack (эта статья).

Может ли OpenHands заменить Claude Code? Нет. L5 оркестрирует Workflow, L3 в паре производит Diff — используйте наслоением.

• L6-Q01 · полное руководство Claude Code
• L1 · GitHub Runner Execution Engine
• L4 · хаб MCP Triple Connect