SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Umiejętności agenta, MCP czy pliki reguł: co wybrać?

Porównanie trzech metod dostarczania kontekstu dla agentów programistycznych. Analiza kosztów tokenów, narzutu na sesję oraz optymalnego wyboru dla konkretnych zadań.

Umiejętności agenta, serwery MCP i pliki reguł: krótka odpowiedź

Umiejętności agenta, serwery MCP oraz pliki reguł dostarczają wiedzę agentowi programistycznemu. Wybór zależy od przeznaczenia tej wiedzy. MCP (Model Context Protocol) służy do danych, które mogą ulec zmianie przy kolejnym odczycie. Umiejętność (skill) dotyczy procedury, którą można opisać dzisiaj i która pozostanie poprawna za sześć tygodni. Plik reguł (rules file) przeznaczony jest dla kilku faktów, które muszą być prawdziwe w każdej sesji.

Ten wybór wiąże się z kosztem, a jest nim kontekst. Każdy token zużyty na instrukcję, której agent nie potrzebował, to token niedostępny dla analizowanego kodu. Jest to również token, za który płaci się ponownie w każdej turze, ponieważ całe okno kontekstowe jest przesyłane przy każdym żądaniu. Zatem istotne pytanie nie brzmi, który mechanizm może wykonać zadanie. W większości przypadków wszystkie trzy są w stanie to zrobić. Pytanie brzmi, który z nich generuje najniższy koszt, gdy pozostaje nieaktywny.

Koszt każdego z nich przed użyciem

Te trzy elementy ładują się w różnych momentach, a ten czas jest kluczową różnicą.

Plik reguł bezwarunkowych ładuje się przy uruchomieniu, w każdej sesji, niezależnie od tego, czy jest istotny, czy nie, chyba że zostanie wykluczony. Claude Code odczytuje pliki startowe CLAUDE.md na początku każdej konwersji, usuwa komentarze HTML na poziomie bloków spoza bloków kodu przed wstrzyknięciem ich zawartości i pomija pliki większe niż 4 MiB; claudeMdExcludes może również wykluczyć pliki z wyjątkiem zarządzanego pliku polityki. Dokumentowany cel to poniżej 200 linii na plik, ponieważ dłuższy plik kosztuje więcej kontekstu oraz jest rzadziej przestrzegany. Te dwa efekty działają w tym samym kierunku, dlatego 900-liniowy plik reguł jest gorszy niż bezużyteczny.

Umiejętność (skill) ładuje się w dwóch etapach. Przy starcie tylko linia description z każdego frontmattera SKILL.md wchodzi do kontekstu, dzięki czemu model wie, że umiejętność istnieje i mniej więcej kiedy ma zastosowanie. Treść ładuje się w momencie wywołania umiejętności. 400-liniowy dokument referencyjny nie kosztuje więc prawie nic aż do momentu, gdy jest potrzebny.

Serwer MCP był kiedyś tym kosztownym elementem i to właśnie tutaj większość porównań, które można przeczytać, jest obecnie nieaktualna. Wyszukiwanie narzędzi (tool search) jest domyślnie włączone w bieżącej wersji Claude Code. Tylko nazwy narzędzi i pole instruktora serwera ładują się na początku sesji, a pełne schematy JSON (JavaScript object notation) są odraczane do momentu, gdy Claude zacznie ich szukać. Dodanie serwera nie kosztuje już tysięcy tokenów na starcie. Nadal generuje pewien koszt i nadal kosztuje wszystko na starcie w konfiguracjach, w których wyszukiwanie narzędzi jest wyłączone.

WykresStartup and post-use context cost, estimated tokens
Dane, na których opiera się ten wykres
[
  {
    "label": "Rules file, 200 lines",
    "at_startup": "2,500",
    "after_use": "2,500"
  },
  {
    "label": "Skill, 12 KB body",
    "at_startup": 40,
    "after_use": "3,000"
  },
  {
    "label": "MCP server, tool search on",
    "at_startup": 500,
    "after_use": "3,200"
  },
  {
    "label": "MCP server, tool search off",
    "at_startup": "4,500",
    "after_use": "4,500"
  }
]

