Authentifizierung

Claude Code unterstützt mehrere Authentifizierungsverfahren.

• OAuth-Login über z.B. einen Max-/Pro-Account
• Nutzung eines API-Keys eines Console-Accounts

Je nach Verfahren unterscheidet sich das Abrechnungsmodell — Flatrate über das bestehende Abo eines Max-/Pro-Accounts oder tokenbasierte Abrechnung bei API-Nutzung.

Voraussetzungen: ai- oder ai-agent-Container läuft

1. Shell im AI-Container öffnen:

docker compose -f .devcontainer/compose.yml exec ai bash

2. Claude Code starten:

claude

3. Claude Code Login Methode wählen:

Claude Code can be used with your Claude subscription or billed based on API usage through your Console account.

Select login method:

❯ 1. Claude account with subscription · Pro, Max, Team, or Enterprise
...

4. Login-URL kopieren:

Browser didn't open? Use the url below to sign in (c to copy)
...

5. URL im Browser auf dem Host-System öffnen. Falls man bereits mit dem Max-/Pro-Account bei claude.ai eingeloggt ist, wird die Autorisierungsseite direkt angezeigt. Andernfalls zuerst einloggen.

6. Generierten Token kopieren und einfügen.

7. Claude Code erkennt die erfolgreiche Autorisierung und ist einsatzbereit.

Alternativ zum OAuth-Login-Flow kann Claude Code auch über einen API-Key authentifiziert werden. Dazu kann ANTHROPIC_API_KEY als Umgebungsvariable im Container gesetzt werden.

Claude Code erkennt die Variable automatisch und überspringt den interaktiven Login.

Dieser Ansatz wird in dieser Guideline nicht weiter verfolgt, da API-Keys über die Claude Platform verwaltet werden und tokenbasiert abgerechnet werden (Pay-as-you-go).