{
  "schema_version": "1.0",
  "publisher": "AI Release",
  "article": {
    "title": "Как запустить несколько агентов Claude Code одновременно в одном проекте: git worktree и изолированные workspace",
    "canonical_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
    "language": "ru",
    "article_type": "руководство",
    "published_at": null,
    "updated_at": "2026-11-21T00:00:00+00:00"
  },
  "summary": "Пошаговая инструкция по параллельному запуску нескольких агентов Claude Code в одном репозитории с изоляцией через git worktree, общими настройками и без конфликтов в файлах. Время выполнения: 25–30 минут Уровень сложности: Intermediate",
  "topics": [
    "Claude Code несколько агентов",
    "git worktree Claude Code",
    "изолированные workspace"
  ],
  "entities": [
    {
      "id": "E1",
      "name": "Claude Code несколько агентов",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E2",
      "name": "git worktree Claude Code",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E3",
      "name": "изолированные workspace",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E4",
      "name": "Windows",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E5",
      "name": "Linux",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E6",
      "name": "macOS",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E7",
      "name": "Node.js",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E8",
      "name": "npm",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E9",
      "name": "Git",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E10",
      "name": "Claude",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    }
  ],
  "claims": [
    {
      "id": "AR-GUIDE-KAKZAPUSTI-001",
      "statement": "Время выполнения: 25–30 минут",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Время выполнения: 25–30 минут"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-002",
      "statement": "Уровень сложности: Intermediate",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Уровень сложности: Intermediate"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-003",
      "statement": "Понадобится: Git с поддержкой git worktree (проверяется командой git worktree --help; если выдаёт git: 'worktree' is not a git command — обновите Git до версии из документации вашего дистрибутива), Claude Code CLI (claude --version), терминал, tmux или несколько окон терминала, Node.js/npm — если проект на JavaScript",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Понадобится: Git с поддержкой git worktree (проверяется командой git worktree --help; если выдаёт git: 'worktree' is not a git command — обновите Git до версии из документации вашего дистрибутива), Claude Code CLI (claude --version), терминал, tmux или несколько окон терминала, Node.js/npm — если проект на JavaScript"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-004",
      "statement": "Результат: N независимых рабочих каталогов на одну историю Git, в каждом — свой агент, своя ветка и свой порт дев-сервера",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Результат: N независимых рабочих каталогов на одну историю Git, в каждом — свой агент, своя ветка и свой порт дев-сервера"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-005",
      "statement": "ОС: Linux, macOS или Windows (в Windows все команды ниже выполняются в PowerShell, кроме sed — для него дан отдельный вариант)",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "ОС: Linux, macOS или Windows (в Windows все команды ниже выполняются в PowerShell, кроме sed — для него дан отдельный вариант)"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-006",
      "statement": "Git — проверьте git worktree --help; команда должна вывести справку, а не ошибку",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Git — проверьте git worktree --help; команда должна вывести справку, а не ошибку"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-007",
      "statement": "Claude Code CLI — проверьте claude --version",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Claude Code CLI — проверьте claude --version"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-008",
      "statement": "Ошибка: fatal: 'agent/1-auth' is already checked out at '/home/user/projects/myapp-agent-1'",
      "claim_type": "guide_fact",
      "confidence": "editorial_assessment",
      "source_type": "анализ AI Release",
      "verification_status": "editorial_analysis",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#problems",
      "evidence_excerpt": "Ошибка: fatal: 'agent/1-auth' is already checked out at '/home/user/projects/myapp-agent-1'"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-009",
      "statement": "Причина: Git запрещает держать одну ветку в двух worktree одновременно — иначе два индекса писали бы в одну ссылку refs/heads/....",
      "claim_type": "guide_fact",
      "confidence": "editorial_assessment",
      "source_type": "анализ AI Release",
      "verification_status": "editorial_analysis",
      "source_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
      "article_anchor": "#problems",
      "evidence_excerpt": "Причина: Git запрещает держать одну ветку в двух worktree одновременно — иначе два индекса писали бы в одну ссылку refs/heads/...."
    }
  ],
  "relationships": [
    {
      "subject": "Гайд",
      "predicate": "описывает",
      "object": "Как запустить несколько агентов Claude Code одновременно в одном проекте: git worktree и изолированные workspace",
      "claim_id": "AR-GUIDE-KAKZAPUSTI-001"
    },
    {
      "subject": "Гайд",
      "predicate": "содержит шаг",
      "object": "Шаг 1. Создайте worktree под каждого агента",
      "claim_id": "AR-GUIDE-KAKZAPUSTI-001"
    }
  ],
  "questions_and_answers": [
    {
      "question": "Что это за материал?",
      "answer": "Пошаговая инструкция по параллельному запуску нескольких агентов Claude Code в одном репозитории с изоляцией через git worktree, общими настройками и без конфликтов в файлах.",
      "claim_ids": [
        "AR-GUIDE-KAKZAPUSTI-001"
      ],
      "article_anchor": "#suschnost"
    },
    {
      "question": "Что понадобится?",
      "answer": "ОС: Linux, macOS или Windows (в Windows все команды ниже выполняются в PowerShell, кроме sed — для него дан отдельный вариант); Git — проверьте git worktree --help; команда должна вывести справку, а не ошибку; Claude Code CLI — проверьте claude --version; tmux (Linux/macOS) для параллельных сессий: tmux -V; на Windows…",
      "claim_ids": [
        "AR-GUIDE-KAKZAPUSTI-003"
      ],
      "article_anchor": "#requirements"
    },
    {
      "question": "Как это сделать?",
      "answer": "Шаг 1. Создайте worktree под каждого агента → Шаг 2. Запустите агентов параллельно → Шаг 3. Проверьте изоляцию и сведите результат",
      "claim_ids": [
        "AR-GUIDE-KAKZAPUSTI-004"
      ],
      "article_anchor": "#step-1"
    },
    {
      "question": "Что может пойти не так?",
      "answer": "Ошибка: fatal: 'agent/1-auth' is already checked out at '/home/user/projects/myapp-agent-1'",
      "claim_ids": [
        "AR-GUIDE-KAKZAPUSTI-006"
      ],
      "article_anchor": "#problems"
    }
  ],
  "limitations": [
    "Ошибка: fatal: 'agent/1-auth' is already checked out at '/home/user/projects/myapp-agent-1'",
    "Причина: Git запрещает держать одну ветку в двух worktree одновременно — иначе два индекса писали бы в одну ссылку refs/heads/....",
    "Решение: дайте агенту собственную ветку или detached-каталог для чтения:",
    "Ошибка: Error: listen EADDRINUSE: address already in use :::3000"
  ],
  "citation": {
    "preferred_citation": "AI Release. Как запустить несколько агентов Claude Code одновременно в одном проекте: git worktree и изолированные workspace. https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
    "canonical_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno.html",
    "publisher": "AI Release"
  }
}