Claude Code hidastuu: näin valitset skillit, subagentit, MCP:n ja pluginin

Miksi Claude Coden täyteen ahtamisesta on tullut vuoden 2026 suurin kipupiste?#

Virallisessakaan dokumentaatiossa ei ollut valmista kattavaa vastausta kysymykseen ”milloin kannattaa valita mikäkin?”

Tässä artikkelissa kuvattu kuukauden mittainen kokemus kattaa kaikki neljä mekanismia toimivissa projekteissa: pino subagenteja yhtä monimutkaista tehtävää varten, pieni joukko skillejä toistuviin menettelyihin, pari MCP-palvelinta ajantasaista tietoa varten sekä valikoima muutama plugin noin kahdesta tusinasta. Tämä opas kokoaa esimerkin valintamatriisiksi, jossa on valmis päätöspuu, Anthropicin lainauksia ja seitsemän antikuviota, jotka tekevät Claudesta käyttökelvottoman.

Miten skill eroaa subagentista, MCP:stä ja pluginista yhdessä taulukossa?#

Valintamatriisi:

Yksinkertainen vertaus yrittäjälle: kuvittele, että olet kymmenen hengen yrityksen toimitusjohtaja:

• CLAUDE.md — yrityksen peruskirja. Aina seinällä; kaikki lukevat sen; kukaan ei väittele siitä.
• Skill — sisäinen menettelytapa. ”Näin teemme katselmoinnit”, ”näin kirjoitamme julkaisutiedotteet”, ”näin vastaanotamme maksun”.
• Subagent — asiantuntija, jolla on erillinen toimisto ja suppea luettelo käyttöoikeuksia. Jos annat hänelle avaimet kaikkeen, saat toisen toimitusjohtajan, et työntekijää.
• MCP-palvelin — yrityksen järjestelmät: CRM, pankki, varasto. Tämä ei ole tietoa vaan yhteys.
• Plugin — kaupasta ostettu valmis ratkaisu. Yksi paketti menettelytapoja, asiantuntijoita ja integraatioita.

Kun ymmärrät, että nämä ovat yhden järjestelmän neljä kerrosta eivätkä neljä kilpailijaa, kysymys ”mikä on paras?” katoaa. Jäljelle jää kysymys ”mikä kuuluu minne?”

Mikä skill on Claude Codessa ja milloin sellainen kannattaa asentaa?#

Anthropicin virallinen määritelmä:

Skillillä on kolme tasoa:

1. Metadata. Ladataan aina istunnon alussa: nimi ja kuvaus frontmatterista. Yksi skill käyttää käynnistyksessä noin 100 tokenia.
2. Ohjeet. Ladataan vain, kun Claude näkee käynnistävän pyynnön. Enintään 5 000 tokenia — SKILL.md:n sisältö.
3. Resurssit. Ladataan vain, kun ohjeissa pyydetään niitä nimenomaisesti. Paketin tiedostot, scripts/-kansion skriptit ja references/-kansion viitemateriaalit. Skriptit suoritetaan bash-komennolla; itse koodi ei päädy kontekstiin.

Anthropic kutsuu tätä periaatetta progressiiviseksi paljastamiseksi:

Samassa artikkelissa on myös vertaus, joka selittää ajatuksen paremmin kuin mikään muu:

Milloin skill kannattaa ottaa käyttöön:

• Toistuva vakiomenettely. PR-katselmoinnit, julkaisutiedotteet, koodikatselmointi oman tyylioppaan mukaan.
• Kun CLAUDE.md-tiedoston osio on muuttunut faktasta menettelytavaksi ja alkaa olla kaiken muun tiellä.
• Kun haluat saman ohjeen noudattuvan johdonmukaisesti eri projekteissa.

Käytännön kaava: jos teet jotain useammin kuin pari kertaa, siirrä se järjestelmän hoidettavaksi. Ensimmäisellä kerralla käytä manuaalista promptia. Toisella kerralla se on skill-ehdokas.

Milloin skilliä EI pidä käyttää:

• Jos tehtävä vaatii reaaliaikaisia tietoja (tietokanta, API, haku, ajantasaiset pörssitiedot). Siihen tarvitaan MCP, ei skill. Skill, joka yrittää ”hakea nykyisen hinnan”, hallusinoi.
• Jos tehtävä vaatii eristetyn kontekstin. Siihen tarvitaan subagent.
• Jos tarvitset pakotetun tarkistuksen (”estä .env-tiedoston sisältävä commit”), käytä kyseisen commit-polun kattavaa hookia pelkän skillin sijaan. Tarkista ja testaa sen todellinen kattavuus. Hook ei rajoita kaikkia tapoja lukea, kopioida tai julkaista tiedostoa.

Rajoitukset, jotka on hyvä tietää etukäteen:

• Skillin nimi: enintään 64 merkkiä, vain pienaakkosia, numeroita ja yhdysmerkkejä. Sanat anthropic ja claude on varattu.
• Kuvaus: enintään 1 024 merkkiä. Yhdistetty description + when_to_use katkaistaan 1 536 merkissä luettelossa.
• SKILL.md:n sisältö: suositus on enintään 500 riviä. Siirrä loput references/- ja scripts/-kansioihin.
• Kontekstin automaattisen tiivistämisen (auto-compaction) yhteydessä jokaisesta aktiivisesta skillistä liitetään uudelleen ensimmäiset 5 000 tokenia. Kaikkien skillien kokonaisbudjetti on 25 000.

Mikä on subagent ja miksi sisäkkäisiä tasoja on 5?#

Virallisesta dokumentaatiosta:

Claude Codessa on kolme sisäänrakennettua subagentia, joita käytät jo tietämättäsi:

Anthropic julkaisi 10. kesäkuuta 2026 Claude Code v2.1.172:n ja poisti rajoituksen, joka oli ollut voimassa subagentien julkaisusta asti: lapsiagentit voivat nyt käynnistää omia subagenttejaan jopa 5 tasoa syvälle.

Luku 5 on turvallisuusraja, ei optimointitavoite.

Yksityiskohtainen ominaisuuksien erittely YAML-orkestrointipohjineen löytyy sisäkkäisiä subagentteja käsittelevästä oppaasta.

Milloin subagentia kannattaa käyttää:

• Koodin tai lokien tutkiva läpikäynti, josta tarvitset vain lyhyen johtopäätöksen.
• Rinnakkaiset tehtävät, jotka voivat edetä samanaikaisesti.
• Erikoistumiseen perustuva delegointi: backend / frontend / testaus / katselmointi — kukin hoitaa yhtä ominaisuutta.
• Kustannusten hallinta: Haiku-subagent Sonnetin tai Opuksen sijaan. Tämä pienentää laskua 5–7 kertaa.

Milloin subagentia EI pidä käyttää:

• Yksinkertainen kertaluonteinen tehtävä tai helppo työkalukutsu. Subagentilla on käynnistyskustannus.
• Kun tehtävien täytyy jakaa tila. Subagentit eivät näe toistensa konteksteja; toisiinsa liittyvän työn kannattaa pysyä pääketjussa.

Tärkein antikuvio:

Jos annat subagentille Opuksen ja kaikki työkalut, siitä tulee vain toinen pääistunto. Jos sen työkaluluettelo vastaa pääagentin luetteloa, subagentia ei ole rajattu kunnolla.

Toisin sanoen subagent, jolla on samat käyttöoikeudet kuin emollaan, on vain toinen toimitusjohtaja. Turha ja kallis.

Mikä MCP-palvelin on ja milloin sellainen kannattaa yhdistää Claude Codeen?#

Virallinen määritelmä:

Mitä MCP:llä voi käytännössä tehdä:

• Yhdistä Claude Google Calendariin ja Notioniin saadaksesi henkilökohtaisen avustajan.
• Yhdistä Figmaan, jotta Claude luo valmiin verkkoprojektin suunnitelman pohjalta.
• Yhdistä yrityksen chatbot useaan tietokantaan kerralla.
• Yhdistä Blenderiin ja 3D-tulostimeen, jotta voit luoda malleja ja tulostaa ne heti.

Tunnetuimmat MCP-palvelimet, jotka ihmiset yleensä asentavat ensin:

Yhteydet ja asennuskomennot on koottu MCP-luetteloon.

Milloin MCP:tä kannattaa käyttää:

• Kaikki yhteydet ulkoisiin tietoihin tai toimintoihin: ”hae rivejä tietokannasta”, ”lue Jira-tikettejä”, ”julkaise Slackissa”.
• Kun samaa palvelua tarvitaan useissa projekteissa tai agenteissa, yksi keskitetty palvelin on helpompi ratkaisu.

Milloin MCP:tä EI pidä käyttää:

• Staattinen tieto tai menettelytapa. Siihen tarvitaan skill, ei MCP:tä. ”Ohjeet koodikatselmoinnin tekemiseen” on skill. ”Lue GitHubin uusin PR ja katselmoi se” on MCP.
• Yksittäinen CLI-komento. Bash on helpompi kuin palvelimen pystyttäminen.
• Kun haluat rakentaa MCP:n ”oikeaoppisen arkkitehtuurin vuoksi”. Se on estetiikkaa, ei tehtävä.

MCP:n tärkein sudenkuoppa on yksi suurimmista syistä valituksiin siitä, että ”Claude Code on ihan tyhmä” vuonna 2026:

Kun asennat kaikki nämä MCP:t kerralla, tukahdutat LLM:n konteksti-ikkunan: kaikki käytettävissä olevat työkalut ladataan kontekstiin.

Käytännön nyrkkisääntö: pidä käytössä enintään 2–3 tiettyihin tehtäviin suunnattua MCP-palvelinta. Kuvatussa kokemuksessa monet palvelimet hidastivat käynnistystä ja lisäsivät virheitä.

MCP-työkaluhaku lisättiin Claude Code v2.1.x:ään: työkaluja ei enää ahnehdita suoraan kontekstiin, vaan ne indeksoidaan ja haetaan tarpeen mukaan. Tämä vähentää ”monien MCP:iden projektissa” aiheuttamaa kulua, mutta ei poista sitä kokonaan.

Miten plugin eroaa skillistä, ja miksi raja on hämärtynyt?#

Virallinen sanamuoto:

Asennusmäärien kärki kesäkuussa 2026:

Koko valinta-analyysi on oppaassa, joka käsittelee 10 parasta 101 pluginista.

Milloin plugin kannattaa ottaa käyttöön:

• Valmis yhteisön paketti, joka kattaa suuren osan työnkulusta, kuten suunnittelun tai katselmoinnin.
• Jos et halua koota ”skill + subagent + MCP + hook” -kokoonpanoa käsin, voit käyttää valmista pakettia.
• Yritysjakelu: ylläpitäjä luo tiimille markkinapaikan, josta kehittäjät asentavat kaiken samalla etuliitteellä.

Milloin pluginiä EI pidä käyttää:

• Tehtävä onnistuu yhdellä skillillä, mutta paketti tuo mukanaan viisi ylimääräistä MCP:tä ”varmuuden vuoksi”. Se on pelkkää kontekstin täyttämistä.
• Suljetun lähdekoodin plugin, jota ei ole tarkastettu. Se toimii käyttöoikeuksillasi — lue sen sisältö ennen asentamista.
• Sinulla on jo oma samaa aihetta käsittelevä plugin. Kaksoiskappale kontekstissa merkitsee kaksinkertaista harmia.

Ennen asennusta Claude Code v2.1.143+ näyttää Context cost -arvion siitä, kuinka monta tokenia plugin lisää kuhunkin viestiin. Versiosta v2.1.145+ lähtien siinä näkyy Will install -kenttä, jossa luetellaan täydellisesti paketin komennot, agentit, skillit, hookit, MCP ja LSP. Avaa tämä näkymä ensimmäisenä ennen asennuksen napsauttamista.

Millainen valintamatriisi toimii vuonna 2026?#

Kuusi kysymystä tärkeysjärjestyksessä:

1. Onko kyseessä toistuva menettely, tyyli tai tarkistuslista? Jos on — skill.
2. Tarvitsetko ulkoisia tietoja tai toimintoja (tietokanta, API, Slack, GitHub, Figma)? Jos tarvitset — MCP-palvelin.
3. Haluanko erillisen kontekstin, jotta en täytä pääkontekstia? Jos haluan — subagent.
4. Haluanko tarkistuksen tai automaattisen vaiheen määrättyyn tapahtumaan? Jos haluan — hook, jonka kattavuus on testattu. Käytä laajempien pääsyrajojen toteuttamiseen käyttöoikeuksia tai ympäristön eristystä.
5. Haluanko valmiin paketin kohdista 1–4 yhdellä klikkauksella? Jos haluan — plugin markkinapaikalta.
6. Onko kyseessä monimutkainen tehtävä, joka tarvitsee tietoa, kontekstia ja tyyliä? Käytä silloin yhdistelmää: Haiku-subagent + esiladattu skill + yksi tarkasti rajattu MCP.

Yhdistelmäkaava:

Haiku-subagent, jolla on esiladattu skill käytäntöjä varten ja tarkasti rajattu MCP-palvelin ajantasaista tietoa varten, on yhdistelmä, joka todella kannattaa.

Ja riippuvuuksien suunnan pääsääntö:

Subagentit voivat käyttää MCP-palvelimia. MCP-palvelimet eivät voi käyttää subagentteja.

