Skip to content

an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions

23.3 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
<!-- Google tag (gtag.js), Google Ads AW-18388216863. Loaded only when Do Not Track is
     off, so it follows the same rule as the PostHog block on this site. -->
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){ dataLayer.push(arguments); }
  if (navigator.doNotTrack !== '1') {
    var gtagScript = document.createElement('script');
    gtagScript.async = true;
    gtagScript.src = 'https://www.googletagmanager.com/gtag/js?id=AW-18388216863';
    document.head.appendChild(gtagScript);
    gtag('js', new Date());
    gtag('config', 'AW-18388216863');
  }
</script>

<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>What Are Claude Code Agents? And How to Use Many at Once — Munder Difflin Blog</title>
<meta name="description" content="Claude Code agents explained in plain English — what an agent actually is, how subagents differ, and the leap from one agent to a coordinated team." />
<link rel="canonical" href="https://munderdiffl.in/blog/what-are-claude-code-agents/" />

<link rel="icon" type="image/png" href="https://munderdiffl.in/logo.png" />
<link rel="apple-touch-icon" href="https://munderdiffl.in/logo.png" />
<meta name="theme-color" content="#F5F2E8" />

<!-- Open Graph -->
<meta property="og:site_name" content="Munder Difflin Blog" />
<meta property="og:type" content="article" />
<meta property="og:title" content="What Are Claude Code Agents? And How to Use Many at Once — Munder Difflin Blog" />
<meta property="og:description" content="Claude Code agents explained in plain English — what an agent actually is, how subagents differ, and the leap from one agent to a coordinated team." />
<meta property="og:url" content="https://munderdiffl.in/blog/what-are-claude-code-agents/" />
<meta property="og:image" content="https://munderdiffl.in/blog/assets/media/what-are-claude-code-agents/hero.png" />
<meta property="og:image:width" content="1600" />
<meta property="og:image:height" content="900" />
<meta property="og:image:alt" content="Illustration: What Are Claude Code Agents? And How to Use Many at Once" />
<meta property="og:locale" content="en_US" />
<meta property="article:published_time" content="2026-06-02T00:00:00.000Z" />
<meta property="article:author" content="Chaitanya Giri" />
<meta property="article:tag" content="Concepts" />
<meta property="article:tag" content="Multi-Agent" />
<meta property="article:tag" content="Claude Code" />
<meta property="article:tag" content="Getting Started" />


<!-- Twitter -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="What Are Claude Code Agents? And How to Use Many at Once — Munder Difflin Blog" />
<meta name="twitter:description" content="Claude Code agents explained in plain English — what an agent actually is, how subagents differ, and the leap from one agent to a coordinated team." />
<meta name="twitter:image" content="https://munderdiffl.in/blog/assets/media/what-are-claude-code-agents/hero.png" />
<meta name="twitter:image:alt" content="Illustration: What Are Claude Code Agents? And How to Use Many at Once" />