Są to szacunki, a nie pomiary z Twojej maszyny. Wynikają one z rozmiaru tekstu ładowanego przez każdy mechanizm, przy założeniu około czterech znaków na token: 200-liniowy plik reguł to około 10 KB markdownu, opis umiejętności to około 160 znaków, a serwer udostępniający dwanaście narzędzi zawiera około 18 KB schematu oraz 2 KB bloku instrukcji. Claude Code przycina pole instrukcji serwera oraz opis każdego narzędzia ładowanego na starcie do 4,096 znaków domyślnie, a opis narzędzia ładowanego przez wyszukiwanie narzędzi do 16,384. Przed wersją v2.1.296 krótszy limit wynosił 2,048 znaków, a CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH zastępuje oba limity, jeśli zostanie ustawione. Instrukcje i opisy z niektórych serwerów MCP hostowanych przez Anthropic docierają do Claude w całości, nawet przy ustawionej tej zmiennej, więc limity te nie stanowią uniwersalnego sufitu. Następna sekcja pokazuje, jak odczytać własne rzeczywiste liczby.

Odczytaj pierwsze dwa wiersze razem. Plik reguł kosztuje 2,500 tokenów w sesji, w której nikt go nie potrzebował. Umiejętność kosztuje 40 tokenów w tej samej sesji oraz 3,000 w jednej na dziesięć sesji, w których jest uruchamiana. Ostatnie dwa wiersze to ten sam serwer dwukrotnie, z włączonym i wyłączonym wyszukiwaniem narzędzi: 500 tokenów kontra 4,500. Ta różnica jest powodem, dla którego stare porady dotyczące przepełnienia kontekstu MCP nadal krążą w obiegu.

Od października 2026 r. Claude Code używa wyszukiwania narzędzi w modelach Claude Opus 4, Sonnet 4, Haiku 4.5 i nowszych oraz w Opus 4.5, Sonnet 4.5, Haiku 4.5 i nowszych na platformie Google Cloud Agent Platform. W starszych modelach oraz w wdrożeniach Microsoft Foundry hostowanych na Azure, każde narzędzie MCP ładuje się na starcie, niezależnie od ustawień. Z ANTHROPIC_BASE_URL wskazującym na bramkę LLM, wyszukiwanie narzędzi jest domyślnie włączone od wersji v2.1.304; starsze wersje wyłączały je tam, chyba że użytkownik wyraził zgodę. Od wersji v2.1.305, Claude Code może ponowić żądanie do bramki bez wyszukiwania narzędzi po błędzie 400 lub 422, ładując narzędzia na starcie, gdy ponowienie się powiedzie. Ustaw ENABLE_TOOL_SEARCH, aby kontrolować to zachowanie: false ładuje każdy schemat na starcie, true odracza je z tymi samymi mechanizmami awaryjnymi modelu i wdrożenia, co w przypadku pozostawienia ustawienia domyślnego, a auto ładuje je na starcie, dopóki ich definicje sumarycznie zajmują poniżej 10% okna kontekstowego, a następnie utrzymuje włączone wyszukiwanie narzędzi po osiągnięciu tego progu, nawet jeśli suma później spadnie poniżej tej wartości. Serwer skonfigurowany za pomocą "alwaysLoad": true ładuje swoje narzędzia na starcie, niezależnie od ENABLE_TOOL_SEARCH.

# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claude

Kluczowe pytanie: czy dane zmieniają się między wywołaniami?

Zadaj to pytanie w pierwszej kolejności, ponieważ pozwala ono od razu wyeliminować jedną z opcji. Jeśli agent musi odczytać lub zapisać coś, co może przyjąć inną wartość przy kolejnym sprawdzeniu, wymagany jest serwer. System śledzenia zgłoszeń, baza danych, pulpit nawigacyjny monitoringu, własne wewnętrzne API (application programming interface). Zapisanie tych informacji nie pomaga, ponieważ w momencie, gdy ktoś inny edytuje rekord, zapis staje się nieaktualny. Własna baza kodu również znajduje się na tej liście, ponieważ jej struktura zmienia się z każdym commitem. Jest to powód, dla którego stosuje się udostępnianie agentowi przetworzonej mapy repozytorium przez MCP, zamiast opisywać układ plików w dokumencie, który szybko się starzeje.

