Agenter Coding
Agenter Coding geht über Chat und Inline-Vorschläge hinaus.
Diese Werkzeuge nutzen die Fähigkeit des Modells, mehrstufige Aufgaben autonom abzuschließen.
Das Modell kann Ihre Codebasis lesen, Dateien bearbeiten und Terminalbefehle ausführen.
Info
Vergleich mit kommerziellen Modellen: Die Seite Kommerzielle Modelle – Agenter Coding beschreibt agente Coding-Workflows mit externen Anbietern wie Codex und Claude Code.
OpenCode und Claude Code unterstützen sowohl kommerzielle API-Schlüssel als auch einen SAIA-API-Schlüssel; die nachfolgenden Abschnitte beschreiben die SAIA-Einrichtung für beide.
Die unten beschriebenen Werkzeuge bieten vergleichbare agente Coding-Funktionen mit Ihrem SAIA-API-Schlüssel und Modellen, die auf der HPC-Infrastruktur von GWDG gehostet werden.
Dies ermöglicht es Nutzern, von modernen Code-Assistenten zu profitieren, während die Datenverarbeitung innerhalb der Infrastruktur des Instituts bleibt und so Datenschutz, Compliance und Vertraulichkeit gewährleistet werden.
Für viele Forschungs- und Verwaltungsaufgaben stellt dies eine praktische Alternative zu externen KI-Diensten dar, ohne die Kernfunktionen des agenten Coding zu opfern.
Um die internen Modelle, die auf unserer Plattform gehostet werden, mit den unten genannten Werkzeugen zu nutzen, benötigen Sie einen SAIA-API-Schlüssel.
Falls Sie noch keinen besitzen, verweisen Sie auf SAIA-API-Schlüssel, um einen zu beantragen.
Externe Modelle sind nicht über die API verfügbar.
Inhaltsverzeichnis
Modellauswahl
Für agente Coding-Aufgaben empfehlen wir, mit Modellen zu beginnen, die agente Fähigkeiten besitzen. Sie können aus der vollständigen Liste der verfügbaren Modelle auswählen.
Suchen Sie nach Modellen, die für folgendes optimiert sind:
- Agenter Coding: Mehrdatei-Bearbeitung, Codebasis-Exploration
- Werkzeugnutzung: Terminalbefehle, Web-Browsing, API-Interaktionen
- Schlussfolgerung: Komplexes Problemlösen und Planung
Beim Auswahl eines Modells prüfen Sie, ob es in den Vorteilen oder der Beschreibung auf agente Aufgaben oder allgemeine Leistung verweist.
Für komplexe agente Workflows empfehlen wir Modelle mit größeren Kontextfenstern (200K+ Tokens), um umfangreiche Codebasen und längere Prompts effektiv verarbeiten zu können.
Tipp
Für agente Coding-Aufgaben empfehlen wir, mit devstral-2-123b-instruct-2512 oder qwen3-coder-30b-a3b-instruct zu beginnen. Beide sind spezialisierte Code-Agent-Modelle.glm-4.7 ist ein allgemeines agentes Modell mit starker Codierungs-, Werkzeugnutzungs-, Terminal- und Web-Browsing-Fähigkeit.
Continue (Agentenmodus)
Continue ist primär ein Werkzeug zur Code-Vervollständigung und zum Chat – siehe den Abschnitt Code-Vervollständigung für die vollständige Einrichtung und Installation.
Zusätzlich zu der Code-Vervollständigung unterstützt Continue auch agente Workflows über seinen integrierten Agentenmodus, in dem das Modell autonom Dateien lesen, Änderungen vornehmen und mehrstufige Aufgaben abschließen kann.
Um Continue für agente Aufgaben zu nutzen:
- Öffnen Sie das Continue-Fenster in VS Code
- Wechseln Sie im Continue-Fenster den Modus-Dropdown von Chat auf Agent
- Senden Sie eine Aufgabe, z. B. bitten Sie es, eine Funktion zu refaktorisieren oder Fehlerbehandlung hinzuzufügen.
Continue schlägt die Änderungen vor und bittet Sie, sie zu akzeptieren oder abzulehnen.
Anmerkung
Für vollständig autonome agente Workflows mit erweitertem Werkzeuggebrauch funktioniert OpenCode besonders gut mit SAIA-API-Schlüsseln.
OpenCode
OpenCode ist ein Open-Source, terminal-first AI-Code-Agent, der Entwicklern ermöglicht, Code zu generieren, Dateien zu bearbeiten, Befehle auszuführen und Entwicklungsprozesse direkt aus dem Terminal zu automatisieren.
OpenCode unterstützt sowohl selbstgehostete als auch kommerzielle KI-Modelle über Provider-API-Schlüssel und ist daher für Teams und Entwickler geeignet, die state-of-the-art-Modelle nutzen möchten, während sie einen terminalzentrierten Workflow beibehalten.
Sein Design ist besonders gut für SSH-Sitzungen, entfernte HPC-Umgebungen, CI/CD-Pipelines und tastaturbasierte Entwicklungsumgebungen geeignet.
Dieser Abschnitt erklärt, wie Sie OpenCode mit Ihrem SAIA-API-Schlüssel konfigurieren.
Für kommerzielle Modelle siehe die Anleitung für kommerzielle Modelle.
Tipp
Für die lokale Entwicklung empfehlen wir, OpenCode in einem gesicherten Container auszuführen, damit der Agent nur auf Ihr aktuelles Projekt zugreifen und nichts anderes auf Ihrem System beeinflussen kann.
Die unten beschriebenen Schritte installieren OpenCode direkt auf Ihrem Gerät; für die gesicherte Container-Einrichtung siehe OpenCode in einem gesicherten Container am Ende dieses Abschnitts.
Installation
Nach der Installation fügen Sie OpenCode zu Ihrem PATH hinzu:
Öffnen Sie ein neues Terminal und überprüfen Sie die Installation:
Setzen Sie Ihren API-Schlüssel
Legen Sie Ihren SAIA-API-Schlüssel als Umgebungsvariable fest:
Führen Sie source ~/.bashrc aus oder öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
Erstellen der Projekt-Konfiguration
Erstellen Sie opencode.json im Projektverzeichnis:
Sie können opencode.json anpassen, um ein beliebiges Modell Ihrer Wahl auszuwählen, und sicherstellen, dass die Modell-ID genau mit den verfügbaren SAIA-Modellen übereinstimmt.
Starten
Modelle
| Befehl | Aktion |
|---|---|
/models | Öffnet den Modellauswähler, um zwischen SAIA-Modellen zu wechseln |
Tipp
Wenn Modelle nicht angezeigt werden, öffnen Sie ein neues Terminal, damit SAIA_API_KEY geladen wird, und überprüfen Sie, ob es gesetzt ist (echo $SAIA_API_KEY).
Wenn Sie OpenCode im VS Code-Terminal ausführen, laden Sie die Fenster neu (oder starten Sie VS Code neu), damit es die Variable erkennt.
Modi
- Plan-Modus: Erstellen strukturierter Pläne für komplexe mehrstufige Aufgaben, Überprüfen und Anpassen der Schritte vor der Ausführung
- Build-Modus: Ausführen genehmigter Pläne, Ausführen von Automatisierungen und Erstellen von Workflows
Grundbefehle
| Befehl | Aktion |
|---|---|
/help | Zeigt verfügbare Befehle an |
| Shift + Tab | Wechselt zwischen Plan- und Build-Modus |
Hinzufügen von Kontext
| Eingabe | Aktion |
|---|---|
@ | Dateiauswahl, um eine bestimmte Datei als Kontext hinzuzufügen |
@dateiname | Direkte Referenz auf eine Datei durch Namen |
Während einer Aufgabe
| Taste | Aktion |
|---|---|
| Y oder Enter | Akzeptieren einer vorgeschlagenen Dateiänderung |
| N | Ablehnen einer vorgeschlagenen Dateiänderung |
| A | Alle vorgeschlagenen Änderungen auf einmal akzeptieren |
Weitere Informationen finden Sie in der offiziellen Dokumentation.
OpenCode in VS Code
Wenn Sie lieber in Ihrem Editor bleiben möchten, läuft die OpenCode-Extension den gleichen OpenCode-Agenten.
Sie verwendet dieselbe opencode.json und SAIA-Konfiguration wie oben beschrieben, sodass keine zusätzliche Einrichtung erforderlich ist.
- Öffnen Sie die Extensions-Ansicht ( Strg + Shift + X unter Linux, Cmd + Shift + X unter macOS).
- Suchen Sie nach OpenCode und installieren Sie es.
- Starten Sie VS Code neu. OpenCode öffnet sich in einem Panel neben Ihrem Editor, wo Sie Aufgaben genauso wie im Terminal ausführen können.
Optional: SAIA-Modell-Plugin
Anstatt Modelle manuell in opencode.json aufzulisten, können Sie ein Plugin installieren, das Ihre SAIA-Modellliste automatisch aktuell hält.
Beim Start von OpenCode holt es im Hintergrund die aktuelle Modellliste von der SAIA-API und fügt sie Ihrer globalen Konfiguration hinzu, sodass neue Modelle ohne manuelle Bearbeitung erscheinen.
Es ist hier verfügbar: opencode-saia-plugin.
Stellen Sie sicher, dass SAIA_API_KEY gesetzt ist (siehe Setzen Sie Ihren API-Schlüssel), und folgen Sie den Einrichtungsschritten im Repository. Es holt die aktuelle Modellliste von der SAIA-API und generiert eine opencode.json mit allen verfügbaren Modellen, kategorisiert (Schlussfolgerung, Code, Vision, agente usw.).
Anmerkung
Dieses Plugin wurde von einem GWDG-Mitarbeiter als Nebenprojekt entwickelt, nicht als offiziell unterstützter Dienst. Wir können sein Verhalten in Zukunft nicht garantieren und keine Unterstützung dafür bieten.
OpenCode in einem gesicherten Container (empfohlen)
Für die lokale Entwicklung empfehlen wir, OpenCode in einem Container auszuführen.
Der Container mountet nur Ihr aktuelles Projektverzeichnis, sodass der Agent Ihre Projektdateien lesen und bearbeiten kann, aber keine Befehle ausführen kann, die Dateien außerhalb Ihres Systems beeinflussen.
Dies ist die empfohlene, sichere Methode, um OpenCode lokal zu nutzen.
Sie erstellen das Image einmal und verwenden es dann in jedem Projekt.
Das Image ist generisch und nicht an ein bestimmtes Projekt gebunden und stört kein vorhandenes Dockerfile Ihres Projekts.
Voraussetzungen: Docker oder Podman auf Ihrem System installiert.
Einmalige Einrichtung
Sie führen diese vier Schritte nur einmal aus.
1. Erstellen Sie eine Datei namens Dockerfile (Großbuchstabe D, keine Erweiterung) in einem beliebigen Ordner Ihrer Wahl (erstellen Sie einen mit mkdir opencode-sandbox).
Dies ist der Standardname, den Docker standardmäßig verwendet.
Ein anderer Name wie dockerfile (klein) oder Dockerfile.txt kann dazu führen, dass das Build-Prozess es nicht findet, also bleiben Sie bei Dockerfile.
Fügen Sie den folgenden Code in Ihre Dockerfile ein:
Wenn Ihre Projekte eine bestimmte Sprachlaufzeit benötigen (z. B. Python oder Python mit uv), fügen Sie diese hier hinzu, bevor Sie das Image bauen.
Der Container hat nur das, was Sie hier installieren.
2. Erstellen Sie das Image. Gehen Sie in den Ordner, der die Dockerfile enthält, und führen Sie aus:
Das . bedeutet „baue mit der Dockerfile im aktuellen Ordner“, sodass Sie den Pfad nicht eingeben müssen. (Ersetzen Sie docker durch podman, falls Sie Podman verwenden.) Sie wiederholen diesen Schritt nur, wenn Sie die Dockerfile ändern.
Bestätigen Sie, dass das Image erstellt wurde:
3. Fügen Sie das run-opencode-Alias hinzu. Das Alias muss in Ihrer Shell-Konfigurationsdatei geschrieben werden (das Tippen einmal am Prompt dauert nur für dieses Terminal).
Hier ist die einzeilige Version, die alte Aliase entfernt und das saubere Alias in ~/.bashrc hinzufügt:
Anmerkung
Wenn Sie zsh statt bash verwenden (überprüfen Sie mit echo $SHELL, ob es mit /zsh endet), fügen Sie das Alias in ~/.zshrc anstelle von ~/.bashrc hinzu und laden ~/.zshrc im nächsten Schritt.
Das Hinzufügen zu ~/.bashrc hat unter zsh keine Wirkung.
4. Laden Sie Ihre Shell neu, damit das Alias verfügbar ist:
Überprüfen Sie, ob das Alias registriert ist:
Dies sollte die Alias-Definition zurückgeben. Wenn ja, ist die Einrichtung abgeschlossen.
Verwendung in einem Projekt
Dies ist das, was Sie jedes Mal tun, wenn Sie an einem Projekt arbeiten möchten.
Beachten Sie, dass Sie run-opencode aus dem Projekt heraus ausführen, das Sie bearbeiten möchten, nicht aus dem Sandbox-Ordner, in dem Sie das Image gebaut haben.
1. Stellen Sie sicher, dass Ihr API-Schlüssel in der aktuellen Shell gesetzt ist (siehe Setzen Sie Ihren API-Schlüssel):
2. Gehen Sie in das Projekt, das Sie bearbeiten möchten, und stellen Sie sicher, dass es eine opencode.json enthält (die SAIA-Konfiguration aus Erstellen der Projekt-Konfiguration):
Platzieren Sie opencode.json im Stammverzeichnis des Projekts (dem Ordner, aus dem Sie run-opencode ausführen).
Der Container mountet diesen Ordner als Arbeitsverzeichnis, sodass OpenCode die Konfiguration automatisch erkennt.
Eine globale/Heim-Konfiguration auf Ihrem Host ist im Sandbox nicht sichtbar, daher benötigt jedes Projekt seine eigene.
3. Starten Sie den Sandbox:
Dies startet den Container mit dem aktuellen Ordner als mount und startet OpenCode.
Der Agent kann die Dateien in diesem Ordner lesen und bearbeiten, aber nichts außerhalb davon.
Anmerkung
Da der Container nur das aktuelle Projektverzeichnis mountet, kann OpenCode keine Dateien außerhalb davon ändern. Dies macht die Einrichtung zu einem sicheren Sandbox für agente Nutzung.
Das Projektverzeichnis selbst bleibt vom Agenten editierbar, was beabsichtigt ist.
Fehlerbehebung
run-opencode: Befehl nicht gefunden: Das Alias ist nicht in Ihrer Shell geladen. Überprüfen Sie, ob es in Ihrer Konfigurationsdatei steht:
- Wenn nichts ausgegeben wird, wurde das Alias nie in die Datei geschrieben (es wurde nur am Prompt eingegeben). Wiederholen Sie Schritt 3 der einmaligen Einrichtung, dann
sourcedie Datei erneut. - Wenn es das Alias ausgibt, aber der Befehl immer noch nicht gefunden wird, bestätigen Sie, dass Sie die Datei bearbeiten, die Ihre Shell tatsächlich liest: Führen Sie
echo $SHELLaus und verwenden Sie~/.zshrcfür zsh oder~/.bashrcfür bash.
Wenn OpenCode startet, aber kein Modell erreichen kann: dann erreicht der Schlüssel den Container nicht oder das Projekt hat keine gültige Konfiguration. Bestätigen Sie, dassecho $SAIA_API_KEYIhren Schlüssel ausgibt, und dass das Projektverzeichnis eine gültigeopencode.jsonenthält.
Tipp
Beibehalten neben einem vorhandenen Dockerfile: Wenn Sie die Sandbox-Dockerfile innerhalb eines Projekts behalten möchten, das bereits sein eigenes hat, geben Sie ihr einen anderen Namen (z. B. Dockerfile.opencode) und bauen mit docker build -f Dockerfile.opencode -t opencode-sandbox ..
Abhängigkeiten: Der Container hat nur das, was Sie in der Dockerfile installieren. Wenn ein Projekt zusätzliche Tools oder Systempakete benötigt, fügen Sie diese in die Dockerfile ein und bauen das Image erneut.
Claude Code (Sichere Einrichtung)
Claude Code ist Anthropics terminal-first Code-Agent, ebenfalls als VS Code-Erweiterung verfügbar.
Diese Einrichtung läuft auf den Modellen in unserem Cluster mit nur einem SAIA-API-Schlüssel, sodass Ihr Code und Ihre Prompts auf der GWDG-Infrastruktur bleiben.
Vor Beginn
Sie benötigen zwei Dinge:
- Einen SAIA-API-Schlüssel. Falls Sie noch keinen besitzen, fordern Sie ihn hier an.
- Claude Code installiert. Die Installation ist dieselbe wie bei der kommerziellen Einrichtung, daher folgen Sie den bestehenden Anweisungen: CLI installieren oder VS Code-Erweiterung installieren.
Nur die Konfiguration unterscheidet sich, und das ist, was der nächste Abschnitt behandelt.
Konfiguration
Erstellen oder aktualisieren Sie ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json), fügen Sie den folgenden Block ein und ersetzen Sie <ihr SAIA-API-Schlüssel> durch Ihren eigenen Schlüssel:
Starten Sie eine Sitzung mit dem claude-Befehl oder öffnen Sie die Claude-Leiste in VS Code.
Da die Einstellungsdatei in Ihrem Benutzerprofil liegt, gelten diese Werte für jede Claude Code-Sitzung unabhängig vom Shell, aus der sie gestartet wird.
Verifizieren Sie die Konfiguration.
Wenn Sie die VS Code-Erweiterung verwenden, aktivieren Sie zusätzlich die Benutzereinstellung Claude Code: Login-Prompt deaktivieren, damit die Erweiterung nicht nach einem Anthropic-Login fragt.
Sie können sie auch direkt in Ihrer VS Code-Benutzer-settings.json setzen:
Tipp
Die Konfiguration oben ist alles, was die meisten Menschen benötigen.
Alles darunter ist Referenzmaterial: Was jede Einstellung bewirkt, wie man Modelle wechselt und wie die Berechtigungsregeln funktionieren.
Kommen Sie dazu zurück, wenn Sie es brauchen.
Anmerkung
ANTHROPIC_MODEL und ANTHROPIC_DEFAULT_HAIKU_MODEL sind beide erforderlich.
Ohne sie fordert Claude Code Anthropic-Modellnamen an, die über SAIA nicht verfügbar sind, und jede Anfrage schlägt fehl.
Was die Variablen tun
| Variable | Bedeutung |
|---|---|
ANTHROPIC_BASE_URL | Leitet alle Anfragen an SAIA statt an Anthropic weiter (ohne /v1) |
ANTHROPIC_AUTH_TOKEN | Ihr SAIA-API-Schlüssel (als Authorization: Bearer gesendet) |
ANTHROPIC_MODEL | Hauptmodell für die Arbeit |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Modell für Hintergrundaufgaben wie Titel und Zusammenfassungen |
ANTHROPIC_DEFAULT_OPUS_MODEL | Füllt den „opus“-Slot in der /model-Liste |
ANTHROPIC_DEFAULT_SONNET_MODEL | Füllt den „sonnet“-Slot in der /model-Liste |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | Kontextfenster des Modells. Der Beispielwert ist ein Platzhalter, passen Sie ihn an das Modell in ANTHROPIC_MODEL an. Der Wert pro Modell steht in der Spalte „Kontextfenster in Tokens“ der Modellliste. Ohne ihn nimmt Claude Code 200.000 Tokens an |
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING | Nicht alle internen Modelle sind Schlussfolgerungsmodelle; für diese hat der Parameter keine Wirkung und kann Fehler verursachen |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS | Verhindert das Senden von Feldern, die der Backend-Server nicht auswertet |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | Schaltet die verbleibenden Verbindungen zu Anthropic-Diensten ab. Das Ändern der Basis-URL leitet nur Modellanfragen um; Telemetrie, Fehlerberichte und der Auto-Updater sprechen sonst weiterhin mit Anthropic. Dieser eine Variable deckt den Großteil ab; die DISABLE_*-Variablen darunter werden zusätzlich gesetzt und dokumentieren den Zweck explizit. Es ist auch die Voraussetzung dafür, dass eine benutzerdefinierte Modellliste überlebt (siehe Methode 3) |
DISABLE_TELEMETRY | Keine Telemetriedaten an Anthropic |
DISABLE_ERROR_REPORTING | Keine Fehlerberichte an Anthropic |
DISABLE_BUG_COMMAND | Deaktiviert den /bug-Befehl |
DISABLE_AUTOUPDATER | Keine automatischen Updates. Aktualisierungen erfolgen über Ihr Paket- oder Image-Prozess |
Setzen Sie absichtlich ein kleines Modell für Hintergrundaufgaben.
Dies reduziert den Token-Verbrauch spürbar, ohne die Ergebnisqualität zu beeinträchtigen.
Optional kann CLAUDE_CODE_SUBAGENT_MODEL im gleichen env-Block das Modell für Subagenten festlegen.
Die Einstellung der Schlussfolgerungsebene (“Aufwand”) hat bei den internen Modellen keine Wirkung.
Eine projektbezogene .claude/settings.json im Repository wird zusätzlich angewendet und ist eine bequeme Möglichkeit, eine vorkonfigurierte Einrichtung an ein Team zu übertragen.
Der API-Schlüssel gehört nicht in diese Datei, da er committet wird. Setzen Sie nur die verbleibenden Variablen dort.
Modellwechsel
Es gibt drei Möglichkeiten, ein Modell auszuwählen.
Methode 1 reicht in den meisten Fällen aus.
Methode 1: Modellname direkt eingeben (keine Konfiguration)
Eingegeben in der laufenden Sitzung, nichts wird in eine Datei geschrieben:
Beim Start entsprechend:
Jedes Modell im Cluster ist auf diese Weise erreichbar, auch wenn es nicht in der Auswahlliste erscheint.
Sie müssen nur den Modellnamen kennen.
Methode 2: Drei Modelle in die Auswahlliste einfügen
Der /model-Befehl öffnet eine Liste mit drei festen Feldern mit den Bezeichnungen „opus“, „sonnet“ und „haiku“.
Diese drei Felder können mit SAIA-Modellen gefüllt werden, indem Sie den folgenden Block in das env-Block in ~/.claude/settings.json hinzufügen:
Die Liste bietet dann drei SAIA-Modelle.
Die Bezeichnungen „opus“, „sonnet“ und „haiku“ bleiben unverändert; die hinter ihnen stehenden Modelle sind die, die Sie eingegeben haben.
Diese Methode bietet maximal diese drei Felder.
Methode 3: Alle Modelle in die Auswahlliste einfügen.
Dies ist optional und nicht offiziell unterstützt.
Zwei verschiedene Dateien sind beteiligt:
- Voraussetzung:
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"imenv-Block in~/.claude/settings.json. Ohne sie überschreibt Claude Code die Modellliste bei jedem Start. - Modellliste: Auf der obersten Ebene von
~/.claude.json, eine andere Datei. Erweitern Sie sie mit dem Schlüssel unten, während keine Sitzung läuft, ersetzen Sie die Datei nicht:
value ist die Modell-ID; label und description sind freie Anzeigetexte.
Die eingebauten Einträge (Standard, Opus, Sonnet) bleiben sichtbar, sind aber über SAIA nicht verwendbar.
Die Embedding-Modelle sind absichtlich ausgelassen, ebenso wie devstral-2-123b-instruct-2512, das Anfragen von Claude Code ablehnt.
Das Ausführen von /logout löscht den Eintrag.
Berechtigungen und Sandbox
Claude Code hat Dateizugriff und führt Befehle aus, daher gilt die gleiche Empfehlung wie für OpenCode: Führen Sie es in einem gesicherten Container aus, der nur Ihr aktuelles Projektverzeichnis mountet.
Der Container ist die äußere Sicherheitsgrenze; das Berechtigungssystem ist die zweite Schicht und sollte verwendet werden, anstatt umgangen zu werden.
- Behalten Sie den Berechtigungs-Dialog aktiviert. Vermeiden Sie
--dangerously-skip-permissionsaußerhalb eines Container-Sandboxes, und selbst innerhalb eines solchen macht es nur Sinn für Aufgaben ohne Netzwerk und ohne Zugriff auf Geheimnisse. - Ausschließen Sie den Zugriff auf Geheimnisse und unzusammenhängende Verzeichnisse mit Verweigerungsregeln.
- Verweigerungsregeln können auch sicherstellen, dass Merge- und Bereitstellungsaufgaben manuell bleiben.
Die Verweigerungsregeln gehen in ~/.claude/settings.json als zweiter Block neben env ein, wie im Konfigurationsabschnitt oben gezeigt.
Dieser Block kann erweitert werden, z. B. um ausgehenden Webzugriff zu blockieren:
WebFetch und WebSearch können weggelassen werden, wo Ihre Netzwerkregeln bereits ausgehenden Traffic blockieren; die Verweigerungsregeln machen die Einschränkung unabhängig von der Container-Konfiguration wirksam.
Siehe Berechtigungsmodi für das vollständige Berechtigungsmodell.
Verifizieren der Konfiguration
Bevor Sie starten, überprüfen Sie URL und Schlüssel unabhängig vom Tool:
Eine Antwort mit "type":"message" bestätigt den Zugriff.
Innerhalb der Sitzung führen Sie /status aus und überprüfen zwei Zeilen:
Anthropic base URLmusshttps://chat-ai.academiccloud.deanzeigen. Wenn die Zeile fehlt, hat die Variable die Sitzung nicht erreicht und wird weiterhin der Anthropic-API verwendet.Auth tokenmussANTHROPIC_AUTH_TOKENnennen. Wenn stattdessen eineLogin method-Zeile mit einem persönlichen Konto erscheint, ist der SAIA-Schlüssel nicht aktiv.
Einschränkungen
Claude Code ist für Anthropic-Modelle konzipiert, und der Anbieter unterstützt explizit keine Ausführung mit anderen Modellen.
Bei größeren Aufgaben erwarten Sie schwächere Ergebnisse als mit den nativen Modellen, insbesondere bei Werkzeugnutzung wie Lesen und Bearbeiten von Dateien oder Ausführen von Befehlen.
OpenCode ist von Design her anbieterunabhängig und ist der bessere Ausgangspunkt, wenn Sie solche Probleme haben.
Cline
Cline ist ein Open-Source-Coding-Agent, der große Sprachmodell-Schlussfolgerung mit praktischen Entwickler-Workflows kombiniert.
Dieser Abschnitt beschreibt die Hauptvorteile von Cline, erläutert sein Plan → Handeln-Interface und führt eine Installation durch, die Cline mit SAIA-Modellen verbindet.
Der Plan → Handeln-Loop
Plan-Modus:
Sie können ein Ziel beschreiben, z. B. „OAuth2-Login hinzufügen“.
Cline antwortet mit einem nummerierten Plan, der Dateiänderungen und Befehle aufzählt.Überprüfung:
Bearbeiten Sie die Checkliste oder bitten Sie Cline, sie zu verfeinern.
Nichts ändert sich im Arbeitsbereich, bis Sie genehmigen.Handeln-Modus:
Cline führt jeden Schritt aus: Bearbeitet Dateien, führt Befehle aus und zeigt Unterschiede an.
Sie bestätigen oder lehnen Aktionen in Echtzeit ab.
Diese Trennung gibt dem Agenten Autonomie, ohne die menschliche Kontrolle zu entfernen.
Installationsanleitung (VS Code)
Bitte finden Sie die Installationsanweisungen unten:
Voraussetzungen
- Visual Studio Code (v1.93 oder neuer)
- SAIA-API-Schlüssel
- Node 18+ für optionalen CLI-Gebrauch
Erweiterung installieren
- Suchen Sie in VS Code-Markt nach Cline und installieren Sie es.
Verbindung zu CoCo AI herstellen
Öffnen Sie Cline (Befehlspalette → „Cline: In neuem Tab öffnen“).
Klicken Sie auf „Mit eigenem API-Schlüssel einrichten“ und wählen Sie „OpenAI-kompatibel“.
Füllen Sie die Felder aus:
Feld Wert Basis-URL https://chat-ai.academiccloud.de/v1API-Schlüssel Ihr SAIA-API-SchlüsselModell-ID glm-4.7(weitere nach Bedarf hinzufügen)Fügen Sie zusätzliche Modelle (z. B.
qwen3-30b-a3b-instruct-2507) mit derselben URL und demselben Schlüssel hinzu, falls erforderlich.Weisen Sie Rollen zu (falls Sie ein anderes Modell für Plan und Handeln verwenden möchten): Setzen Sie z. B.
glm-4.7für Handeln; setzen Sieqwen3-30b-a3b-instruct-2507für Plan.
Täglicher Workflow
Hier ist der tägliche Workflow:
Plan → Plan genehmigen → Handeln → Unterschiede überprüfen → Iterieren
Cline schließt die Lücke zwischen chatbasierten Assistenten und vollständiger IDE-Automatisierung.
Mit einer kurzen Einrichtung, die auf CoCo AI zeigt, wird es ein flexibler Co-Entwickler für komplexe Codebasen, während die Kontrolle des Entwicklers erhalten bleibt.