====== Skill /claude-api v Claude Code ====== //Vytvořeno: **23.9.2026** | Aktualizováno: **~~LASTMOD~~**// ''/claude-api'' je vestavěný skill [[ai:platformy:claude-code:start|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 [[https://x.com/dr_cintas/status/2095231154261516641|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 [[https://x.com/dr_cintas/status/2095216285114327412|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. ===== Co je /claude-api ===== 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 ''. ==== Týdenní limit vs. API účet ==== 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říkazy ===== 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. ===== Rozbor doporučení z příspěvku ===== 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 ==== 1. /effort low ==== ''/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. ==== 2. /claude-api cost-optimize ==== 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. ==== 3. /claude-api prompt-audit ==== 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 ==== 4. /claude-api migrate … claude-fable-5-1 ==== 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. ==== Shrnutí ==== ^ 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é. ===== Zdroje ===== * [[https://x.com/dr_cintas/status/2095231154261516641|dr_cintas – 4 kroky proti vyčerpání kreditů s Fable 5.1 (X)]] * [[https://x.com/dr_cintas/status/2095216285114327412|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