Claude Code série tutoriálů 6: Jak se autentizovat – přihlášení přes prohlížeč a ruční konfigurace API klíče

Autentizační proces: Přihlášení přes prohlížeč a ruční konfigurace API klíče

Po instalaci Claude Code je třeba provést autentizaci, abyste jej mohli používat. Musíte nástroj propojit se svým účtem Anthropic. Existují dva způsoby: přihlášení přes prohlížeč a ruční konfigurace API klíče. Oba způsoby vedou ke stejnému výsledku, vyberte si ten, který vám vyhovuje.

Způsob 1: Přihlášení přes prohlížeč (doporučeno)

Claude Code poskytuje příkaz pro automatickou autentizaci claude login, který otevře prohlížeč, umožní vám autorizovat na webové stránce a poté automaticky zapíše přihlašovací údaje zpět do terminálu.

Postup:

1. V terminálu zadejte:

bash claude login

1. Systém zobrazí řadu pokynů a automaticky otevře autorizační stránku Anthropicu ve vašem výchozím prohlížeči.
   Pokud se neotevře automaticky, na terminálu se vytiskne odkaz, který můžete ručně zkopírovat do prohlížeče.

2. V prohlížeči se přihlaste ke svému účtu Anthropic (pokud jste již přihlášeni, stránka přímo požádá o autorizaci).

3. Klikněte na „Povolit“ nebo „Autorizovat“, stránka prohlížeče zobrazí „Autorizace úspěšná, můžete tuto stránku zavřít“.

4. Vraťte se do terminálu, uvidíte oznámení o dokončení autentizace. Nyní když spustíte příkaz claude, je již propojen s vaším účtem.

Způsob 2: Ruční konfigurace API klíče

Pokud používáte server bez grafického rozhraní, kontejner, nebo nechcete provádět autorizaci přes prohlížeč, můžete získat API klíč přímo z konzole Anthropic a poté jej nakonfigurovat v Claude Code.

Postup:

1. Otevřete prohlížeč, přejděte na https://console.anthropic.com a přihlaste se ke svému účtu Anthropic.

2. Přejděte na stránku API Keys (obvykle v nastavení nebo možnostech pro vývojáře), klikněte na „Vytvořit API klíč“.

3. Pojmenujte klíč (např. claude-code-local), po vygenerování jej okamžitě zkopírujte.
   Poznámka: Tento klíč se zobrazí pouze jednou, po zavření stránky jej neuvidíte. Pokud jej zapomenete uložit, smažte starý a vygenerujte nový.

4. Vraťte se do terminálu, existují dva způsoby, jak klíč předat Claude Code:

A. Metoda proměnných prostředí:

bash export ANTHROPIC_API_KEY=svůj-api-klíč

Přidejte tento řádek do souboru ~/.bashrc nebo ~/.zshrc, aby se automaticky použil při každém spuštění.

B. Konfigurace zápisem do souboru:

Claude Code také čte svůj vlastní konfigurační soubor. Ručně upravte ~/.claude/config.json (pokud neexistuje, vytvořte jej) a vložte:

json { "apiKey": "svůj-api-klíč" }

Poznámka: Doporučuje se nastavit oprávnění souboru na 600 (chmod 600 ~/.claude/config.json), aby jej nemohli číst ostatní uživatelé.

1. Otestujte připojení:

bash claude "Ahoj, odpověz prosím 'OK'"

Pokud obdržíte normální odpověď, klíč je správně nakonfigurován.

Časté chyby při ruční konfiguraci:

• Klíč by neměl začínat na sk-ant- nebo sk-? Ne, API klíč Anthropicu skutečně začíná na sk-ant-api03- a je to dlouhý řetězec. Při kopírování nezapomeňte žádný znak.
• Pokud nastavíte jak proměnnou prostředí, tak soubor, proměnná prostředí má vyšší prioritu. Ponechte pouze jeden způsob, abyste předešli zmatkům.
• Klíč je platební údaj, neodesílejte jej do repozitáře Git. Doporučuje se pomocí .gitignore ignorovat celý adresář ~/.claude nebo konfigurační soubor.

Přepnutí účtu nebo odhlášení

Chcete-li změnit účet nebo odstranit místní přihlašovací údaje:

• Pokud jste použili claude login: spusťte claude logout a poté znovu claude login.
• Pokud jste ručně nakonfigurovali klíč: smažte starý klíč z proměnné prostředí nebo konfiguračního souboru a nahraďte jej novým.

Otestování, zda autentizace funguje

claude "Vysvětli, k čemu slouží aktuální adresář"

Pokud dokáže přečíst přehled vašeho projektu, prostředí je připraveno.