Cline a Roo Code s ColdHost API – AI agent přímo ve VS Code

Cline a jeho fork Roo Code jsou rozšíření pro VS Code, která fungují jako autonomní agent: sami čtou soubory v projektu, navrhují úpravy, spouštějí příkazy v terminálu a postupně plní zadaný úkol. Na rozdíl od klasického chatu tedy AI „pracuje“ ve vašem repozitáři. Obě rozšíření podporují OpenAI-kompatibilní API, takže je snadno propojíte s ColdHost AI.

Co potřebujete

Položka	Hodnota
API Provider	OpenAI Compatible
Base URL	`https://coldhost-ai.cz/v1`
API Key	z Nastavení → API v ColdHost AI
Model ID	`coldhost-glacier` (případně `coldhost-polaris`, `coldhost-frost`)

API čerpá z API kreditu v Kč, nikoli z limitu webového chatu.

Instalace

V panelu Extensions vyhledejte Cline nebo Roo Code a nainstalujte. Z terminálu:

# Cline
code --install-extension saoudrizwan.claude-dev
# Roo Code
code --install-extension RooVeterinaryInc.roo-cline

Obě rozšíření můžete mít nainstalovaná současně, ale pro přehlednost doporučujeme používat jedno.

Nastavení v Cline

Klikněte na ikonu Cline v postranní liště.
Otevřete nastavení (ikona ozubeného kola).
V poli API Provider zvolte OpenAI Compatible.
Vyplňte Base URL: https://coldhost-ai.cz/v1.
Vložte API Key.
Do Model ID napište coldhost-glacier.
Uložte.

Nastavení v Roo Code

Postup je téměř shodný. Roo Code navíc podporuje konfigurační profily – můžete si vytvořit například profil „Glacier“ pro běžnou práci a „Polaris“ pro složité úlohy a mezi nimi rychle přepínat. V každém profilu zvolte provider OpenAI Compatible a vyplňte stejné údaje, jen s jiným Model ID.

Roo Code má také režimy (Code, Architect, Ask, Debug). Pro režim Architect, kde se plánuje struktura řešení, se hodí Polaris; pro samotné psaní kódu Glacier.

Který model zvolit

Agenti posílají modelu hodně kontextu – obsah souborů, výstupy příkazů, historii kroků. Spotřeba je proto výrazně vyšší než v běžném chatu.

Model	Pro agenta
`coldhost-frost`	jednoduché, dobře popsané úkoly; může mít potíže s dlouhými vícekrokovými úlohami
`coldhost-glacier`	doporučená výchozí volba
`coldhost-polaris`	složitý refaktoring, ladění napříč soubory; 3× dražší

Schvalování akcí

Cline i Roo Code se před každou akcí (zápis souboru, spuštění příkazu) ptají na schválení. Obě rozšíření nabízejí auto-approve – automatické schvalování vybraných typů akcí. Doporučení:

Čtení souborů – auto-approve je v pořádku.
Zápis souborů – raději schvalovat ručně, alespoň dokud si nástroj neosaháte.
Spouštění příkazů – schvalovat ručně vždy, zejména u rm, git push, instalace balíčků nebo migrací databáze.

Pracujte v gitovém repozitáři a před větším úkolem si udělejte commit. Pokud agent něco pokazí, vrátíte se jedním příkazem:

git stash        # odložit změny agenta
# nebo
git restore .    # zahodit změny v trackovaných souborech

Jak psát zadání pro agenta

Agent pracuje nejlépe s jasným cílem a kritériem hotovosti:

Přidej do aplikace stránkování seznamu produktů (src/pages/products).
Backend už podporuje parametry ?page a ?limit.
Hotovo je, když `npm test` projde a `npm run lint` nehlásí chyby.
Nepřidávej nové závislosti.

Pomáhá také soubor s pravidly projektu. Cline čte .clinerules, Roo Code .roo/rules/ (případně starší .roorules). Příklad obsahu:

- TypeScript strict, žádné `any`.
- Testy ve Vitest, soubory *.test.ts vedle zdrojového souboru.
- Komentáře a commit zprávy česky.

Hlídání spotřeby

Rozdělte velké úkoly na menší – agent s krátkým kontextem je levnější i přesnější.
Po dokončení úkolu začněte nový task, ať se netáhne stará historie.
Obě rozšíření zobrazují spotřebu tokenů u úlohy; sledujte ji, zejména s Polarisem.

Řešení problémů

401 – neplatný API klíč.
404 – Base URL musí být přesně https://coldhost-ai.cz/v1.
Agent se zacyklí – úlohu zastavte, upřesněte zadání nebo přepněte na coldhost-polaris.

S rozumně nastaveným schvalováním je Cline nebo Roo Code s ColdHost AI silný pomocník, který zvládne i úlohy přes desítky souborů.