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á:
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é.
claude-api v Claude Code 2.1.280 (SKILL.md, shared/prompt-audit.md, shared/cost-optimization.md)claude --help v Claude Code 2.1.280