Sådan opretter og bruger du underagenter i Claude Code – en praktisk guide - CometAPI

Underagenter er en af de mest nyttige tilføjelser til Claude Code / Claude Agent-økosystemet: de giver dig mulighed for at opdele komplekse arbejdsgange i mindre, specialiserede AI-"holdkammerater", bevare hovedtrådskontekst og begrænse værktøjsadgang sikkert. Denne artikel forklarer... hvad er underagenter, hvordan man opretter og aktiverer dem (CLI, filsystem og SDK), den design principper du bør følge, når du bygger dem, og beton eksempelkode du kan kopiere og tilpasse.

Hvad er underagenter?

A underagent er en prækonfigureret, snævert afgrænset AI-assistent, som Claude Code (eller Claude Agent SDK) kan delegere arbejde til. Hver underagent:

Har et unikt navn og en klar beskrivelse af formålet.
Kører i sin eget kontekstvindue adskilt fra hovedsamtalen (så lange detaljekæder ikke forurener orkestratorens kontekst).
Kan konfigureres med et begrænset sæt af værktøjer (fillæsning/skrivning, bash, grep, MCP-værktøjer osv.) og med et specifikt modelvalg.
Indeholder en systemprompt (underagentens personlighed og instruktioner), der styrer adfærd og begrænsninger.

Disse egenskaber gør underagenter ideelle til opgaver, der er token-tunge (research, søgning i store logfiler), sikkerhedsfølsomme (scanning eller potentielt destruktive værktøjer) eller repetitive og velspecificerede (stilkontrol, testkørsel).

Anthropic har itereret hurtigt: Claude Code CLI og Agent SDK er blevet refaktoreret og udvidet til Claude Agent SDK, plugin-understøttelse er blevet introduceret til bundling agents og relaterede tilpasninger (slash-kommandoer, MCP-servere, hooks), og Skills give en måde at pakke domænearbejdsgange til genbrug på tværs af Claude.ai, Claude Code og Agent SDK. Disse opdateringer gør det nemmere at del, installer og versionsregistrer underagenter på tværs af teams og projekter. Hvis du planlægger at bygge produktionsworkflows, bør du evaluere plugin-/færdighedspakker og SDK-baserede implementeringsmønstre.

Hvorfor underagenter er vigtige

Tre grunde til, at de er øjeblikkeligt nyttige:

Kontekstbevarelse — lange eller støjende søgninger, testkørsler eller scanninger foregår i en underagent i stedet for at overvælde den primære kontekst. Det reducerer spild af tokens og gør det lettere at ræsonnere over resultaterne.
Specialiseret ekspertise — du kan indkode domæneviden og -adfærd i en systemprompt, der er skræddersyet til opgaven (f.eks. en security-auditor der fokuserer på hemmeligheder, afhængighedsproblemer og usikker shell-brug).
Sikrere tilladelser — begrænsning af værktøjer pr. subagent reducerer eksplosionsradius (en dokumentanmelder har muligvis skrivebeskyttede værktøjer; en testkører har Bash men nej Edit).
Parallelisering: Du kan oprette flere underagenter til at køre samtidigt (for eksempel: style-checker, security-scanner, test-runner) og derefter indsamle deres korte resultater – en kæmpe gevinst for dyre, uafhængige kontroller.

Forudsætninger for brug af underagenter i Claude Code

Før du begynder at opbygge underagenter, skal du sørge for at have følgende på plads:

1) Claude Code installeret og godkendt

Installer Claude Code CLI eller brug web/IDE-integrationerne. CometAPI's hurtigstart- og opsætningsdokumentation liste understøttede installationsmetoder (npm global pakke eller native installationsprogrammer) og vis, hvordan du verificerer din installation med claude --version / claude doctorDu skal også bruge en CometAPI konto (Det er billigere og mere bekvemt at bruge CometAPI's nøgle til at få adgang til Claude-kode end den officielle model.) som nævnt i Quickstart.

2) Node/miljø (for nogle installationsstier) og grundlæggende shell-værktøjer

Hvis du installerer via npm-pakken, skal du have Node.js (Node 18+ er almindelig i eksempler). Hvis du har til hensigt at bruge Agent SDK (JavaScript/TypeScript eller Python), skal du bruge et projekt med SDK-afhængigheden installeret. Mange tutorials forudsætter standardudviklerværktøjer (git, bash, valgfrit gh CLI til GitHub-arbejdsgange).