Jeśli odpowiedź byłaby poprawna nawet za sześć tygodni, przy założeniu, że nikt jej nie aktualizuje, potrzebujesz umiejętności (skill). Lista kontrolna wydania (release checklist). Procedura migracji. Format odpowiedzi na błędy. Sposób pisania testów w tym repozytorium. Umiejętność to plik w git. Nie posiada portu, procesu ani trybu awarii poza byciem błędnym, co można wykryć podczas przeglądu kodu (code review).

Jeśli jest to pojedynczy fakt, który musi mieć zastosowanie do zadań, o których jeszcze nie pomyślałeś, umieść go w pliku reguł. Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. Po jednej linii na wpis. W momencie, gdy wpis rozrasta się do postaci kroków, przestaje być faktem, a staje się procedurą i powinien zostać przeniesiony do umiejętności.

Kiedy plik reguł jest wystarczający

Pliki reguł są wczytywane z kilku lokalizacji, od najbardziej ogólnych do najbardziej szczegółowych: zarządzanego pliku polityki, osobistego ~/.claude/CLAUDE.md, projektowego ./CLAUDE.md lub ./.claude/CLAUDE.md oraz pliku ./CLAUDE.local.md ignorowanego przez git. Wszystkie wykryte pliki są łączone, a nie nadpisywane, przy czym pliki znajdujące się najbliżej katalogu roboczego są odczytywane jako ostatnie.

Od wersji v2.1.277 Claude Code odczytuje również AGENTS.md, ale domyślnie tylko wtedy, gdy w katalogu roboczym lub powyżej niego nie znajduje się CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md. Jeśli repozytorium zawiera oba rodzaje plików, Claude odczytuje wyłącznie pliki CLAUDE.md, dlatego nie należy utrzymywać dwóch kopii, które mogą się rozbiec.

ln -s AGENTS.md CLAUDE.md

Dowiązanie symboliczne nie zwraca żadnych komunikatów w przypadku powodzenia. Rozpocznij sesję, uruchom /context all i potwierdź, że CLAUDE.md pojawia się w sekcji Memory files. Jeśli nie znajduje się na liście, agent nigdy go nie widział i żadna zmiana treści nie pomoże. Jeśli wymagane są również linie specyficzne dla Claude, należy użyć formy importu i umieścić je poniżej instrukcji importu.

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Istnieje tutaj pewna pułapka. Importy @path nie zapisują kontekstu. Importowany plik jest rozwijany i ładowany podczas uruchamiania wraz z plikiem, który się do niego odwołuje, do czterech poziomów głębokości. Podzielenie 600-liniowego pliku reguł na sześć importów porządkuje go dla ludzi i nie zmienia kosztu tokenów w żadnym stopniu. Warto zapoznać się z konwencjami dotyczącymi AGENTS.md i jego odpowiednika dla ludzi przed ustaleniem układu plików.

Tym, co faktycznie redukuje koszt, jest .claude/rules/ z polem paths. Plik reguł zawierający frontmatter paths ładuje się tylko wtedy, gdy agent uzyskuje dostęp do pliku pasującego do jednego ze wzorców.

---
paths:
  - "src/api/**/*.ts"
---

# API rules

- Every endpoint validates its input.
- Use the standard error response shape.

Reguła bez pola paths ładuje się podczas uruchamiania z tym samym priorytetem co .claude/CLAUDE.md. Dlatego zalecanym schematem pracy jest stosowanie krótkich, bezwarunkowych reguł oraz listy paths dla wszystkiego, co ma znaczenie tylko w obrębie jednego katalogu.

Kiedy potrzebna jest umiejętność

Umiejętność to katalog zawierający plik SKILL.md. Umiejętności osobiste znajdują się w ~/.claude/skills/<name>/SKILL.md i dotyczą każdego projektu na maszynie. Umiejętności projektowe znajdują się w .claude/skills/<name>/SKILL.md, są przenoszone wraz z repozytorium i mogą być sprawdzane w pull requestach, podobnie jak każdy inny plik.

