Přeskočit na obsah
AI Coding Crash Course v2

Lekce 01.4: Instalace Antigravity (`agy`) a Claude Code (Installing Your Agent Harness)

⏱️ 3 min čtení • Lekce 01.4

🧠 Mentální model & teoretický rozbor

Autonomní kódovací CLI harness představuje zásadní posun od pasivních rozšíření editoru:

TRADIČNÍ EXTENSION V IDE (PASIVNÍ REŽIM):
Editor ──> Chat panel ──> Navrhne kód ──> Vývojář kliká "Accept" ──> Vývojář ručně spouští testy v terminálu


AUTONOMNÍ CLI HARNESS (ANTIGRAVITY `agy` / CLAUDE CODE `claude`):
Terminál ──> Agent čte repozitář ──> Sám provede editaci ──> Sám spustí test ──> Detekuje selhání ──> Opraví kód

Harness disponuje sadou systémových nástrojů:

  • ViewFile: Zobrazení obsahu souboru s přesnými čísly řádků.
  • EditFile / Replace: Deterministické nahrazení konkrétního bloku kódu (patch na disku).
  • Bash: Spuštění libovolného příkazu v shellu (např. npx vitest run, tsc --noEmit).
  • GlobTool / GrepSearch: Rychlé vyhledávání souborů a textu podle vzorů.

💻 Instalace a nastavení v praxi

1. Primární volba: Google Antigravity CLI (agy)

Antigravity CLI je oficiální nástroj pro vývoj s modely Gemini.

Terminál
# 1. Ověření instalace a verze Antigravity CLI
agy --version


# 2. Zobrazení všech dostupných přepínačů a možností
agy --help


# 3. Spuštění sezení v adresáři projektu
cd ~/projects/my-web-app
agy

Při prvním spuštění proběhne jednorázové přihlášení přes účet Google v prohlížeči nebo načtení proměnné GEMINI_API_KEY.

2. Alternativní volba: Anthropic Claude Code (claude)

Claude Code je terminálový harness postavený kolem modelů Claude Sonnet a Haiku.

A. Oficiální doporučený způsob: Nativní instalátor

Nevyžaduje Node.js, eliminuje chyby oprávnění EACCES a obsahuje automatické aktualizace na pozadí.

Terminál
# macOS a Linux
curl -fsSL https://claude.ai/install.sh | bash


# Windows (PowerShell spuštěný jako uživatel)
irm https://claude.ai/install.ps1 | iex

B. Alternativa přes npm (pokud preferujete správu přes Node.js runtime):

Terminál
# Vyžaduje Node.js 18+
npm install -g @anthropic-ai/claude-code


# Ověření instalace
claude --version

⚠️ Analýza selhání & Anti-patterns

Chyba: Spuštění harnessu v domovském adresáři (~)

Pokud spustíte agy nebo claude přímo v ~ nebo v kořenu disku:

  • Agent začne indexovat celou vaši domovskou složku (Dokumenty, Stažené soubory, systémové konfigurace).
  • Bleskově vyčerpá paměť a selže na vyhledávacích nástrojích.
  • Železné pravidlo: VŽDY přejděte do konkrétního adresáře daného projektu před spuštěním agenta (cd ~/projects/my-app && agy)!

🛠️ Inženýrský postup krok za krokem (Playbook)

  1. Vytvořte si čistý cvičný adresář: mkdir -p ~/ai-sandbox && cd ~/ai-sandbox.
  2. Spusťte agy (nebo claude).
  3. Zadejte testovací příkaz: „Vytvoř soubor hello.txt s textem Real Engineering.“
  4. Zkontrolujte, že soubor na disku skutečně vznikl: cat hello.txt.
  5. Ukončete sezení klávesovou zkratkou Ctrl+D Ctrl+D (v agy) nebo /exit.

🧪 Praktické cvičení (Hands-on Lab)

Úkol:

Ověřte funkčnost kódovacího harnessu a prozkoumejte dostupné nástroje.

Kroky:

  1. Spusťte agy v terminálu.
  2. Zadejte příkaz /help a projděte si dostupné vestavěné příkazy.
  3. Vyzkoušejte klávesovou zkratku Ctrl + C pro bezpečné přerušení právě běžící odpovědi.
  4. Ukončete sezení a ověřte, že terminál je v čistém stavu.