<link rel="alternate" type="application/atom+xml" title="Munder Difflin Blog" href="https://munderdiffl.in/blog/feed.xml" />
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,[email protected],500;9..144,600;9..144,700;9..144,900&amp;family=Source+Serif+4:opsz,[email protected],400;8..60,600;8..60,700&amp;family=Space+Grotesk:wght@500;600;700&amp;family=JetBrains+Mono:wght@400;600&amp;display=swap" rel="stylesheet" />
<link rel="stylesheet" href="/blog/assets/blog-press.css" />

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "What Are Claude Code Agents? And How to Use Many at Once",
  "description": "Claude Code agents explained in plain English — what an agent actually is, how subagents differ, and the leap from one agent to a coordinated team.",
  "image": ["https://munderdiffl.in/blog/assets/media/what-are-claude-code-agents/hero.png"],
  "datePublished": "2026-06-02T00:00:00.000Z",
  "dateModified": "2026-06-02T00:00:00.000Z",
  "author": { "@type": "Person", "name": "Chaitanya Giri" },
  "publisher": {
    "@type": "Organization",
    "name": "Munder Difflin",
    "logo": { "@type": "ImageObject", "url": "https://munderdiffl.in/logo.png" }
  },
  "mainEntityOfPage": { "@type": "WebPage", "@id": "https://munderdiffl.in/blog/what-are-claude-code-agents/" },
  "keywords": "claude code agents, claude code agents, claude code subagents, ai coding agents",
  "articleSection": "Concepts",
  "inLanguage": "en-US",
  "url": "https://munderdiffl.in/blog/what-are-claude-code-agents/"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://munderdiffl.in/" },
    { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://munderdiffl.in/blog/" },
    { "@type": "ListItem", "position": 3, "name": "What Are Claude Code Agents? And How to Use Many at Once", "item": "https://munderdiffl.in/blog/what-are-claude-code-agents/" }
  ]
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    { "@type": "Question", "name": "What are Claude Code agents?", "acceptedAnswer": { "@type": "Answer", "text": "A Claude Code agent is a running Claude session with a goal and a set of tools — it can read and edit files, run commands, and work toward a task in a loop. Each terminal you start a Claude session in is an agent." } },
    { "@type": "Question", "name": "What's the difference between an agent and a subagent in Claude Code?", "acceptedAnswer": { "@type": "Answer", "text": "An agent is a top-level session you drive. A subagent is a helper the main agent spawns inside its own run to fan out a piece of work — short-lived and scoped to that parent. Subagents are great for parallel sub-tasks but don't persist or share memory across your whole workflow." } },
    { "@type": "Question", "name": "How do I use multiple Claude Code agents at once?", "acceptedAnswer": { "@type": "Answer", "text": "Open several sessions, give each a clear role, and coordinate them — ideally with shared memory and messaging so they don't collide or forget. A multi-agent harness like Munder Difflin automates that coordination so the sessions act as one team." } }
    
  ]
}
</script>


<script>
  // Anonymous blog analytics (PostHog) — same posture as the main site and the
  // app's TELEMETRY.md: public write-only token ('' = inert), anonymous-only
  // (person_profiles 'never'), no autocapture/recording, DNT respected.
  (function () {
    var PH_KEY = 'phc_qJzsokwcbtTGHemnvywR3nSqivNNgMjHeNVEWkZNydFB';
    if (!PH_KEY || navigator.doNotTrack === '1') return;
    var s = document.createElement('script');
    s.async = true;
    s.src = 'https://us-assets.i.posthog.com/static/array.js';
    s.onload = function () {
      if (!window.posthog) return;
      window.posthog.init(PH_KEY, {
        api_host: 'https://us.i.posthog.com',
        person_profiles: 'never',
        autocapture: false,
        before_send: function (event) {
          // PostHog fills $ip from the connection unless the event carries one.
          // Null it here and disable the GeoIP lookup so no IP, city, postal
          // code or lat/long is ever derived or stored for this page view.
          if (event && event.properties) {
            event.properties.$ip = null;
            event.properties.$geoip_disable = true;
          }
          return event;
        },
        disable_session_recording: true,
        respect_dnt: true
      });
    };
    document.head.appendChild(s);
  })();
</script>
</head>
<body class="theme-press">
<a class="skip-link" href="#main">Skip to content</a>
<nav id="nav">
  <a class="brand" href="https://munderdiffl.in" aria-label="Munder Difflin home">
    <img class="brand-logo" src="https://munderdiffl.in/logo.png" width="1318" height="840" alt="Munder Difflin, Inc. — Multi-Agent Harness" />
  </a>
  <span class="spacer"></span>
  <div class="links">
    <a href="/blog/">Latest</a>
    <a href="/blog/topics/">Topics</a>
    <a href="/blog/about/">About</a>
    <a href="https://munderdiffl.in">↗ Product</a>
  </div>
  <div class="nav-actions">
    <a class="btn sm" href="https://munderdiffl.in/blog/feed.xml" aria-label="RSS feed">⤵ RSS</a>
    <a class="btn sm primary" href="https://munderdiffl.in/#install">⤓ Download</a>
  </div>
</nav>

<main id="main">

<article class="t-concepts">
  <header class="post-head wrap">
    <nav class="crumbs" aria-label="Breadcrumb">
      <a href="/blog/">Blog</a>
      <span>/</span>
      <a href="/blog/topics/concepts/">Concepts</a>
    </nav>
    <h1>What Are Claude Code Agents? And How to Use Many at Once</h1>
    <p class="dek">Claude Code agents explained in plain English — what an agent actually is, how subagents differ, and the leap from one agent to a coordinated team.</p>
    <div class="byline">
      <span class="av" aria-hidden="true">CG</span>
      <strong>Chaitanya Giri</strong>
      <span class="dot" aria-hidden="true">·</span>
      <time datetime="2026-06-02">Jun 2, 2026</time>
      <span class="dot" aria-hidden="true">·</span>
      <span>3 min read</span>
      <span class="tag kind">Concepts</span>
    </div>
  </header>

  <div class="hero-wrap wrap"><figure class="fig fig-hero"><img src="/blog/assets/media/what-are-claude-code-agents/hero.png" alt="Illustration: What Are Claude Code Agents? And How to Use Many at Once" loading="lazy" decoding="async" /></figure></div>

  <div class="post-wrap wrap">
    <div class="prose">
      <div class="callout tldr"><span class="ic">TL;DR</span><p>A <strong>Claude Code agent</strong> is a
running Claude session with a goal and tools — it reads files, edits code, and runs commands in a
loop. <strong>Subagents</strong> are short-lived helpers an agent spawns for fan-out. The real leap
isn't more agents; it's getting several to act as a <strong>coordinated team</strong> with roles,
shared memory, and messaging.</p></div>
<p>If you’re new to Claude Code, “agent” gets thrown around a lot. Here’s the plain-English version —
what an agent actually is, how subagents fit, and what changes when you run several at once.</p>
<h2 id="what-an-agent-actually-is" tabindex="-1">What an agent actually is <a class="anchor" href="#what-an-agent-actually-is" aria-hidden="true">#</a></h2>
<p>An agent is just a loop with a goal. A Claude Code agent is a running Claude session that can:</p>
<ul>
<li><strong>read</strong> your files and project context,</li>
<li><strong>act</strong> — edit code, run shell commands, call tools — toward a task, and</li>
<li><strong>repeat</strong>, observing the results and deciding the next step.</li>
</ul>
<p>That’s it. Every terminal where you start a <code>claude</code> session is an agent: one goal, one context
window, one loop. The magic isn’t the word “agent” — it’s that the loop can use tools and keep going
until the job’s done.</p>
<figure class="fig fig-inline"><img src="/blog/assets/media/what-are-claude-code-agents/note-1.png" alt="Hand-drawn sketch from “What Are Claude Code Agents? And How to Use Many at Once”" loading="lazy" decoding="async" /></figure>
<h2 id="agents-vs-subagents" tabindex="-1">Agents vs. subagents <a class="anchor" href="#agents-vs-subagents" aria-hidden="true">#</a></h2>
<p>These two get conflated constantly, so let’s separate them:</p>
<h3 id="agent" tabindex="-1">Agent <a class="anchor" href="#agent" aria-hidden="true">#</a></h3>
<p>A top-level session <em>you</em> drive. It owns a task from start to finish and you interact with it
directly.</p>
<h3 id="subagent" tabindex="-1">Subagent <a class="anchor" href="#subagent" aria-hidden="true">#</a></h3>
<p>A helper the main agent <strong>spawns inside its own run</strong> to fan out a chunk of work — “go research these
five files in parallel,” for example. Subagents are powerful for parallelism, but they’re
<strong>short-lived and scoped to that one parent</strong>: they don’t persist after the run, and they don’t share
memory across your whole workflow. For the deeper trade-offs, the difference between <a href="/#what">subagents and a
full harness</a> is worth understanding before you lean on either.</p>
<p>The short version: subagents help <em>one</em> agent do more at once; they don’t make <em>many</em> agents into a
team.</p>
<h2 id="from-one-agent-to-many" tabindex="-1">From one agent to many <a class="anchor" href="#from-one-agent-to-many" aria-hidden="true">#</a></h2>
<p>One agent handles most tasks fine. You start wanting <em>several</em> when work naturally splits — someone
writes tests while someone refactors while someone updates docs. The naive way is to open more
terminals, and that works… until it doesn’t:</p>
<ul>
<li>agents <strong>collide</strong> on the same files,</li>
<li>each session <strong>forgets</strong> what the others learned, and</li>
<li>you lose track of <strong>who’s doing what</strong> across a wall of tabs.</li>
</ul>
<p>That’s the wall every multi-agent setup hits. The fix isn’t more agents — it’s coordination. We wrote
the practical playbook in <a href="/blog/how-to-run-multiple-claude-code-agents/">how to run multiple Claude Code
agents</a>.</p>
<figure class="fig fig-inline"><img src="/blog/assets/media/what-are-claude-code-agents/note-2.png" alt="Hand-drawn sketch from “What Are Claude Code Agents? And How to Use Many at Once”" loading="lazy" decoding="async" /></figure>
<h2 id="what-turns-agents-into-a-team" tabindex="-1">What turns agents into a team <a class="anchor" href="#what-turns-agents-into-a-team" aria-hidden="true">#</a></h2>
<p>Three additions turn parallel sessions into something that behaves like a team:</p>
<ul>
<li><strong>Roles</strong> — each agent gets a job, so “who should do this?” is obvious.</li>
<li><strong>Shared memory</strong> — a durable, <a href="/blog/give-claude-code-long-term-memory/">long-term memory</a> every
agent reads, so knowledge compounds instead of resetting.</li>
<li><strong>Coordination</strong> — agents message each other and an orchestrator routes work, so you’re not the bus.</li>
</ul>
<p>When you wrap your agents in that layer, you’ve got a <a href="/blog/what-is-a-multi-agent-harness/">multi-agent harness</a>
— the concept that turns “five chat windows” into “one office.”</p>
<h2 id="where-to-go-next" tabindex="-1">Where to go next <a class="anchor" href="#where-to-go-next" aria-hidden="true">#</a></h2>
<ul>
<li>Ready to run several? Start with <a href="/blog/how-to-run-multiple-claude-code-agents/">how to run multiple Claude Code
agents</a>.</li>
<li>Want the field of tools? See <a href="/blog/best-claude-code-multi-agent-tools/">the best tools to run multiple Claude Code
agents</a>.</li>
<li>Curious about the concept? <a href="/blog/what-is-a-multi-agent-harness/">What is a multi-agent harness?</a></li>
</ul>
<hr>
<p>Munder Difflin is the team layer for the Claude Code agents you already run — roles, shared memory,
messaging, and an orchestrator, all local. <a href="/#install">Download Munder Difflin</a> to turn your agents
into an office; it’s free and open source.</p>


      
      <section class="faq" aria-label="Frequently asked questions">
        <h2 id="faq">FAQ</h2>
        
        <div class="qa">
          <p class="q">What are Claude Code agents?</p>
          <p class="a">A Claude Code agent is a running Claude session with a goal and a set of tools — it can read and edit files, run commands, and work toward a task in a loop. Each terminal you start a Claude session in is an agent.</p>
        </div>
        
        <div class="qa">
          <p class="q">What&#39;s the difference between an agent and a subagent in Claude Code?</p>
          <p class="a">An agent is a top-level session you drive. A subagent is a helper the main agent spawns inside its own run to fan out a piece of work — short-lived and scoped to that parent. Subagents are great for parallel sub-tasks but don&#39;t persist or share memory across your whole workflow.</p>
        </div>
        
        <div class="qa">
          <p class="q">How do I use multiple Claude Code agents at once?</p>
          <p class="a">Open several sessions, give each a clear role, and coordinate them — ideally with shared memory and messaging so they don&#39;t collide or forget. A multi-agent harness like Munder Difflin automates that coordination so the sessions act as one team.</p>
        </div>
        
      </section>
      

      
      <hr />
      <div class="share">
        <span class="lbl">Tags</span>
        <a class="tag" href="/blog/tags/concepts/">Concepts</a><a class="tag" href="/blog/tags/multi-agent/">Multi-Agent</a><a class="tag" href="/blog/tags/claude-code/">Claude Code</a><a class="tag" href="/blog/tags/getting-started/">Getting Started</a>
      </div>
      
    </div>

    
    <aside class="toc-rail" aria-label="Table of contents">
      <div class="tt">On this page</div>
      <ol>
        <li class="lvl-2"><a href="#what-an-agent-actually-is">What an agent actually is</a></li><li class="lvl-2"><a href="#agents-vs-subagents">Agents vs. subagents</a></li><li class="lvl-3"><a href="#agent">Agent</a></li><li class="lvl-3"><a href="#subagent">Subagent</a></li><li class="lvl-2"><a href="#from-one-agent-to-many">From one agent to many</a></li><li class="lvl-2"><a href="#what-turns-agents-into-a-team">What turns agents into a team</a></li><li class="lvl-2"><a href="#where-to-go-next">Where to go next</a></li>
      </ol>
    </aside>
    
  </div>

  <footer class="post-foot wrap"><div class="prevnext">
      <a class="pn prev" href="/blog/why-local-first-matters-for-ai-agents/"><span class="k">← Older</span><span class="t">Why Local-First Matters for Your AI Agents</span></a>
      <a class="pn next" href="/blog/visualizing-ai-agents-pixijs/"><span class="k">Newer →</span><span class="t">Visualizing AI Agents with Pixi.js: An Office You Can Watch</span></a>
    </div>
    <section class="related">
      <h2>Related in Concepts</h2>
      <div class="post-grid">
        <article class="card t-concepts">
  <a class="thumb t-concepts" href="/blog/gpt-6-1-terra/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/gpt-6-1-terra/hero.png" alt="" loading="lazy" decoding="async" /></a>
  <div class="body">
    <div class="meta">
      <time datetime="2026-10-27">Oct 27, 2026</time>
      <span class="dot" aria-hidden="true"></span>
      <span>4 min</span>
    </div>
    <h3><a href="/blog/gpt-6-1-terra/">GPT-6.1 Terra: Price, Specs and How to Use It in Codex (Oct 2026)</a></h3>
    <p class="dek">GPT-6.1 Terra is OpenAI&#39;s fast new model for images, computer use and writing: price, specs and how to pick it in Codex, checked 27 Oct 2026.</p>
    <div class="foot">
      <span class="tag kind">Concepts</span>
      <a class="more" href="/blog/gpt-6-1-terra/" aria-label="Read: GPT-6.1 Terra: Price, Specs and How to Use It in Codex (Oct 2026)">Read →</a>
    </div>
  </div>
</article>
<article class="card t-concepts">
  <a class="thumb t-concepts" href="/blog/what-is-claude-duet/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/what-is-claude-duet/hero.png" alt="" loading="lazy" decoding="async" /></a>
  <div class="body">
    <div class="meta">
      <time datetime="2026-10-22">Oct 22, 2026</time>
      <span class="dot" aria-hidden="true"></span>
      <span>5 min</span>
    </div>
    <h3><a href="/blog/what-is-claude-duet/">What Is Claude Duet? Anthropic&#39;s Proactive Agent App, Explained</a></h3>
    <p class="dek">Claude Duet is Anthropic&#39;s proactive agent app, in research preview since 21 Oct 2026: who can join, how it works, what it asks first and its limits.</p>
    <div class="foot">
      <span class="tag kind">Concepts</span>
      <a class="more" href="/blog/what-is-claude-duet/" aria-label="Read: What Is Claude Duet? Anthropic&#39;s Proactive Agent App, Explained">Read →</a>
    </div>
  </div>
</article>
<article class="card t-concepts">
  <a class="thumb t-concepts" href="/blog/deepseek-v4-1-flash-1017/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/deepseek-v4-1-flash-1017/hero.png" alt="" loading="lazy" decoding="async" /></a>
  <div class="body">
    <div class="meta">
      <time datetime="2026-10-17">Oct 17, 2026</time>
      <span class="dot" aria-hidden="true"></span>
      <span>4 min</span>
    </div>
    <h3><a href="/blog/deepseek-v4-1-flash-1017/">DeepSeek V4.1 Flash 1017: What Changed, the Price and Claude Code Setup</a></h3>
    <p class="dek">DeepSeek V4.1 Flash 1017, released 17 Oct 2026 under MIT: what changed, DeepSeek&#39;s benchmarks, the API price and Claude Code setup.</p>
    <div class="foot">
      <span class="tag kind">Concepts</span>
      <a class="more" href="/blog/deepseek-v4-1-flash-1017/" aria-label="Read: DeepSeek V4.1 Flash 1017: What Changed, the Price and Claude Code Setup">Read →</a>
    </div>
  </div>
</article>

      </div>
    </section>
    
  </footer>
</article>

</main>
<footer class="site-foot">
  <div class="wrap">
    <div class="foot-top">
      <a class="foot-brand brand" href="https://munderdiffl.in" aria-label="Munder Difflin home">
        <img class="brand-logo" src="https://munderdiffl.in/logo.png" width="1318" height="840" alt="Munder Difflin, Inc. — Multi-Agent Harness" />
      </a>
      <div class="foot-links">
        <a href="/blog/">Latest</a>
        <a href="/blog/topics/">Topics</a>
        <a href="/blog/about/">About</a>
        <a href="https://munderdiffl.in/blog/feed.xml">RSS</a>
        <a href="https://github.com/chaitanyagiri/munder-difflin">GitHub</a>
        <a href="https://munderdiffl.in">munderdiffl.in ↗</a>
      </div>
    </div>
    <div class="foot-meta">
      © 2026 Munder Difflin · Local-first · MIT-licensed ·
      Built on <a href="https://munderdiffl.in">Electron, React, Pixi.js, xterm.js &amp; node-pty</a>.
      Run an office of agents while you sleep.
    </div>
  </div>
</footer>

<script>
  // sticky-nav border on scroll
  (function () {
    var nav = document.getElementById('nav');
    if (!nav) return;
    var onScroll = function () { nav.classList.toggle('scrolled', window.scrollY > 8); };
    onScroll(); window.addEventListener('scroll', onScroll, { passive: true });
  })();
  // YouTube click-to-load: thumbnail button → youtube-nocookie iframe
  (function () {
    document.addEventListener('click', function (e) {
      var btn = e.target.closest('.yt-load');
      if (!btn) return;
      var box = btn.closest('.yt');
      var id = box && box.getAttribute('data-yt');
      // Only an 11 character YouTube video id may reach the iframe URL.
      if (!id || !/^[A-Za-z0-9_-]{11}$/.test(id)) return;
      var frame = document.createElement('iframe');
      frame.src = 'https://www.youtube-nocookie.com/embed/' + encodeURIComponent(id) + '?autoplay=1';
      frame.title = box.getAttribute('data-title') || 'YouTube video';
      frame.allow = 'accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share';
      frame.setAttribute('allowfullscreen', '');
      box.replaceChildren(frame);
    });
  })();
</script>

</body>
</html>