Toisin sanoen MCP tarjoaa aina tietoja ja toimintoja, ei agentteja. Jos haluat delegoida tehtävän, subagent kutsuu MCP:tä, ei päinvastoin.

Tässä kuvattu konkreettinen esimerkki on digitaalisen toimiston toimituksellinen moottori, joka kirjoittaa yhden SEO-artikkelin 60 minuutissa. Siihen kuuluu 25 subagentia ja 14 tarkistusvaihetta — ne suoritetaan peräkkäin, ja jokaisella on oma kontekstinsa, käyttöoikeutensa ja toimituksellisia käytäntöjä varten oma skillinsä. Yksi subagentti yhdistää MCP-palvelimeen, jonka tietokannassa on valmiita tageja ja vanhoja artikkeleita. Pääorkestrointiagentti käyttää Opusta; lapsiagentit käyttävät Haikua, mikä pitää budjetin kohtuullisena.

Tämä ei ole ”artikkelien tehdas” vaan esimerkki siitä, miten kaikki neljä mekanismia yhdistyvät yhdeksi järjestelmäksi silloin, kun tehtävä vaatii laadukasta jälkeä nopeuden sijaan.

Mitkä 7 virhettä kannattaa poistaa Claude Codesta heti?#

1. Asensit kaikki 10 suosituinta pluginia, ”koska ne ovat trendikkäitä”. Jokainen lisää tokeneita jokaiseen viestiin. Avaa /plugin list ja tarkista kunkin pluginin Context cost. Poista ne, joita et ole käyttänyt kahteen viikkoon.

2. Kopioit 15 MCP-palvelinta jonkun toisen .mcp.json-tiedostosta. Toisen ihmisen stack on määritetty hänen projektejaan ja tehtäviään varten. Pidä nykyisessä projektissa enintään 2–3 aktiivista MCP:tä. Siirrä ylimääräiset erilliseen toisen projektin määritykseen tai poista ne nyt.

3. Skill ja MCP-plugin tekevät saman asian. Skill sanoo ”tee koodikatselmointi”, kun taas pr-review-toolkit-plugin ajaa oman katselmointityönkulkunsa. Ne alkavat kilpailla etusijasta. Oire: ”Claude, miksi palaat jatkuvasti edestakaisin?” Ratkaisu: pidä yksi totuuden lähde. Kuvatussa kokoonpanossa valittiin skill, jotta ohjeet pysyvät hallinnassa.

4. Käytät skilliä toimeenpanon valvontaan, vaikka tarvitset hookin. Skill on ehdotus, ei takuu. Vaatimukseen ”estä .env commitissa” pre-commit-hook voi tarkistaa kyseisen commit-polun. Testaa vaiheistettu sisältö ja vaihtoehtoiset polut erikseen. Hook ei estä kaikkea lukemista tai muita julkaisureittejä. Pelkkä skill ei voi pakottaa tätä rajaa.

5. Subagentilla on samat käyttöoikeudet kuin emollaan. Annoit sille Opuksen ja kaikki työkalut, ja sait toisen pääistunnon. Virallisen dokumentaation järjestelmäprompti suosittelee antamaan subagentille suppean työkaluluettelon ja oman rajatun tehtävän. Muuten se on vain kallis klooni.

6. Et tarkistanut Will install -kenttää ennen pluginin asentamista. Claude Code v2.1.145+:ssa kenttä näyttää paketin koko sisällön. Usein plugin, joka on tarkoitettu ”yhteen pieneen asiaan”, sisältää kolme MCP-palvelinta, kaksi subagentia ja viisi hookia. Kaikki ne alkavat viedä tilaa kontekstista.

7. Vanhat .claude/commands/-komennot ovat uusien skillien kaksoiskappaleita. Anthropic kertoo dokumentaatiossaan:

Vanha commands/-kansio toimii yhä, mutta skillit ovat nyt standardi. Kuvatussa esimerkissä käytössä olivat molemmat kansiot; commands/ poistettiin, ja jäljelle jäivät tiedostopaketteja ja käynnistimiä sisältävät skillit.

Merkkejä siitä, että Claude Code on ”täynnä turhaa”:

• Jokainen viesti alkaa käytettävissä olevien työkalujen luettelolla, jossa on 200+ riviä.
• Yksinkertaiset tehtävät kestävät kauemmin kuin kuukausi sitten.
• Claude sekoittaa kaksi samankaltaista skilliä tai pluginia keskenään.
• Istunnon alussa näkyy varoituksia nimien törmäyksistä.
• Claude kutsuu väärää työkalua — skill A:ta MCP B:n sijaan, vaikka jälkimmäistä tarvittiin.