mkdir -p ~/.claude/skills/summarize-changes
---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.

Sekcja description to jedyna część tego pliku, która znajduje się w kontekście przed uruchomieniem umiejętności, dlatego pełni dwie funkcje. Określa, co robi umiejętność oraz kiedy należy z niej skorzystać. Opis o treści "Pomaga przy wdrożeniach" nie dostarcza modelowi żadnych danych do dopasowania żądania, przez co umiejętność nigdy nie zostanie uruchomiona, a użytkownik błędnie uzna, że umiejętności nie działają.

Nazwa katalogu staje się poleceniem, więc powyższy przykład daje /summarize-changes. W umiejętności osobistej lub projektowej nagłówek name, różniący się od nazwy katalogu, ustawia polecenie wyświetlane w menu /, chyba że inne polecenie już używa tej nazwy; nazwa katalogu nadal wywołuje umiejętność.

Po wywołaniu umiejętności jej wyrenderowana zawartość trafia do konwersacji jako pojedyncza wiadomość i pozostaje tam do końca sesji. Claude Code nie odczytuje pliku ponownie w kolejnych turach. Należy pisać instrukcje stałe zamiast kroków jednorazowych i dbać o zwięzłość treści, ponieważ od tego momentu każda linia stanowi powtarzalny koszt przy każdym żądaniu. Po automatycznej kompresji Claude Code ponownie dołącza ostatnie wywołanie każdej umiejętności, utrzymując pierwsze 5000 tokenów każdej z nich w ramach łącznego budżetu 25000 tokenów. Wywołanie kilku dużych umiejętności w jednej sesji spowoduje całkowite usunięcie najstarszych, dlatego umiejętność może przestać działać po długiej konwersacji. Ponowne wywołanie przywraca ją. Umiejętność oparta na rozbudowanych procedurach czyni ten kompromis konkretnym: the unlazy skill and its Depth Tree method zużywa realny kontekst na bramki i plik planu w zamian za agenta, który przestaje przedwcześnie deklarować zakończenie pracy. Gdy ta sama procedura ma zastosowanie do więcej niż jednej bazy kodu, share one skill across several repositories zamiast kopiować plik.

Kiedy potrzebny jest serwer MCP

Dodanie serwera sprowadza się do wykonania jednego polecenia, a jego forma zależy od wybranego transportu.

# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Kluczowe znaczenie ma --. W przypadku serwera stdio oddziela on opcje Claude Code od wiersza poleceń uruchamiającego serwer. Pominięcie tego separatora sprawi, że --port 8080 przeznaczony dla serwera zostanie zinterpretowany jako opcja dla claude mcp add, co spowoduje błąd parsowania.

claude mcp list
claude mcp get notion

claude mcp add potwierdza operację za pomocą linii Added ..., co oznacza jedynie, że konfiguracja została zapisana na dysku. claude mcp list to polecenie, które pozwala zweryfikować stan faktyczny, ponieważ wyświetla status zdrowia obok każdego serwera: ✔ Connected, ! Needs authentication lub ✘ Failed to connect. Status błędu oznacza, że Claude Code nie mógł nawiązać połączenia z serwerem, a nie że polecenie list nie działa. Wewnątrz sesji /mcp udostępnia ten sam widok dla każdego serwera wraz z liczbą dostępnych narzędzi.

Każde wywołanie serwera MCP jest niezależne i zawiera wszystkie niezbędne dane, co wyjaśnia, dlaczego serwer MCP nie przechowuje informacji o poprzednim żądaniu. Jest to założenie projektowe, które niesie ze sobą określone konsekwencje: każdy stan wymagający utrwalenia musi być przechowywany po stronie serwera, w bazie danych lub pliku, co staje się elementem infrastruktury zarządzanej przez użytkownika.

Serwer MCP to proces, który należy uruchomić

