Skill /claude-api v Claude Code

Vytvořeno: 23.9.2026 | Aktualizováno: 23.09.2026 09:33

/claude-api je vestavěný skill Claude Code s referencí a pracovními postupy pro vývoj aplikací nad Claude API a Anthropic SDK. Claude Code nepřipojuje k API a nemění jeho vlastní spotřebu. Pomáhá psát, migrovat a zlevňovat kód, který Claude API volá.

Článek vznikl jako rozbor příspěvku na X, který doporučuje čtyři kroky proti vyčerpání týdenních kreditů s modelem Claude Fable 5.1. Na něj navazuje další příspěvek téhož autora; jeho obsah nebyl pro článek dostupný.

Poznámka: Popis vychází z obsahu skillu dodávaného s Claude Code 2.1.280. Obsah vestavěných skillů se mění s verzemi Claude Code.

Claude Code obsahuje několik vestavěných (bundled) skillů. Skill je balík instrukcí a dokumentace, který se načte do kontextu, až když je potřeba. /claude-api pokrývá:

model ID, ceník a limity modelů Claude
parametry Messages API – thinking, effort, streaming, tool use, prompt caching
kódové ukázky pro SDK v Pythonu, TypeScriptu, Javě, Go, Ruby, C# a PHP
Managed Agents, Batches API, Files API a počítání tokenů
průvodce migrací na novější modely

Skill se aktivuje automaticky, když zadání zmiňuje Claude, Anthropic nebo úlohu typu „LLM aplikace“. Ručně se spouští jako /claude-api, konkrétní postup jako /claude-api <podpříkaz>.

Příspěvek míchá dvě různé věci:

	Týdenní limit v Claude Code	API účet vlastní aplikace
Co se počítá	práce agenta v terminálu v rámci předplatného	tokeny, které spotřebuje vlastní program přes API klíč
Čím se ovlivňuje	`/effort`, instrukce načítané do kontextu (`CLAUDE.md`, skilly)	kód aplikace: model, caching, batch, prompty
Týká se ho `/claude-api`	jen nepřímo (`prompt-audit` nad `CLAUDE.md` a skilly)	ano, na to je skill určený

Podpříkaz se spustí, když za /claude-api stojí samotný název podpříkazu. Delší zadání, například migrate this project to claude-fable-5-1, skill zpracuje jako běžný dotaz. Pro migraci ale odkazuje na stejného průvodce (shared/model-migration.md).

Podpříkaz	Co dělá	Průběh
`migrate`	Převede existující kód volající Claude API na novější model: model ID, parametry, které nový model odmítá, a prompty psané pro starý model.	Před první úpravou se zeptá na rozsah (soubory, adresáře) a na cílový model.
`prompt-audit`	Projde prompty, popisy nástrojů, `SKILL.md`, `CLAUDE.md` a instrukce agentů. Hledá zastaralé vzory („cruft“) psané pro starší modely.	Neinteraktivní, předpoklady uvede v reportu. Vrátí report (`soubor:řádek`, vzor, proč je zastaralý, jistota) a navržený diff. Úpravy aplikuje jen na výslovnou žádost.
`cost-optimize`	Hledá, jak zlevnit provoz kódu volajícího Claude API bez ztráty kvality. Nejdřív bezplatné úspory (caching, hygiena vstupních a výstupních tokenů, batch), potom kompromisy (budgety, effort, volba modelu).	Interaktivní. Před každým během, který volá model a stojí peníze, žádá souhlas. „Žádné změny“ je platný výsledek.
`upgrade`	Aktualizuje Anthropic SDK přes hlavní verzi, aktuálně Python `anthropic` 0.x → 1.x.	Nejdřív potvrdí rozsah.
`build-eval`	Postaví sadu testů (eval) pro aplikaci nad Claude.	Rozhovor, schválení vstupů, způsobu hodnocení a ceny.
`hillclimb`	Iterativně vylepšuje aplikaci proti existujícímu evalu.	Schválení plánu a rozpočtu.
`managed-agents-onboard`	Provede založením Managed Agenta – agenta, jehož smyčku i sandbox provozuje Anthropic.	Rozhovor.

Spotřebu tokenů pro cost-optimize skill zjišťuje jedním ze tří způsobů: přes Usage and Cost Admin API (s Admin API klíčem), z logů response.usage aplikace, nebo odhadem z kódu.

Příspěvek doporučuje:

1. Set /effort to low
2. Run /claude-api cost-optimize to find the biggest wastes
3. Run /claude-api prompt-audit to clear old junk
4. Run /claude-api migrate this project to claude-fable-5-1 to update old model ids

/effort je vestavěný příkaz Claude Code („Set effort level for model usage“). Stejnou volbu nabízí přepínač při spuštění:

claude --effort low

Úrovně jsou low, medium, high, xhigh a max. Nižší effort znamená, že model méně přemýšlí a spotřebuje méně tokenů. Jako jediný ze čtyř kroků tedy přímo ovlivňuje týdenní limit.

Dokumentace ve skillu doporučuje low pro jednoduché úlohy a subagenty. Pro kódování a dlouhé agentní úlohy doporučuje high nebo xhigh; xhigh je výchozí úroveň v Claude Code. Trvale nastavené low proto u náročnější práce sníží kvalitu.

Týdenní limit Claude Code neřeší. Optimalizuje API účet aplikace. V projektu bez kódu volajícího Claude API nemá co optimalizovat a samotný běh spotřebuje tokeny.

Nemaže historii konverzace ani kontext. Kontroluje instrukční soubory a navrhuje jejich úpravy. Na limit má vliv nepřímo: průvodce ve skillu uvádí „Skill size is a tax paid on every trigger“ – velikost skillu je daň placená při každém jeho spuštění. Kratší CLAUDE.md a skilly znamenají méně tokenů v každé session.

Rozsah lze zúžit uvedením souboru nebo adresáře v zadání, například:

/claude-api prompt-audit ~/.claude/CLAUDE.md

Přepíše model ID a související parametry ve zdrojovém kódu aplikace. Model, se kterým pracuje samotné Claude Code, tím nezmění.

Podle ceníku ve skillu stojí Claude Fable 5.1 $10 / $50 za milion vstupních / výstupních tokenů, Claude Opus 5 $5 / $25. Migrace aplikace na Fable 5.1 tedy provoz zdraží. Fable 5.1 se navíc v API chová jinak než řada Opus: odmítá například vynucené tool_choice typu any/tool i nastavení budget_tokens. Migrace proto není jen záměna řetězce.

Krok	Vliv na týdenní limit Claude Code
`/effort low`	přímý, za cenu nižší kvality u náročných úloh
`/claude-api cost-optimize`	žádný, týká se API účtu aplikace
`/claude-api prompt-audit`	nepřímý, pokud zkrátí `CLAUDE.md` a skilly
`/claude-api migrate` na Fable 5.1	žádný, API provoz aplikace zdraží

Závěrečné tvrzení příspěvku „You won't have to worry about wasting tokens anymore“ je přehnané.

dr_cintas – 4 kroky proti vyčerpání kreditů s Fable 5.1 (X)
dr_cintas – navazující příspěvek (X)
Obsah vestavěného skillu claude-api v Claude Code 2.1.280 (SKILL.md, shared/prompt-audit.md, shared/cost-optimization.md)
Výstup claude --help v Claude Code 2.1.280