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.
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.98oder 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.98oder 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_FOUNDRYANTHROPIC_FOUNDRY_RESOURCEANTHROPIC_FOUNDRY_API_KEYANTHROPIC_MODEL
Wenn Bereitstellungen verfügbar sind, kann die Datei auch die Opus-, Sonnet- und Haiku-Bezeichnungen über folgende Variablen festlegen:
ANTHROPIC_DEFAULT_SONNET_MODELANTHROPIC_DEFAULT_HAIKU_MODELANTHROPIC_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.
- Microsoft-Referenz: Claude Code für Microsoft Foundry konfigurieren
- Claude-Konfiguration: Claude-Konfigurationsverzeichnis
- Modellkonfiguration: Claude-Modellkonfiguration
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:
Auf Windows:
- Verwenden Sie Git Bash oder WSL2; PowerShell und
cmd.exesind nicht die empfohlenen Standardlaufzeiten für Claude Code - In VS Code setzen Sie
Terminal > Integriert > Standardprofil: WindowsaufGit 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.disableLoginPromptund den Speicherort von~/.claude/settings.json. - Falls erforderlich, aktivieren Sie
Claude Code: Terminal verwendenund starten Sie Claude aus dem integrierten Terminal. - Einrichtung: Claude Code in VS Code
5. Beispiel settings.json
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_MODELANTHROPIC_DEFAULT_HAIKU_MODELANTHROPIC_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.disableLoginPromptist in VS Code aktiviert~/.claude/settings.jsonbefindet 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:
Unter macOS wird auch Homebrew unterstützt:
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_FOUNDRYANTHROPIC_FOUNDRY_RESOURCEoderANTHROPIC_FOUNDRY_BASE_URLANTHROPIC_FOUNDRY_API_KEYANTHROPIC_MODEL
Optionale Bereitstellungsalias können ebenfalls definiert werden:
ANTHROPIC_DEFAULT_SONNET_MODELANTHROPIC_DEFAULT_HAIKU_MODELANTHROPIC_DEFAULT_OPUS_MODEL
3. Beispiel settings.json
4. CLI starten
Öffnen Sie ein Terminal in Ihrem Projektverzeichnis und führen Sie aus:
Claude Code startet dann eine interaktive Terminal-Sitzung mit Zugriff auf Ihre konfigurierte Foundry-Bereitstellung.
Nützliche Befehle:
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_FOUNDRYist auf1gesetzt- der Ressourcenname oder die Basis-URL ist korrekt
- der API-Schlüssel ist gültig
- der Bereitstellungsname in
ANTHROPIC_MODELexistiert 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: