{
  "schema_version": "1.0",
  "publisher": "AI Release",
  "article": {
    "title": "How to Run Multiple Claude Code Agents in One Project with Git Worktree and Isolated Workspaces",
    "canonical_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno_en.html",
    "language": "en",
    "article_type": "guide",
    "published_at": null,
    "updated_at": "2026-11-21T00:00:00+00:00"
  },
  "summary": "Time to complete: 25 minutes Difficulty: 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": "Time to complete: 25 minutes",
      "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_en.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Time to complete: 25 minutes"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-002",
      "statement": "Difficulty: 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_en.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Difficulty: Intermediate"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-003",
      "statement": "You will need: Git with worktree support (git worktree shipped in Git 2.5 — confirm with git --version), a repository with at least one commit and a clean working tree, the Claude Code CLI installed and authenticated (claude --version to confirm; installation steps — check the documentation for your OS), Node.js only if your project is JavaScript/TypeScript.",
      "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_en.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "You will need: Git with worktree support (git worktree shipped in Git 2.5 — confirm with git --version), a repository with at least one commit and a clean working tree, the Claude Code CLI installed and authenticated (claude --version to confirm; installation steps — check the documentation for your OS), Node.js only if your project is JavaScript/TypeScript."
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-004",
      "statement": "What most guides leave out: git worktree add is the easy part. Parallel agents actually break on two things — ignored files (.env, node_modules, local SQLite files) are not copied into a new worktree, and every copy tries to bind the same port. Step 2 fixes both before you start a second agent.",
      "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_en.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "What most guides leave out: git worktree add is the easy part. Parallel agents actually break on two things — ignored files (.env, node_modules, local SQLite files) are not copied into a new worktree, and every copy tries to bind the same port. Step 2 fixes both before you start a second agent."
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-005",
      "statement": "Hard limit you cannot negotiate: Git refuses to check out the same branch in two worktrees. One branch = one agent. This is a feature: it is what stops two agents from writing to the same files.",
      "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_en.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Hard limit you cannot negotiate: Git refuses to check out the same branch in two worktrees. One branch = one agent. This is a feature: it is what stops two agents from writing to the same files."
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-006",
      "statement": "OS: Linux, macOS, or Windows with WSL2. Native Windows Git works, but path handling in scripts is simpler under WSL.",
      "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_en.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "OS: Linux, macOS, or Windows with WSL2. Native Windows Git works, but path handling in scripts is simpler under WSL."
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-007",
      "statement": "Git: 2.5 or newer. Check:",
      "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_en.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Git: 2.5 or newer. Check:"
    },
    {
      "id": "AR-GUIDE-KAKZAPUSTI-008",
      "statement": "A clean repo. Uncommitted changes stay in the main worktree and are invisible to the new one, so commit or stash first:",
      "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_en.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "A clean repo. Uncommitted changes stay in the main worktree and are invisible to the new one, so commit or stash first:"
    }
  ],
  "relationships": [
    {
      "subject": "Guide",
      "predicate": "describes",
      "object": "How to Run Multiple Claude Code Agents in One Project with Git Worktree and Isolated Workspaces",
      "claim_id": "AR-GUIDE-KAKZAPUSTI-001"
    },
    {
      "subject": "Guide",
      "predicate": "includes step",
      "object": "Step 1. Create one worktree and one branch per agent task",
      "claim_id": "AR-GUIDE-KAKZAPUSTI-001"
    }
  ],
  "questions_and_answers": [
    {
      "question": "What is required?",
      "answer": "OS: Linux, macOS, or Windows with WSL2. Native Windows Git works, but path handling in scripts is simpler under WSL.; Git: 2.5 or newer. Check:; A clean repo. Uncommitted changes stay in the main worktree and are invisible to the new one, so commit or stash first:; Claude Code CLI: installed and logged in. Run claude…",
      "claim_ids": [
        "AR-GUIDE-KAKZAPUSTI-003"
      ],
      "article_anchor": "#requirements"
    },
    {
      "question": "How to do it?",
      "answer": "Step 1. Create one worktree and one branch per agent task → Step 2. Make each worktree runnable, then start Claude Code inside it → Step 3. Prove the isolation, then merge and clean up",
      "claim_ids": [
        "AR-GUIDE-KAKZAPUSTI-004"
      ],
      "article_anchor": "#step-1"
    },
    {
      "question": "Which topics does it cover?",
      "answer": "Claude Code несколько агентов, git worktree Claude Code, изолированные workspace",
      "claim_ids": [
        "AR-GUIDE-KAKZAPUSTI-002"
      ],
      "article_anchor": "#entities"
    },
    {
      "question": "What are the key points?",
      "answer": "Time to complete: 25 minutes Difficulty: Intermediate",
      "claim_ids": [
        "AR-GUIDE-KAKZAPUSTI-007"
      ],
      "article_anchor": "#tldr"
    }
  ],
  "limitations": [
    "Current versions, prices and limits.",
    "Independent benchmarks and quality checks.",
    "Terms of use and data policy."
  ],
  "citation": {
    "preferred_citation": "AI Release. Как запустить несколько агентов Claude Code одновременно в одном проекте: git worktree и изолированные workspace. https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno_en.html",
    "canonical_url": "https://ai-release.org/guides/kak-zapustit-neskolko-agentov-claude-code-odnovremenno_en.html",
    "publisher": "AI Release"
  }
}