DeutschlandGPT Code im Terminal
Den Coding-Agenten fürs Terminal installieren, am Laptop oder auf einem Server per SSH anmelden, interaktiv oder in Skripten mit -p nutzen
deutschlandgpt-code ist ein Coding-Agent für Ihr Terminal. Er liest und bearbeitet die Dateien des Projekts, in dem Sie ihn starten, führt Befehle aus und arbeitet mit Ihrem DeutschlandGPT-Konto. Anfragen zählen zu Ihren normalen Nutzungslimits, und Sie sehen nur die Modelle, die Ihre Organisation freigibt. Die Befehlszeile folgt der von Claude Code, sodass die meisten Skripte für claude unverändert laufen.
Installieren
# macOS / Linux
curl -fsSL https://dgpt-assets-prod.nbg1.your-objectstorage.com/releases/cli/install.sh | sh
# Windows (PowerShell)
irm https://dgpt-assets-prod.nbg1.your-objectstorage.com/releases/cli/install.ps1 | iex
Mit deutschlandgpt-code update installieren Sie später eine neuere Version.
Anmelden
deutschlandgpt-code login
Der Befehl zeigt einen Link und einen kurzen Code:
On this or any other device, open
https://dialog.deutschlandgpt.de/oauth/device?user_code=BCDF-GHJK
and confirm the code
BCDF-GHJK
- Am Laptop oder Desktop öffnet sich zusätzlich Ihr Browser. Melden Sie sich an, klicken Sie auf Erlauben, und das Terminal macht von selbst weiter.
- Auf einem Server per SSH, in einem Container oder überall ohne Browser öffnen Sie den Link auf einem beliebigen anderen Gerät, auch auf dem Handy. Dort melden Sie sich wie gewohnt an: Passwort, Zwei-Faktor-Authentifizierung, Single Sign-on (SAML, Microsoft, Google). Die Seite zeigt dann, welcher Rechner die Anmeldung angefragt hat, von welcher IP-Adresse und wann. Prüfen Sie, dass der Code mit Ihrem Terminal übereinstimmt, und klicken Sie auf Erlauben. Das Terminal übernimmt die Anmeldung innerhalb weniger Sekunden. Mit
--no-browserwird kein lokaler Browser geöffnet.
Der Code gilt 10 Minuten und nur einmal. Schickt Ihnen jemand einen solchen Link und Sie haben selbst keine Anmeldung gestartet, klicken Sie auf Ablehnen.
Eigene Adresse Ihrer Organisation. Nutzt Ihre Organisation eine eigene Domain (zum Beispiel gpt.example.com), melden Sie sich dort an, damit deren Anmeldeverfahren gilt:
deutschlandgpt-code login --host gpt.example.com
Wo die Anmeldung gespeichert wird. Im Schlüsselbund des Betriebssystems (macOS-Schlüsselbund, Windows-Anmeldeinformationsverwaltung, Secret Service unter Linux-Desktops). Wo es keinen gibt, etwa auf einem Server, liegt sie in ~/.deutschlandgpt/credentials.json, nur für Sie lesbar. Die Anmeldung erneuert sich selbst. Sie endet, wenn Sie sich abmelden oder sie 90 Tage nicht benutzt wurde.
| Befehl | Wirkung |
|---|---|
deutschlandgpt-code status | Konto, Organisation und bis wann sich die Anmeldung erneuert (--json für Skripte) |
deutschlandgpt-code logout | Meldet ab und beendet die Anmeldung auch auf dem Server (--all für alle Konten) |
deutschlandgpt-code auth list | Alle gespeicherten Konten; auth switch <Nummer> wechselt das aktive |
deutschlandgpt-code doctor | Prüft Installation, Verbindung, Anmeldung und Konfiguration |
Das Terminal erscheint unter Einstellungen → Verbundene Apps als DeutschlandGPT Code (CLI). Wenn Sie es dort entfernen, enden alle Anmeldungen der CLI für Ihr Konto.
Steht auf der Anmeldeseite, dass DeutschlandGPT Code für Ihr Konto nicht freigeschaltet ist, kann die Administration Ihrer Organisation es freischalten.
Interaktiv arbeiten
cd mein-projekt
deutschlandgpt-code # starten
deutschlandgpt-code "erkläre den Build" # mit einer ersten Nachricht starten
deutschlandgpt-code -c # die letzte Sitzung in diesem Verzeichnis fortsetzen
deutschlandgpt-code -r # eine frühere Sitzung auswählen
Mit / öffnen Sie die Befehle: /model, /compact, /resume, /usage, /status, /permissions, /memory, /init, /clear, /login, /logout, /help. Shift+Tab wechselt zwischen Nachfragen vor jeder Änderung, Dateiänderungen annehmen, Planmodus (nur lesen) und alles ohne Nachfrage ausführen.
Projektgedächtnis
Anweisungen, die der Agent immer befolgen soll (Build- und Testbefehle, Konventionen), gehören in eine DEUTSCHLANDGPT.md in Ihrem Repository. AGENTS.md und CLAUDE.md werden ebenfalls gelesen, ein schon für einen anderen Coding-Agenten eingerichtetes Repository funktioniert also unverändert. Dateien in Unterverzeichnissen ergänzen die darüber. In ~/.deutschlandgpt/DEUTSCHLANDGPT.md stehen Ihre persönlichen Anweisungen für alle Projekte. /init schreibt eine erste Fassung für das aktuelle Repository.
Skripte und CI: -p
-p führt eine Aufgabe ohne Oberfläche aus und gibt das Ergebnis aus:
deutschlandgpt-code -p "fasse die offenen TODOs zusammen"
git diff | deutschlandgpt-code -p "prüfe diesen Diff auf Fehler"
deutschlandgpt-code -p "repariere den fehlschlagenden Test" --allowedTools "Bash(npm test *)" Edit --output-format json
| Option | Wirkung |
|---|---|
--output-format text | json | stream-json | json: ein Ergebnisobjekt mit result, session_id, is_error, num_turns, usage. stream-json: ein Ereignis pro Zeile |
--input-format stream-json | Liest eine Nutzernachricht pro Zeile von stdin |
-c, -r <id> | Letzte oder bestimmte Sitzung fortsetzen (session_id aus dem JSON-Ergebnis) |
--model <name> | Modell für diesen Lauf, als ID oder eindeutiger Teil des Namens |
--permission-mode <modus> | default, acceptEdits (Dateiänderungen erlaubt), plan (nur lesen), dontAsk, bypassPermissions |
--allowedTools, --disallowedTools | Regeln wie "Bash(git diff *)", Read, Edit, mcp__github |
--add-dir <verzeichnis> | Weitere Verzeichnisse, die der Agent lesen und bearbeiten darf |
--append-system-prompt <text> | Zusätzliche Anweisungen für diesen Lauf |
--max-turns <n> | Hält nach n Schritten an |
--verbose, --debug | Werkzeugaktivität bzw. jede Anfrage auf stderr |
Im -p-Modus kann niemand eine Rückfrage beantworten. Eine Änderung, die Ihre Erlaubnis bräuchte, wird deshalb abgelehnt und in permission_denials aufgeführt. Erlauben Sie sie mit --allowedTools oder --permission-mode.
Exit-Codes: 0 erfolgreich, 1 Aufgabe fehlgeschlagen, --max-turns erreicht oder keine Anmeldung, 2 ungültige Optionen.
MCP-Server
deutschlandgpt-code mcp add context7 -- npx -y @upstash/context7-mcp
deutschlandgpt-code mcp add --transport http --header "Authorization: Bearer …" docs https://example.com/mcp
deutschlandgpt-code mcp list
Mit --scope project landet der Server in der .mcp.json des Repositorys, für alle, die daran arbeiten. Bevor der Agent zum ersten Mal Befehlsserver aus einem Repository startet, fragt er nach.