3) Projektlayout & CLAUDE.md

Bedste praksis er at gemme hjælpedokumenter på repo-niveau (CLAUDE.md) og at indsætte projektomfattede agenter .claude/agents/ så holdkammerater arver dem. CLAUDE.md-filer trækkes automatisk ind i Claudes kontekst og hjælper med at styre adfærden ensartet på tværs af sessioner. Hver underagent er en Markdown-fil med YAML-frontmatter. Minimalt eksempel:

---
name: code-reviewer
description: Expert code review specialist. Use PROACTIVELY after code changes to check security, style, and maintainability.
tools: Read, Grep, Glob, Bash
model: inherit
---
You are a senior code reviewer. When invoked:
1. Run `git diff` to identify modified files.
2. Focus review on changed code paths.
3. List security issues, probable false positives, and suggested fixes.
4. Provide a short, prioritized action list.

Return results in JSON with fields: summary, issues.

name er en identifikator med små bogstaver.
description styrer automatisk kald og matchning.
tools begrænser værktøjsadgang (udelader at arve alt).
model kan være sonnet, opus, haiku eller inherit.

4) Tilladelser og MCP-servere (valgfrit, men almindeligt)

Hvis dine arbejdsgange bruger Model Context Protocol (MCP)-servere eller eksterne værktøjer (Puppeteer, Sentry, brugerdefinerede REST-værktøjer), skal du sørge for, at dine MCP-servere er konfigureret og tilgængelige. For følsomme operationer (write, bash, git commit) skal du være opmærksom på tilladelseslisten og per-agent. tools omfang.

Sådan opretter du underagenter i Claude Code

Du kan oprette underagenter på tre hovedmåder: via den interaktive CLI (/agents), som filsystem-markdown-filer eller programmatisk via Agent SDK. Nedenfor er de trinvise muligheder:

Claude Code understøtter tre praktiske måder at oprette underagenter på:

Interaktiv CLI /agents UI — hurtigst til iterativ oprettelse i en session.
Filsystembaseret — opret Markdown-filer med YAML frontmatter i .claude/agents/ (projektniveau) eller ~/.claude/agents/ (brugerniveau). Projektagenter har højere prioritet.
Programmatisk (Agent SDK) — definere underagenter i kode via agents parameter når du kalder query(); anbefales til SDK-drevne apps. Denne tilgang er ideel, når underagenter skal oprettes dynamisk eller integreres i en applikation.

Hurtigt interaktivt flow (anbefalet første trin)

Start Claude Code i din terminal, eller åbn kommandopaletten i VS Code.
Kør subagents-grænsefladen med slash-kommandoen:

/agents

Vælg Opret ny agent, vælg omfang på projektniveau eller brugerniveau, udfyld navn/beskrivelse/værktøjer/systemprompt, og gem. Du kan generere et udkast med Claude og derefter forfine det. Når agenten er gemt, er den tilgængelig i /agents og kan påkaldes eksplicit eller automatisk.

Filsystembaserede underagenter (Markdown + YAML frontmatter)

Subagenter gemmes som Markdown-filer med YAML-frontmatter. Placer dem i:

Projektets omfang: .claude/agents/*.md (højeste prioritet)
Brugeromfang: ~/.claude/agents/*.md

Grundlæggende filstruktur:

---
name: code-reviewer
description: "Review recent code changes for security and style."
tools: Read, Grep, Glob, Bash  # optional; omit to inherit

model: sonnet  # optional; or 'inherit'

---
You are a senior code reviewer with expertise in security, performance, and best practices.
When reviewing:
- Identify security vulnerabilities
- Prioritize clarity and maintainability
- Always provide concise examples and suggested fixes
- If unsure, ask for the minimal reproducible snippet

Et par implementeringsnoter:

name skal være små bogstaver med bindestreger.
Udeladelse tools vil lade underagenten arve alle hovedtrådens værktøjer; eksplicit angivelse af værktøjer håndhæver en model med mindste rettigheder.
Brug model: 'inherit' for konsistent adfærd med hovedtråden, eller angiv et modelalias (f.eks. sonnet, opus, haiku).

CLI JSON-definition (ad hoc/sessionsbrug)

Du kan definere midlertidige underagenter inline, når du starter en session:

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer.",
    "prompt": "You are a senior code reviewer. Focus on security and best practices.",
    "tools": ,
    "model": "sonnet"
  }
}'

CLI-definerede agenter er nyttige til scriptede kørsel eller eksperimenter; de har lavere prioritet end projektagenter, men højere end brugeragenter.

Programmatisk definition (Agent SDK — anbefalet til apps)

Hvis du bygger en applikation eller automatisering, skal du definere underagenter programmatisk via Agent SDK'erne. agents parameter (dette er den mest integrerede mulighed). Eksempel (TypeScript):

import { query } from '@anthropic-ai/claude-agent-sdk';

async function runReview() {
  const result = await query({
    prompt: "Assess the authentication module for security issues",
    options: {
      agents: {
        "code-reviewer": {
          description: "Expert code review specialist",
          prompt: `You are a code review specialist...`,
          tools: ,
          model: "sonnet"
        },
        "test-runner": {
          description: "Runs the test suite and analyzes failures",
          prompt: `You run tests and summarize failures...`,
          tools: ,
          model: "sonnet"
        }
      }
    }
  });

  console.log(result);
}

SDK'et accepterer også filsystembaserede agenter (det vil indlæse .claude/agents/ filer) hvis du foretrækker det mønster. Programmatiske agenter er effektive til dynamiske arbejdsgange og CI-integration.

For Python, den claude-agent-sdk Pakken understøtter lignende mønstre: du kan bruge query() or ClaudeSDKClient og konfigurer indstillinger, værktøjer og MCP-servere programmatisk. Se Python SDK-repoet for eksempler på hurtigstart.

Sådan aktiverer du underagenter

Automatisk delegering

Claude Code kan automatisk Vælg en underagent, når en brugerprompt matcher en underagents formål. Dette er nyttigt til baggrundsorkestrering, hvor hovedagenten automatisk sender opgaver til den rette specialist. Stol på klare beskrivelser af underagenter og fokuserede systemprompter for at forbedre nøjagtigheden af automatisk valg.

Eksplicit påkaldelse (anbefales af hensyn til klarheden)

Du kan eksplicit kalde en agent i en samtale:

> Use the code-reviewer subagent to check my recent changes

Eksplicit kald er deterministisk og anbefales til produktionsflows, hvor du vil undgå uventet delegering.

SDK-orkestratormønstre

Almindelige mønstre i SDK-apps:

Gaffel + samlStart flere underagenter parallelt, indsaml hver agents præcise svar, og opsummer/flet derefter resultaterne i hovedagenten.
Supervisor-løkkeOrkestratoren tildeler opgaver til underagenter, inspicerer resultaterne og accepterer dem enten eller anmoder om genberegning/afklaring.
Sandbox-udførelseGiv potentielt farlige funktioner (implementering, kørsel af scripts) til en stramt begrænset agent og kræv eksplicitte menneskelige godkendelseshooks før udførelse.

Disse mønstre er knyttet til praktiske implementeringer ved hjælp af Agent SDK'ets sessionsstyring, hooks og MCP-værktøjer.

Sådan laver du underagenter, der er nyttige, sikre og sammensættelige

1) Enkelt ansvar og klare instruktioner

Hver underagent bør have ét klart formål og en systemprompt, der specificerer grænser, succeskriterier og outputformat. Hvis det ønskede output er struktureret (JSON, punktliste, kodepatch), skal underagenten instrueres præcist for at reducere parsingfejl.

2) Færdst adgang til værktøjer

Giv kun de værktøjer, en underagent har brug for. For eksempel behøver en dokumentanmelder ikke Write or BashBrug skrivebeskyttet som standard, hvor det er muligt, og eskaler værktøjstilladelser eksplicit, når det er nødvendigt. Dette reducerer risikoen og forenkler revision.

3) Returner kompakte, strukturerede output

Underagenter bør vende tilbage korte, endelige svar snarere end langvarige tankespor. Et almindeligt mønster er: udfør tungt arbejde inden for subagentens kontekst, og returner derefter et kort resumé med vedhæftede filer (patches, filreferencer, JSON). Dette maksimerer konteksteffektiviteten for orkestratoren.

4) Testbarhed og versionsstyring

Gem subagent-filer i versionskontrol, opret CI-tests, der udfører rigtige kørsel mod små input, og fastgør modeller/værktøjssæt. Hvis du er afhængig af færdigheder og plugins, skal du anvende plugin-markedspladsen/versionsmønstrene til at administrere opgraderinger og rollbacks.

5) Revisionshooks og human-in-the-loop-kontrolpunkter

Brug SDK-hooks til at opfange værktøjskald (PreToolUse-hooks) og kræve menneskelig godkendelse til destruktive handlinger. Log alle værktøjskald til afspilningsbare revisioner. SDK'et leverer hook- og tilladelsesmaskineri til at understøtte dette mønster.

Applikationseksempel — en lille, produktionslignende pipeline

Nedenfor er et kompakt eksempel, der viser de typiske dele: en filsystemagent, en SDK-kaldelse, der bruger to agenter (en til gennemgang, en til test), og en simpel orkestrering.

1) Filsystemagent: `.claude/agents/code-reviewer.md`

---
name: code-reviewer
description: Use PROACTIVELY after code changes. Perform security, style, and maintainability review on modified files.
tools: Read, Grep, Glob
model: inherit
---
You are a meticulous senior code reviewer. When invoked:
1. Run `git diff --name-only` to find modified files.
2. For each modified file, read and look for security issues, suspicious patterns, or maintainability problems.
3. Return JSON:
{
  "summary": "one-line summary",
  "issues": ,
  "recommended_changes": 
}

2) Programmatisk orkestrering (Node.js)

import { query } from '@anthropic-ai/claude-agent-sdk';
import fs from 'fs';

async function runPipeline() {
  const result = query({
    prompt: 'Run PR checks: security review then unit tests.',
    options: {
      agents: {
        'code-reviewer': {
          description: 'Use PROACTIVELY after code changes; output JSON with issues.',
          prompt: fs.readFileSync('./.claude/agents/code-reviewer.md', 'utf8'),
          tools: ,
          model: 'sonnet'
        },
        'test-runner': {
          description: 'Run test suite and summarize failing tests.',
          prompt: `You are a test-runner. Execute tests and return JSON { summary, failing_tests[] }`,
          tools: 
        }
      }
    }
  });

  for await (const message of result) {
    // Implement streaming logic: messages may include subagent outputs
    console.log(message);
  }
}

runPipeline().catch(console.error);

Bemærkninger: og code-reviewer gemmes i lageret til genbrug af teamet; SDK-kaldet viser, at programmatiske agenter har forrang, og tools Scoping forhindrer utilsigtede skrivninger.

Avancerede emner og mønstre

Dynamisk agentkonfiguration

Opret parameteriserede agentfabrikker, der vælger model og værktøjssæt afhængigt af miljø (udvikling vs. produktion) eller alvorlighedsniveauer (f.eks. strict vs balanced SDK-eksemplerne viser, hvordan man genererer agentdefinitioner under kørsel.

Parallelisering

Udskift flere skrivebeskyttede analyseagenter parallelt (stil, sikkerhed, testdækning) og aggreger deres JSON-output i hovedtråden. Dette reducerer vægklokketiden betydeligt for store repos.

Plugin-leverede agenter

Plugins kan levere underagenter pakket med plugin-manifestet; de vises i /agents sammen med brugerdefinerede agenter og kan kaldes eksplicit. Brug dette til at distribuere standardiserede agenter på tværs af teams.

Hvor man skal bruge Claude-koden, anbefales cli mest

Det var begejstret at kunne meddele, at CometAPI nu fuldt ud understøtter det kraftfulde Claude Code cli. Du skal kun installere Claude Code og godkende med den indhentede Comet API-nøgle og basisadresse for at bruge Comet API-modellen på Claude Code.

Hvorfor bruge Claude-kode via CometAPI?

Topfunktioner inden for kunstig intelligens: Generer, fejlfind og optimer nemt kode ved hjælp af modeller, der er bygget specifikt til udviklere.

Fleksibelt modelvalg: Vores omfattende udvalg af modeller giver dig mulighed for at udvikle mere problemfrit.
Problemfri integration: API'er er altid tilgængelige. Integrer Claude Code direkte i din eksisterende arbejdsgang på få minutter.
Brug af Claude Code via CometAPI vil spare flere omkostningerClaude API'en, der leveres af CometAPI, er 20% billigere end den officielle pris og er opdateret med den nyeste model af den officielle udbyder.

Klar til at bruge Claude Code cli? Se API guide for detaljerede instruktioner.

Hvis du vil vide flere tips, guider og nyheder om AI, følg os på VK, X og Discord!

Se også Hvordan installerer og kører man Claude-kode via CometAPI?

Afsluttende tanker

Behandl underagenter som genanvendelige, versionsbaserede mikropersonaerStart småt: lav en doc-reviewer og en test-runner for et lager, tjek dem ind .claude/agents/og automatiser dem i CI ved hjælp af headless claude -pGentag dine prompter, tilføj strukturerede output, og stram værktøjstilladelser.

Den mentale model, der hjælper mest: Forestil dig Claude som projektleder og underagenter som specialister i teamet. Lederen delegerer klart formulerede opgaver, samler specialisternes leverancer og skriver den endelige rapport. Over tid vil du se forbedringer i pålidelighed, testbarhed og evnen til at automatisere store dele af udviklernes arbejdsgange.

Sådan opretter og bruger du underagenter i Claude Code – en praktisk guide

Hvad er underagenter?

Hvorfor underagenter er vigtige

Forudsætninger for brug af underagenter i Claude Code

1) Claude Code installeret og godkendt

2) Node/miljø (for nogle installationsstier) og grundlæggende shell-værktøjer

3) Projektlayout & CLAUDE.md

4) Tilladelser og MCP-servere (valgfrit, men almindeligt)

Sådan opretter du underagenter i Claude Code

Hurtigt interaktivt flow (anbefalet første trin)

Filsystembaserede underagenter (Markdown + YAML frontmatter)

CLI JSON-definition (ad hoc/sessionsbrug)

Programmatisk definition (Agent SDK — anbefalet til apps)

Sådan aktiverer du underagenter

Automatisk delegering

Eksplicit påkaldelse (anbefales af hensyn til klarheden)

SDK-orkestratormønstre

Sådan laver du underagenter, der er nyttige, sikre og sammensættelige

1) Enkelt ansvar og klare instruktioner

2) Færdst adgang til værktøjer

3) Returner kompakte, strukturerede output

4) Testbarhed og versionsstyring

5) Revisionshooks og human-in-the-loop-kontrolpunkter

Applikationseksempel — en lille, produktionslignende pipeline

1) Filsystemagent: `.claude/agents/code-reviewer.md`

2) Programmatisk orkestrering (Node.js)

Avancerede emner og mønstre

Dynamisk agentkonfiguration

Parallelisering

Plugin-leverede agenter

Hvor man skal bruge Claude-koden, anbefales cli mest

Hvorfor bruge Claude-kode via CometAPI?

Afsluttende tanker

Læs mere

500+ modeller i én API

Sådan opretter og bruger du underagenter i Claude Code – en praktisk guide

Hvad er underagenter?

Hvorfor underagenter er vigtige

Forudsætninger for brug af underagenter i Claude Code

1) Claude Code installeret og godkendt

2) Node/miljø (for nogle installationsstier) og grundlæggende shell-værktøjer

3) Projektlayout & CLAUDE.md

4) Tilladelser og MCP-servere (valgfrit, men almindeligt)

Sådan opretter du underagenter i Claude Code

Hurtigt interaktivt flow (anbefalet første trin)

Filsystembaserede underagenter (Markdown + YAML frontmatter)

CLI JSON-definition (ad hoc/sessionsbrug)

Programmatisk definition (Agent SDK — anbefalet til apps)

Sådan aktiverer du underagenter

Automatisk delegering

Eksplicit påkaldelse (anbefales af hensyn til klarheden)

SDK-orkestratormønstre

Sådan laver du underagenter, der er nyttige, sikre og sammensættelige

1) Enkelt ansvar og klare instruktioner

2) Færdst adgang til værktøjer

3) Returner kompakte, strukturerede output

4) Testbarhed og versionsstyring

5) Revisionshooks og human-in-the-loop-kontrolpunkter

Applikationseksempel — en lille, produktionslignende pipeline

1) Filsystemagent: .claude/agents/code-reviewer.md

2) Programmatisk orkestrering (Node.js)

Avancerede emner og mønstre

Dynamisk agentkonfiguration

Parallelisering

Plugin-leverede agenter

Hvor man skal bruge Claude-koden, anbefales cli mest

Hvorfor bruge Claude-kode via CometAPI?

Afsluttende tanker

Læs mere

500+ modeller i én API

1) Filsystemagent: `.claude/agents/code-reviewer.md`