Oto koszt, który porównania dostawców pomijają. Skill to plik. Serwer MCP to oprogramowanie działające w określonym miejscu, a gdy tym miejscem jest Twój VPS (virtual private server), odpowiadasz za jego czas pracy (uptime).

Serwer stdio to wariant niskokosztowy. Claude Code uruchamia go jako proces potomny w momencie rozpoczęcia sesji, a proces ten kończy się wraz z jej zakończeniem. Nie ma tu nic do monitorowania ani samodzielnego aktualizowania. Zdalny serwer HTTP to usługa długotrwała, która wymaga tego samego, co każda inna usługa tego typu, począwszy od dedykowanego użytkownika. Utwórz użytkownika mcp, na którego uprawnieniach działa poniższa jednostka, i przydziel mu katalog serwera:

sudo useradd --system --home-dir /srv/notes-mcp --shell /usr/sbin/nologin mcp
sudo chown -R mcp:mcp /srv/notes-mcp
[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target

[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pager

systemctl is-active powinno wypisać active. Jeśli wypisuje failed, dziennik zawiera przyczynę; przy pierwszym uruchomieniu jest to niemal zawsze brakująca zmienna środowiskowa lub port zajęty przez inny proces. Restart=on-failure nie jest tutaj opcjonalne, ponieważ awaria serwera MCP nie jest sygnalizowana w sposób widoczny. Dowiesz się o niej dopiero, gdy agent zgłosi brak dostępu do systemu śledzenia zadań.

Powiąż proces z 127.0.0.1 i umieść przed nim reverse proxy z obsługą TLS (transport layer security). Serwer MCP, który ma dostęp do bazy danych i odpowiada na publicznym porcie bez uwierzytelniania, jest de facto bazą danych wystawioną do sieci. Uruchamianie serwera MCP na VPS opisuje poprawną konfigurację proxy, certyfikatów oraz firewalla.

Następnie rzetelnie oceń nakład pracy związany z utrzymaniem. Usługa wymaga aktualizacji bezpieczeństwa zgodnie z własnym harmonogramem, niezależnie od agenta, który się z nią komunikuje. Token OAuth wygasa, a claude mcp list zaczyna wypisywać ! Needs authentication w najmniej odpowiednim momencie. Dane uwierzytelniające znajdują się w pliku konfiguracyjnym lub nagłówku Authorization, więc wymagają takiej samej ochrony jak każdy inny sekret, co stanowi osobne zagadnienie: ochrona sekretów przed dostępem agenta AI. W przypadku skilla ten nakład pracy nie istnieje.

Przed rozpoczęciem budowy rozważ alternatywę. Jeśli dane obsługiwane przez serwer zmieniają się mniej więcej raz na kwartał, skill informujący agenta, gdzie szukać i co oznaczają poszczególne pola, jest tańszy w utrzymaniu niż usługa, którą musisz stale nadzorować.

Jak zmierzyć koszt własnego kontekstu

Zamiast szacować, należy uruchomić /context all wewnątrz sesji. Polecenie to wyświetla bieżące zestawienie: prompt systemowy, pliki pamięci, narzędzia oraz serwery MCP wraz z wagą tokenów dla każdego z nich.

Należy sprawdzić dwie kwestie. W sekcji Memory files trzeba potwierdzić, czy każdy oczekiwany plik z regułami znajduje się na liście. Brakujący plik jest niewidoczny dla agenta, więc jest to pierwsza rzecz do wykluczenia w przypadku ignorowania instrukcji. Jeśli plik jest na liście, a reguła nadal jest pomijana, przyczyna leży gdzie indziej i warto przeanalizować powody, dla których agent ignoruje widoczną instrukcję, zanim ponownie sformułuje się dany wiersz. Następnie należy sprawdzić koszt serwerów. Jeśli serwer używany dwa razy w miesiącu zajmuje jedną z największych pozycji na liście, należy go wyłączyć w /mcp i włączać tylko na czas sesji, w których jest potrzebny. Konfiguracja zostaje zachowana w obu przypadkach.

Jeśli pamięć podręczna wykrywania (discovery cache) jest włączona dla danego konta, zdalny serwer używany wcześniej może wyświetlać status taki jak cached 2h ago · connects on first use · 5 tools. Oznacza to, że Claude Code odczytał listę narzędzi z poprzedniej sesji zamiast łączyć się przy starcie; połączenie zostanie nawiązane przy pierwszym wywołaniu narzędzia. Narzędzia są dostępne od pierwszej wiadomości, więc nie ma nic do naprawy. Pamięć podręczna jest domyślnie wyłączona, chyba że została włączona w ramach stopniowego wdrażania: należy ustawić MCP_DISCOVERY_CACHE=0, aby wymusić łączenie wszystkich serwerów przy starcie, lub 1, aby włączyć pamięć podręczną. Szerszy opis znajduje się w sekcji zarządzanie oknem kontekstowym Claude Code, która omawia dane przetrwające kompresję, oraz w koszt tokenów w przeliczeniu na walutę, gdzie liczby przekładane są na realne koszty.

Dlaczego moja umiejętność nigdy się nie uruchamia?

Typową przyczyną jest description. Jest to jedyny tekst w kontekście przed uruchomieniem umiejętności, więc jeśli nie określa on sytuacji, nic nie zostanie dopasowane. Należy wpisać wyzwalacz w zdaniu: "Użyj, gdy użytkownik pyta, co się zmieniło, chce uzyskać komunikat commit lub prosi o przejrzenie diffa". Niejasne opisy zawodzą po cichu, co utrudnia ich wykrycie.

Drugą przyczyną jest błąd w literówce w sekcji frontmatter, a w Claude Code ten problem również występuje bez żadnego komunikatu. Nazwa pola musi być zgodna co do znaku, włącznie z myślnikami, a Claude Code ignoruje nierozpoznane pola bez zgłaszania błędu. Wersja z jawnym komunikatem pojawia się dopiero podczas pakowania umiejętności lub przesyłania jej do claude.ai bądź Skills API, które akceptują mniej pól i odrzucają pozostałe:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

Trzecią przyczyną jest lokalizacja. Umiejętności projektowe są ładowane z .claude/skills/ w katalogu roboczym oraz w każdym katalogu nadrzędnym aż do głównego katalogu repozytorium. Umiejętności znajdujące się w podkatalogach poniżej miejsca uruchomienia nie są ładowane przy starcie. Pojawiają się dopiero w momencie, gdy agent odczyta lub edytuje plik wewnątrz tego podkatalogu, więc do tego czasu nie działają w autouzupełnianiu i nie można ich wywołać po nazwie.

Odpowiednikiem tego cichego błędu w MCP jest wpis .mcp.json z url i brakiem type. Claude Code odczytuje każdy wpis bez type jako serwer stdio, więc pomija wpis i zgłasza:

MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry

Łączne wykorzystanie wszystkich trzech mechanizmów

Te mechanizmy nie konkurują o to samo miejsce. Poprawna konfiguracja wykorzystuje każdy z nich tam, gdzie jest to najbardziej efektywne. Plik reguł zawiera kilka linii, które są prawdziwe w każdym przypadku. Umiejętności (skills) przechowują procedury i są ładowane tylko wtedy, gdy mają zastosowanie. Jeden serwer MCP, rzadziej dwa, łączy systemy, których zawartości nie można przewidzieć z wyprzedzeniem. Jeśli budujesz dopiero swój model pojęciowy pierwszego z nich, czym w rzeczywistości jest umiejętność agenta szczegółowo omawia ten format.

Jeden test rozstrzyga większość sporów dotyczących tego, gdzie dany element powinien się znajdować. Usuń go, uruchom nową sesję i zleć agentowi zadanie. Jeśli agent działa jedynie wolniej, oznacza to, że powinien być częścią umiejętności. Jeśli agent jest pewny siebie, ale się myli, powinien znajdować się w pliku reguł. Jeśli agent w ogóle nie może uzyskać informacji, potrzebny był serwer, a teraz potrzebny jest również plan utrzymania tego serwera w działaniu.

FAQ

Czy powinienem napisać skill, czy uruchomić serwer MCP?

Decyzja zależy od tego, czy informacje zmieniają się pomiędzy poszczególnymi wywołaniami. Jeśli agent musi odczytywać bieżący stan, który może być modyfikowany przez inne osoby, na przykład system śledzenia zgłoszeń, bazę danych lub pulpit nawigacyjny, wymagany jest serwer MCP. Każda zapisana informacja staje się nieaktualna w momencie zmiany rekordu. Jeśli odpowiedź można zapisać raz i pozostanie ona poprawna przez sześć tygodni, należy napisać skill. Skill jest plikiem w repozytorium git, który nie wymaga uruchomionego procesu, otwierania portów ani harmonogramu poprawek, dlatego jest tańszym rozwiązaniem, o ile jest możliwe do zastosowania.

Czy serwery MCP nadal zapełniają okno kontekstowe?

W znacznie mniejszym stopniu niż wcześniej. Wyszukiwanie narzędzi jest domyślnie włączone w bieżącej wersji Claude Code, więc przy starcie sesji ładowane są tylko nazwy narzędzi oraz pole instrukcji serwera, natomiast pełne schematy są pobierane dopiero wtedy, gdy Claude ich poszukuje. Dotyczy to obecnie również sesji za bramką LLM skonfigurowaną przez ANTHROPIC_BASE_URL, począwszy od wersji v2.1.304. Ładowanie wstępne nadal występuje w przypadku ENABLE_TOOL_SEARCH=false, dla serwera ustawionego na "alwaysLoad": true, na modelu starszym niż Claude Opus 4 i Sonnet 4 (starszym niż generacja 4.5 na platformie Google Cloud Agent Platform) oraz w wdrożeniach Microsoft Foundry hostowanych na Azure. Uruchom /context all, aby sprawdzić, w jakiej sytuacji się znajdujesz, ponieważ liczby w starszych wpisach porównawczych zakładają ładowanie wstępne.

Czy Claude Code odczytuje plik AGENTS.md?

Tak, od wersji v2.1.277, ale domyślnie tylko wtedy, gdy w katalogu roboczym lub powyżej niego nie ma plików CLAUDE.md, .claude/CLAUDE.md lub CLAUDE.local.md. Jeśli repozytorium zawiera oba typy plików, Claude odczytuje tylko pliki CLAUDE.md, dlatego należy wskazać jeden na drugi zamiast utrzymywać dwie kopie. Uruchom ln -s AGENTS.md CLAUDE.md, aby utworzyć zwykłe dowiązanie symboliczne, lub umieść @AGENTS.md w pierwszej linii pliku CLAUDE.md i dodaj poniżej instrukcje specyficzne dla Claude. Następnie rozpocznij sesję i uruchom /context all, aby potwierdzić, że CLAUDE.md pojawia się w plikach pamięci (Memory files).

Dlaczego mój skill przestał działać w połowie sesji?

Najczęstszą przyczyną jest automatyczna kompresja (auto-compaction). Gdy konwersacja jest podsumowywana, Claude Code ponownie dołącza ostatnie wywołanie każdego skilla, zachowując pierwsze 5 000 tokenów każdego z nich, w ramach łącznego limitu 25 000 tokenów dla wszystkich skilli. Limit ten jest wypełniany począwszy od ostatnio wywołanego skilla, więc jeśli wywołano kilka dużych skilli, te starsze są całkowicie usuwane. Wywołaj skill ponownie, aby przywrócić jego pełną zawartość.

Jak zapobiec ładowaniu długiego pliku reguł w każdej sesji?

Przenieś części, które są istotne tylko czasami, do plików .claude/rules/ z polem paths w nagłówku (frontmatter), dzięki czemu każdy z nich załaduje się tylko wtedy, gdy agent uzyska dostęp do pasującego pliku. Podział pliku na importy @path nie pomaga, ponieważ importowane pliki są rozwijane i ładowane podczas uruchamiania wraz z plikiem, który się do nich odwołuje. Wszystko, co stanowi procedurę wieloetapową, a nie stały fakt, powinno stać się skillem, ponieważ treść skilla nie generuje kosztów, dopóki nie zostanie wywołana.

Czy ten artykuł był przydatny?