Claude Code

Claude Code kann mit dem kommerziellen Modellangebot von GWDG über Microsoft Foundry genutzt werden.

Info

Claude Code kann auch auf die Modelle auf der HPC-Infrastruktur von GWDG mit nur einem SAIA-API-Schlüssel verweisen, ohne ein Anthropic-Konto oder einen kommerziellen Endpunkt zu benötigen.
Für diese Einrichtung siehe CoCo AI – Claude Code.

Wählen Sie eine Einrichtung:

Was Sie für VS Code benötigen

  • einen kommerziellen Endpunkt oder Ressourcennamen und API-Schlüssel von support@gwdg.de
  • den Namen der Claude-Deployment, die standardmäßig verwendet werden soll
  • Visual Studio Code 1.98 oder neuer
  • die Claude Code-Erweiterung aus dem VS Code-Markt

Claude für Visual Studio Code

1. Installieren der VS Code-Erweiterung

  • Im VS Code-Markt installieren Sie Claude Code von Anthropic.
  • Voraussetzung: VS Code 1.98 oder neuer.
  • Dokumentation der Erweiterung: Claude Code in VS Code

2. Foundry-Zugriff in Claude Code konfigurieren

Während des Onboardings erhalten Sie möglicherweise eine vorbereitete settings.json von GWDG.
Falls nicht, erstellen Sie die Datei manuell mit der gleichen Struktur wie unten gezeigt.

Speichern Sie sie unter:

  • Windows: %USERPROFILE%\.claude\settings.json
  • macOS: ~/.claude/settings.json
  • Linux: ~/.claude/settings.json

Die Datei wird in Ihrem Benutzerprofil gespeichert, sodass CLI und VS Code-Erweiterung die gleiche Claude-Konfiguration verwenden.

Die Datei konfiguriert die erforderlichen Foundry-Variablen:

  • CLAUDE_CODE_USE_FOUNDRY
  • ANTHROPIC_FOUNDRY_RESOURCE
  • ANTHROPIC_FOUNDRY_API_KEY
  • ANTHROPIC_MODEL

Wenn Bereitstellungen verfügbar sind, kann die Datei auch die Opus-, Sonnet- und Haiku-Bezeichnungen über folgende Variablen festlegen:

  • ANTHROPIC_DEFAULT_SONNET_MODEL
  • ANTHROPIC_DEFAULT_HAIKU_MODEL
  • ANTHROPIC_DEFAULT_OPUS_MODEL

Verwenden Sie die exakten Werte, die Sie von GWDG erhalten haben.
Wenn Sie einen Ressourcennamen erhalten haben, verwenden Sie ANTHROPIC_FOUNDRY_RESOURCE.
Wenn Sie stattdessen eine vollständige Basis-URL erhalten haben, verwenden Sie ANTHROPIC_FOUNDRY_BASE_URL.

3. VS Code für den Modus mit Drittanbieter-Anbietern vorbereiten

Um den Anthropic-Anmeldeprompt zu vermeiden, aktivieren Sie die Benutzereinstellung Claude Code: Anmeldeprompt deaktivieren.

Sie können die VS Code-Benutzereinstellungsdatei auch direkt bearbeiten:

  • Windows: %APPDATA%\Code\User\settings.json
  • macOS: ~/Library/Application Support/Code/User/settings.json
  • Linux: ~/.config/Code/User/settings.json

Fügen Sie hinzu:

{
  "claudeCode.disableLoginPrompt": true
}

Auf Windows:

  • Verwenden Sie Git Bash oder WSL2; PowerShell und cmd.exe sind nicht die empfohlenen Standardlaufzeiten für Claude Code
  • In VS Code setzen Sie Terminal > Integriert > Standardprofil: Windows auf Git Bash, wenn möglich
  • Oder führen Sie VS Code direkt innerhalb einer WSL-Sitzung aus

4. Claude Code in VS Code starten

  • Schließen Sie alle VS Code-Fenster vollständig und öffnen Sie VS Code erneut.
  • Öffnen Sie ein Projektverzeichnis.
  • Öffnen Sie die Claude-Leiste und starten Sie eine Sitzung.
  • Wenn Claude weiterhin nach einem Anthropic-Anmeldeaccount fragt, überprüfen Sie zunächst claudeCode.disableLoginPrompt und den Speicherort von ~/.claude/settings.json.
  • Falls erforderlich, aktivieren Sie Claude Code: Terminal verwenden und starten Sie Claude aus dem integrierten Terminal.
  • Einrichtung: Claude Code in VS Code

5. Beispiel settings.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "CLAUDE_CODE_USE_FOUNDRY": "1",
    "ANTHROPIC_FOUNDRY_RESOURCE": "<ihr-Ressourcenname>",
    "ANTHROPIC_FOUNDRY_API_KEY": "<ihr-API-Schlüssel>",
    "ANTHROPIC_MODEL": "<ihr-Standard-Bereitstellungsname>"
  }
}