Jos tunnistat vähintään kaksi näistä oireista, avaa /plugin list ja /skill list heti. Poista ensin ne, joita et ole käyttänyt kahteen viikkoon. Tarkista sitten jokaisen kohteen Context cost. Puutu sen jälkeen yllä kuvattuihin antikuvioihin.

Kuinka monta skilliä ja MCP:tä voit pitää kuluttamatta kontekstia loppuun?#

Nämä Claude Code näyttää suoraan:

• /skill list — kaikki aktiiviset skillit ja niiden tokenkoko.
• /plugin list — kaikki pluginien Context cost -arvot.
• /mcp list — MCP-palvelimet ja niiden työkalujen määrä.

Tokenbudjetti todellisina lukuina:

Konteksti-ikkuna on työtilan enimmäiskoko, ei jokaisen tehtävän kuluttama tokenimäärä. Vertaa samasta lopputuloksesta mitattua syötettä, välimuistista luettua syötettä, tulostetta ja toistuvia vuoroja. Eristys voi pitää pääkontekstin pienenä, vaikka subagentti aiheuttaa edelleen omaa käyttöä.

Anthropic esittää teknisessä blogissaan skillien automaattisen tiivistyksen luvut: jokaisesta aktiivisesta skillistä liitetään uudelleen ensimmäiset 5 000 tokenia, ja kokonaisbudjetti on 25 000. Tämä tarkoittaa, että Claude alkaa menettää joitakin ohjeita, kun yli 5 ”raskasta” skilliä on aktiivisena samanaikaisesti.

Yksinkertainen käytännön sääntö:

• Skillit: enintään 5–7 aktiivista nykyisessä projektissa. Siirrä loput polkuun ~/.claude/skills/disabled/; voit siirtää ne takaisin, jos tarvitset niitä.
• MCP: enintään 2–3 projektia kohti. Context7 dokumentaatiota varten kannattaa lähes aina pitää käytössä; pidä muut tehtäväkohtaisina.
• Pluginit: asenna vain yksi kerrallaan ja tarkista kahden viikon kuluttua, käytitkö sitä. Jos et, poista se.

Anthropicin vuoden 2026 Agentic Coding Trends Report -raportin ja sen syiden yksityiskohtainen analyysi, miksi 80 % kehittäjistä ei pysty delegoimaan tehtävää kokonaan Claudelle, on erillisessä oppaassa. Raportin pääluku: ihmiset käyttävät tekoälyä 60 %:ssa työstään, mutta antavat kokonaan sen hoidettavaksi vain 0–20 % tehtävistä. Tärkein syy on kontekstin ylikuormitus ja työkalujen hallinnan menetys.

Mistä aloittelijan kannattaa aloittaa: minimaalinen toimiva kokoonpano?#

Minimaalinen stack kahden työskentelyviikon jälkeen:

1. CLAUDE.md juurihakemistossa projektisääntöjä varten.
2. AGENTS.md yhteensopivuutta varten muiden työkalujen kanssa, jos aiot työskennellä Claude Coden ulkopuolella. Lisätietoja oppaassa ”Näin teet yhden ohjetiedoston Claude Codelle, Codexille ja Cursorille”.
3. 1 skill tärkeimpään toistuvaan tehtävääsi. Aloita esimerkiksi code-review-skillillä oman tyylioppaan mukaan.
4. 1 MCP-palvelin: Context7 ajantasaista dokumentaatiota varten. Ilman sitä Claude hallusinoi edelleen olemattomia API-rajapintoja.
5. 0 pluginia ja 0 subagentia ensimmäisen kuukauden aikana. Kyse ei ole säästämisestä vaan hallinnasta. Ennen kuin ymmärrät perusteet, paketit hämmentävät sinua.

Seuraa sen jälkeen tehtäviäsi. Ilmaantuuko toistuva menettely? Muuta se skilliksi. Tarvitsetko reaaliaikaista tietoa jostakin palvelusta? Lisää MCP. Alkaako suuri tehtävä täyttää pääkontekstia? Delegoi se subagentille.

Tämä on kolmitasoinen kartta: ensin konteksti, sitten siirrä järjestelmän hoidettavaksi se, mitä teet useammin kuin pari kertaa, ja lopuksi automaattiset tarkistukset, jotta järjestelmä ei tee virheitä omin päin. Lisää kukin taso vasta, kun edellinen jo toimii.