# Værktøjssøgning i Claude Code: sådan finder agenten det MCP-værktøj, den har brug for > Sådan fungerer værktøjssøgning i Claude Code: hvad der indlæses i konteksten med det samme, hvornår mekanismen slår sig fra, og hvordan du konfigurerer ENABLE_TOOL_SEARCH og alwaysLoad. Source: https://ailoot.ai/blog/da/claude-code-tool-search-mcp-limit/ Canonical: https://ailoot.ai/blog/da/claude-code-tool-search-mcp-limit/ Language: da Publisher: Ailoot (https://ailoot.ai/) Translation: guide-055 Revision: sha256-7a82a89b90db64a13e0d55f394030c0ed85305680c335f38f2c8ce452be457a4 Hvis du har tilsluttet flere MCP-servere til Claude Code, kan værktøjssøgning indlæse de værktøjer, den skal bruge, efter behov, uden at indlæse alle definitioner på forhånd. Ved opstart får agenten navnene på udskudte værktøjer og servernes instruktioner og søger derefter i kataloget efter det, den har brug for. Det hjælper den med at arbejde med et stort sæt værktøjer: Anthropics dokumentation angiver, at præcisionen i udvælgelsen falder, når mere end 30-50 værktøjer indlæses på én gang. Det er generel vejledning, ikke en måling af din session. Værktøjssøgning er som standard aktiveret, når modellen understøtter den, men platformen, en proxy eller indstillinger kan deaktivere den. [Ailoot-dokumentation: API, nøgler og opsætning](https://ailoot.ai/docs/). ## Hvad sker der med konteksten uden værktøjssøgning Hver tilsluttet MCP-server føjer sine værktøjer til listen over ting, agenten kan kalde. Uden værktøjssøgning indlæses deres definitioner — navn, beskrivelse og parameterskema — i konteksten på forhånd. Serverne tilsluttes i baggrunden, når en session starter. Hvis der er brug for et værktøj fra en server, som endnu ikke er færdig med at tilslutte sig, venter Claude Code via det interne værktøj `WaitForMcpServers`. Du kan separat vurdere, hvor mange værktøjer og tokens en bestemt server tilføjer ved hver forbindelse. Anthropics officielle dokumentation angiver to omtrentlige tal (generelle tal uden en angivet målemetode): - 50 værktøjer kan optage 10-20 tusind kontekstattokens; - præcisionen i valget af det rette værktøj falder, når mere end 30-50 indlæses på én gang. ## Sådan vurderer du værktøjssøgning ud fra indstillingerne Kontrollér følgende for at finde ud af, om værktøjssøgning bør fungere i den aktuelle session: - hvilken model der svarer — Sonnet/Haiku/Opus 4.5 eller nyere: mekanismen er tilgængelig; en ældre model: den er ikke tilgængelig; - om `ANTHROPIC_BASE_URL` er angivet til en ikke-standardvært — i så fald er mekanismen som standard slået fra, medmindre den udtrykkeligt aktiveres via `ENABLE_TOOL_SEARCH`; - værdien af variablen `ENABLE_TOOL_SEARCH` — `false` deaktiverer mekanismen helt; `auto`/`auto:N` aktiverer den kun, når mængden af definitioner når en tærskel; - om `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` er angivet — uden organisationens administrerede indstillinger holder den værktøjssøgning slået fra, selv hvis brugeren har angivet `ENABLE_TOOL_SEARCH`; - om værktøjet `ToolSearch` er blokeret via `permissions.deny` i indstillingerne — en sådan begrænsning deaktiverer søgning; - hvilken platform der bruges — mekanismen er ikke tilgængelig på Microsoft Foundry-installationer i Azure, mens dens funktion på Google Cloud Agent Platform afhænger af Claude Code-versionen og modellen. Denne kontrol lader dig vurdere tilstanden ud fra konfigurationen, men ikke observere den inde i sessionen. MCP-afsnittet og afsnittet om værktøjssøgning i Agent SDK-dokumentationen beskriver ikke en direkte indikator i brugerfladen for “værktøjssøgning: til/fra”. At disse to dokumenter ikke nævner en sådan indikator, beviser ikke, at der ikke findes en et andet sted. Du kan angive variablen, før du starter en session, for eksempel `ENABLE_TOOL_SEARCH=auto:15 claude`. Hvis du vil sikre, at en bestemt servers værktøjer altid indlæses, skal du bruge feltet `alwaysLoad: true` i serverens konfiguration. Det er tilgængeligt for alle servertyper; betingelserne og begrænsningerne beskrives i afsnittet om alwaysLoad nedenfor. ## Sådan fungerer værktøjssøgning Når værktøjssøgning er aktiveret, indlæses kun navnene på udskudte værktøjer og serverens instruktioner i konteksten, når sessionen starter. Serverinstruktionerne beskriver, hvilke opgaver serveren er nyttig til. Når en opgave kræver en funktion, som endnu ikke er i konteksten, søger agenten selv i kataloget efter et passende værktøj. Agent SDK-dokumentationen beskriver søgemekanismen mere detaljeret: Som standard indlæser en enkelt søgning op til fem af de mest relevante værktøjer fra kataloget. De forbliver tilgængelige i efterfølgende ture i sessionen, indtil SDK'et komprimerer de meddelelser, hvor agenten fandt dem. Efter komprimering kan tidligere fundne værktøjer falde ud af konteksten, og agenten søger efter dem igen, næste gang der er brug for dem. Kataloget understøtter op til 10 000 værktøjer. MCP-dokumentationen for Claude Code selv angiver ikke disse specifikke tal, men beskriver det samme princip om udskudt indlæsning. Ifølge Agent SDK-dokumentationen tilføjer hver søgning en ekstra rundtur. Dokumentationen angiver ikke præcist, hvad denne rundtur omfatter. For Claude Code beskriver MCP-dokumentationen også en forskel i fejlrapportering: Uden værktøjssøgning fortæller Claude Code ikke modellen om mislykkede serverforbindelser. Når søgning er aktiveret, får modellen oplysninger om, hvilken server der ikke kunne oprette forbindelse, og hvad fejlen var. Claude Code har ingen fast grænse for antallet af værktøjer fra én enkelt server. Den praktiske grænse er kontekstvinduets budget for den konkrete session. Konfiguration af værktøjer er en af opgaverne i forbindelse med håndtering af en AI-agents kontekst. ## Hvornår værktøjssøgning er slået fra som standard Mekanismen er som standard aktiveret, men dens funktion afhænger af modellen, API-værten og platformen. **Model.** Værktøjssøgning kræver en model, der understøtter tool_reference-blokke: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 eller nyere. For ældre modeller indlæser Claude Code værktøjsdefinitionerne på forhånd. **API-vært.** Claude Code deaktiverer værktøjssøgning, når variablen `ANTHROPIC_BASE_URL` peger på en tredjepartsvært: De fleste proxyer videresender ikke de særlige tool_reference-blokke. Det gælder, når du opretter forbindelse til Claude via din egen gateway eller proxyserver i stedet for direkte via Anthropics adresse. Det er en ikke-standardiseret `ANTHROPIC_BASE_URL`, der får værktøjssøgning til at blive slået fra; hvordan abonnementet betales, er ikke i sig selv årsagen. Du kan udtrykkeligt angive `ENABLE_TOOL_SEARCH` for at tilsidesætte denne adfærd. Hvis proxyen ikke understøtter tool_reference-blokke, medfører det en anmodningsfejl at gennemtvinge mekanismen. I dette tilfælde skifter den ikke tilbage til at indlæse definitioner på forhånd. **Udrulningsplatform.** Værktøjssøgning fungerer ikke på Microsoft Foundry-installationer, der hostes på Azure: Serveren afviser anmodningen, og `ENABLE_TOOL_SEARCH` tilsidesætter ikke dette. På Google Cloud Agent Platform var mekanismen slået fra for alle modeller før Claude Code version 2.1.221, medmindre `ENABLE_TOOL_SEARCH=true` var angivet udtrykkeligt. Fra og med den version er den som standard aktiveret for Opus/Sonnet/Haiku 4.5 og nyere. For ældre modeller på platformen indlæser Claude Code stadig alle værktøjer på forhånd, fordi serverinfrastrukturen afviser den nødvendige interne header. Variablen `ENABLE_TOOL_SEARCH` har fem mulige indstillinger: - ikke angivet — standardadfærden med undtagelserne ovenfor; - `true` — mekanismen aktiveres for modeller, der understøtter den, med to undtagelser: Azure Foundry og ældre Agent Platform-modeller; anmodninger sendt via en proxy uden understøttelse af tool_reference-blokke mislykkes; - `auto` — Claude Code indlæser værktøjer på forhånd, mens deres samlede definitioner optager mindre end 10% af kontekstvinduet, og skifter til udskudt indlæsning, når tærsklen nås; - `auto:N` — samme princip med en manuelt angivet procenttærskel; - `false` — mekanismen deaktiveres helt, og alle værktøjer indlæses på forhånd. Der findes også variablen `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`: Hvis den er angivet, forbliver værktøjssøgning slået fra, og det ændrer ikke noget, at brugeren angiver `ENABLE_TOOL_SEARCH`. Undtagelsen er, når organisationen holder værktøjssøgning aktiveret via administrerede indstillinger, som er tilgængelige fra Claude Code version 2.1.227. ## Hvad alwaysLoad gør, og hvordan det påvirker kontekst og opstart Feltet `alwaysLoad: true` i en servers konfiguration er tilgængeligt for alle servertyper. Med dette felt indlæses alle serverens værktøjer i konteksten ved opstart, uanset indstillingen for `ENABLE_TOOL_SEARCH`. Agenten behøver ikke at søge efter dem, før de bruges. Det har to konsekvenser altid at indlæse værktøjer. Hvert værktøj, der indlæses på forhånd, optager noget af den kontekst, der ellers ville være tilgængelig til selve opgaven. Derudover venter sessionsopstarten på, at denne server opretter forbindelse, inden for standardtimeouten på fem sekunder. Undtagelsen er en fjernserver med en gyldig cachepost: Den leverer værktøjerne fra cachen uden at oprette forbindelse og forsinker ikke opstarten. Opdagelsescachen er som standard slået fra, medmindre den allerede er blevet aktiveret for kontoen under den gradvise udrulning af funktionen. Du kan også aktivere den udtrykkeligt via `MCP_DISCOVERY_CACHE=1`. Undtagelsen for hurtig opstart gælder, når cachen er aktiv og indeholder en gyldig post. Værktøjer med `alwaysLoad` optager stadig kontekst permanent, uanset om agenten ville have haft brug for dem, når den arbejdede via søgning. Hvis du skriver din egen MCP-server: Serverinstruktioner hjælper Claude med at forstå, hvornår den skal søge efter serverens værktøjer, omtrent som Skills gør. Claude Code afkorter som standard hver værktøjsbeskrivelse og hver servers instruktioner til 2048 tegn, så placér vigtige detaljer først. Valget af, hvordan Claude Code skal udvides, afhænger af mere end antallet af tilsluttede MCP-servere. Vejledningerne [Claude Code: hvor mange udvidelser bør være aktive ad gangen](https://ailoot.ai/blog/da/claude-code-skills-subagents-mcp-plugins/) og [Hvad skal du vælge i Claude Code: Skills, Subagents, MCP eller Plugins](https://ailoot.ai/blog/da/skills-subagents-mcp-plugins-claude-code/) gennemgår Skills, Subagents, MCP og Plugins til forskellige opgaver. Se [MCP-servere til Claude Code: færdige kombinationer](https://ailoot.ai/blog/da/mcp-servers-claude-code/) for trinvis opsætning af specifikke MCP-servere. ## Hvad nu For et sæt på færre end cirka 10 værktøjer, hvis definitioner uden problemer kan være i konteksten, bemærker Agent SDK-dokumentationen, at det som regel er hurtigere at indlæse dem alle på én gang. I Claude Codes standardadfærd er værktøjssøgning dog aktiveret, når variablen ikke er angivet, og ingen af begrænsningerne ovenfor gælder; MCP-værktøjer indlæses derfor først ved søgning, bortset fra servere med `alwaysLoad`. Her kan du udtrykkeligt angive `ENABLE_TOOL_SEARCH=auto`: Definitionerne indlæses på forhånd, mens deres samlede mængde er mindre end 10% af kontekstvinduet, og søgning aktiveres, når tærsklen nås. En anden mulighed er `ENABLE_TOOL_SEARCH=false`, hvis du ved, at sættet ikke vokser. I så fald holder Claude Code op med at fortælle modellen om mislykkede serverforbindelser, som beskrevet ovenfor. I andre tilfælde skal du kontrollere driftsbetingelserne igen, når miljøet ændrer sig: - skift til Sonnet/Haiku/Opus 4.5 eller nyere, hvis sessionen bruger en ældre model; - hvis forbindelsen bruger en ikke-standardiseret `ANTHROPIC_BASE_URL`, skal du kun angive `ENABLE_TOOL_SEARCH=true`, når proxyen selv videresender tool_reference-blokke; - kontrollér, at udrulningsplatformen ikke er blandt undtagelserne: Azure Foundry eller ældre Google Cloud Agent Platform-modeller. Hvis betingelserne er opfyldt, og søgning ikke er blokeret af indstillingerne, kan du tilslutte de MCP-servere, du har brug for. Brug kun `alwaysLoad` til servere, hvis værktøjer er nødvendige i hver tur i sessionen; lad de øvrige blive indlæst via søgning.
### Kilder - [MCP i Claude Code, afsnittet “Scale with MCP tool search” — Anthropics officielle dokumentation](https://code.claude.com/docs/en/mcp.md) - [Værktøjssøgning i Agent SDK — Anthropics officielle dokumentation](https://code.claude.com/docs/en/agent-sdk/tool-search.md)
Hvis du har brug for adgang til AI-modeller via Ailoot, kan du tage et kig på [Ailoot](https://ailoot.ai/). ## Spørgsmål og svar ### Hvorfor kan værktøjssøgning fejle bag en proxy, selv når den er aktiveret? En tredjeparts API-vært skal understøtte tool_reference-blokke. At tvinge ENABLE_TOOL_SEARCH til kan ikke tilføje denne understøttelse; en inkompatibel proxy kan afvise forespørgslen frem for at falde tilbage til indlæsning af alle værktøjer. ### Hvornår skal jeg sætte alwaysLoad for en MCP-server? Brug det, når serverens værktøjer behøves i hver tur. Alle dens værktøjsdefinitioner optager da kontekst ved opstart, og opstarten kan vente på forbindelsen, medmindre en gyldig post i discovery-cachen gælder. ## Ailoot · Virksomheden og dens projektportefølje Ailoot bygger på solid driftserfaring, en stor kundebase, stabil service og løbende kontrol af KPI. Virksomheden og dens projektportefølje: millioner af kunder; månedligt salg for milliarder. Ailoot bruger denne driftserfaring til API-adgang til AI-funktioner i kundernes produkter, agenter, applikationer og automatiseringer.