Claude Code-serie tutorial 6: Hoe authenticeren - Browser inloggen en handmatig API-sleutel configureren

Authenticatieproces: Browser login en handmatig API-sleutel configureren

Na het installeren van Claude Code moet je nog authenticeren om het te kunnen gebruiken. Je moet de tool koppelen aan je Anthropic-account. Er zijn twee manieren om dit te doen: browser login en handmatig API-sleutel configureren. Beide manieren hebben hetzelfde eindresultaat, kies wat voor jou het handigst is.

Manier 1: Browser login (aanbevolen)

Claude Code biedt een automatisch authenticatiecommando claude login. Het opent een browser, laat je via de webpagina toestemming geven en schrijft vervolgens automatisch de inloggegevens terug naar de terminal.

Stappen:

Voer in de terminal in:

bash claude login

Het systeem toont een melding en opent automatisch de Anthropic-autorisatiepagina in je standaardbrowser.
Als dit niet automatisch gebeurt, wordt er een link in de terminal weergegeven die je handmatig in de browser kunt openen.
Log in op je Anthropic-account in de browser (als je al bent ingelogd, vraagt de pagina direct om toestemming).
Klik op "Toestaan" of "Authoriseren". De browserpagina toont "Autorisatie gelukt, u kunt deze pagina sluiten".
Ga terug naar de terminal. Je ziet een bericht dat de authenticatie is voltooid. Als je nu het claude-commando uitvoert, is het gekoppeld aan je account.

Manier 2: Handmatig API-sleutel configureren

Als je een server zonder grafische interface gebruikt, een container, of geen browserautorisatie wilt doen, kun je direct een API-sleutel ophalen uit de Anthropic-console en deze configureren in Claude Code.

Stappen:

Open een browser en ga naar https://console.anthropic.com. Log in op je Anthropic-account.
Ga naar de API Keys-pagina (meestal onder Instellingen of Ontwikkelaarsopties) en klik op "Create API Key".
Geef de sleutel een naam (bijvoorbeeld claude-code-local) en kopieer deze direct na het genereren.
Let op: deze sleutel wordt maar één keer weergegeven. Sluit je de pagina, dan kun je hem niet meer zien. Als je vergeet hem op te slaan, verwijder dan de oude en genereer een nieuwe.
Ga terug naar de terminal. Er zijn twee manieren om de sleutel aan Claude Code te geven:

A. Omgevingsvariabele:

bash export ANTHROPIC_API_KEY=je-api-sleutel

Voeg deze regel toe aan je ~/.bashrc of ~/.zshrc, zodat hij elke keer automatisch wordt geladen.

B. Configuratie in een bestand:

Claude Code leest ook zijn eigen configuratiebestand. Bewerk handmatig ~/.claude/config.json (maak het aan als het niet bestaat) en schrijf:

json { "apiKey": "jouw-api-sleutel" }

Let op: het is aan te raden om de rechten van dit bestand in te stellen op 600 (chmod 600 ~/.claude/config.json) zodat andere gebruikers het niet kunnen lezen.

Test de verbinding:

bash claude "你好，请回复一个'OK'"

Als je een normaal antwoord ontvangt, is de sleutel correct geconfigureerd.

Veelgemaakte fouten bij handmatige configuratie:

Moet de sleutel niet beginnen met sk-ant- of sk-? Nee, de API-sleutel van Anthropic begint inderdaad met sk-ant-api03- en is een lange tekenreeks. Zorg dat je geen tekens mist bij het kopiëren.
Als je zowel de omgevingsvariabele als het bestand hebt ingesteld, heeft de omgevingsvariabele voorrang. Houd er slechts één om verwarring te voorkomen.
De sleutel is een betalingsbewijs; push deze niet naar een Git-repository. Voeg de hele ~/.claude-map of het configuratiebestand toe aan .gitignore.

Account wisselen of uitloggen

Wil je van account wisselen of de lokale inloggegevens wissen?

Als je claude login hebt gebruikt: voer claude logout uit en daarna opnieuw claude login.
Als je handmatig een sleutel hebt geconfigureerd: verwijder de oude sleutel uit de omgevingsvariabele of het configuratiebestand en vervang deze door de nieuwe sleutel.

Test of authenticatie werkt

claude "解释一下当前目录是做什么的"

Als het je projectoverzicht kan lezen, is de omgeving gereed.