Wenn Ihre Einrichtung separate Aliase für Sonnet und Opus enthält, können Sie zusätzlich die folgenden Variablen in derselben Datei definieren:

  • ANTHROPIC_DEFAULT_SONNET_MODEL
  • ANTHROPIC_DEFAULT_HAIKU_MODEL
  • ANTHROPIC_DEFAULT_OPUS_MODEL

6. Berechtigungen und Sicherheit

Claude Code fordert je nach gewähltem Berechtigungsmodus Genehmigungen an.
Geben Sie nur die Berechtigungen für die aktuelle Aufgabe frei.

Sicherheit und Berechtigungen:

Hinweis

KI-Modelle können Halluzinationen erzeugen und falsche Informationen generieren.
Überprüfen Sie generierte Ergebnisse immer kritisch, bevor Sie sie verwenden oder verarbeiten.

Fehlerbehebung

Wenn Claude Code mit Microsoft Foundry nicht korrekt startet, überprüfen Sie zunächst Folgendes:

  • claudeCode.disableLoginPrompt ist in VS Code aktiviert
  • ~/.claude/settings.json befindet sich im richtigen Benutzerordner
  • der Foundry-Ressourcenname, API-Schlüssel und Bereitstellungsnamen sind korrekt
  • auf Windows verwendet VS Code Git Bash oder WSL anstelle von PowerShell oder cmd.exe

Dokumentation

Was Sie für die CLI benötigen

  • einen kommerziellen Endpunkt oder Ressourcennamen und API-Schlüssel von support@gwdg.de
  • den Namen der Claude-Deployment, die standardmäßig verwendet werden soll
  • eine lokale Terminal-Umgebung

Claude Code CLI

1. CLI installieren

Installieren Sie Claude Code unter macOS, Linux, Git Bash oder WSL:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Unter macOS wird auch Homebrew unterstützt:

brew install --cask claude-code
claude --version

Offizielle Dokumentation:

2. Foundry-Zugriff für die CLI konfigurieren

Die Claude Code CLI verwendet settings.json im .claude-Verzeichnis in Ihrem Heimatordner:

  • Windows: %USERPROFILE%\.claude\settings.json
  • macOS: ~/.claude/settings.json
  • Linux: ~/.claude/settings.json

Für Microsoft Foundry stellen Sie sicher, dass die Datei die erforderlichen Variablen enthält:

  • CLAUDE_CODE_USE_FOUNDRY
  • ANTHROPIC_FOUNDRY_RESOURCE oder ANTHROPIC_FOUNDRY_BASE_URL
  • ANTHROPIC_FOUNDRY_API_KEY
  • ANTHROPIC_MODEL

Optionale Bereitstellungsalias können ebenfalls definiert werden:

  • ANTHROPIC_DEFAULT_SONNET_MODEL
  • ANTHROPIC_DEFAULT_HAIKU_MODEL
  • ANTHROPIC_DEFAULT_OPUS_MODEL

3. Beispiel settings.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "CLAUDE_CODE_USE_FOUNDRY": "1",
    "ANTHROPIC_FOUNDRY_RESOURCE": "<ihr-Ressourcenname>",
    "ANTHROPIC_FOUNDRY_API_KEY": "<ihr-API-Schlüssel>",
    "ANTHROPIC_MODEL": "<ihr-Standard-Bereitstellungsname>"
  }
}

4. CLI starten

Öffnen Sie ein Terminal in Ihrem Projektverzeichnis und führen Sie aus:

claude

Claude Code startet dann eine interaktive Terminal-Sitzung mit Zugriff auf Ihre konfigurierte Foundry-Bereitstellung.

Nützliche Befehle:

claude
claude "erklären Sie dieses Repository"
claude -c

5. Windows-Hinweise

Auf Windows ist Git Bash oder WSL2 die empfohlene Laufzeitumgebung für Claude Code.
PowerShell und cmd.exe sind nicht die bevorzugten Standardumgebungen für den täglichen Gebrauch von Claude Code.

6. Berechtigungen und Sicherheit

Die Claude Code CLI fordert je nach gewähltem Berechtigungsmodus Genehmigungen an.
Geben Sie nur die Berechtigungen für die aktuelle Aufgabe frei.

Hinweis

KI-Modelle können Halluzinationen erzeugen und falsche Informationen generieren.
Überprüfen Sie generierte Ergebnisse immer kritisch, bevor Sie sie verwenden oder verarbeiten.

Fehlerbehebung

Wenn die CLI Microsoft Foundry nicht wie erwartet verwendet, überprüfen Sie zunächst Folgendes:

  • CLAUDE_CODE_USE_FOUNDRY ist auf 1 gesetzt
  • der Ressourcenname oder die Basis-URL ist korrekt
  • der API-Schlüssel ist gültig
  • der Bereitstellungsname in ANTHROPIC_MODEL existiert in Ihrer Foundry-Ressource
  • auf Windows führen Sie die CLI aus Git Bash oder WSL aus

Dokumentation

Weitere KI-Dienste

Neben Azure OpenAI bieten wir auch andere KI-Dienste an.
Eine Übersicht über alle verfügbaren KI-Dienste finden Sie hier: