OpenCode mit Agent Redactor verwenden

Voraussetzung: Installieren Sie Agent Redactor aus dem Microsoft Store oder per PowerShell-Einzeiler. Sie benötigen außerdem eine Installation von OpenCode.

  1. Ein Profil erstellen und den API-Proxy konfigurieren

    Öffnen Sie die Profilliste in der linken Seitenleiste und wählen Sie ein Profil aus oder erstellen Sie ein neues. Legen Sie einen Profilnamen fest, wählen Sie einen freien lokalen Port (z. B. 8080), geben Sie den echten Ziel-Endpunkt Ihres Anbieters ein (z. B. https://openrouter.ai/api/v1) und fügen Sie Ihren echten API-Schlüssel ein. Der Schlüssel wird lokal verschlüsselt und verlässt Ihren Rechner nie.

    API-Proxy-Bereich von Agent Redactor mit Profilname OpenRouter Provider, lokaler URL localhost:8080, Ziel openrouter.ai/api/v1 und API-Schlüsselfeld
    Konfigurieren Sie das Profil. Die lokale URL ist der Endpunkt, mit dem OpenCode sich verbindet, das Ziel ist der echte API-Endpunkt.

  2. KI-gestützte Erkennung und Schwärzungsregeln aktivieren

    Wählen Sie die PII-Kategorien aus, die geschwärzt werden sollen. Für projektspezifische Geheimnisse können Sie außerdem Regex-Regeln und Stichwörter hinzufügen.

    Agent Redactor mit aktiviertem KI-gestützten Erkennungsmodell, ausgewählten PII-Kategorien, Statistikbereich und Sitzungs-Schwärzungen mit erkannter PII
    Die KI-Erkennung ist mit allen Kategorien aktiv. Der Bereich „Sitzungs-Schwärzungen" zeigt abgefangene PII (z. B. „Bob" als private_person erkannt).

  3. OpenCode öffnen

    Starten Sie OpenCode. Sie sehen die Hauptoberfläche mit dem Chat-Eingabefeld und dem aktuellen Modellauswähler.

    OpenCode-Hauptbildschirm mit New session, Chat-Eingabefeld und Modellauswähler mit Big Pickle
    OpenCode-Hauptbildschirm mit Chat-Eingabefeld und Modellauswähler.

  4. Den Modellauswähler öffnen

    Geben Sie /model in das Chat-Eingabefeld ein, um den Dialog zur Modellauswahl zu öffnen. Alternativ können Sie Ctrl+' als Tastenkürzel verwenden.

    OpenCode mit /model im Chat-Eingabefeld und angezeigter Modellauswahl
    Geben Sie /model ein, um den Modellauswähler zu öffnen.

  5. Auf „Connect provider" klicken

    Klicken Sie im Dialog zur Modellauswahl oben rechts auf die Schaltfläche Connect provider, um eine neue Anbieterverbindung hinzuzufügen.

    Dialog zur Modellauswahl in OpenCode mit der Schaltfläche Connect provider oben rechts
    Klicken Sie auf Connect provider, um Agent Redactor hinzuzufügen.

  6. „Custom OpenAI-compatible provider" auswählen

    Scrollen Sie in der Anbieterliste zum Abschnitt Other und wählen Sie Custom OpenAI-compatible provider. Damit können Sie OpenCode auf jeden OpenAI-kompatiblen Endpunkt ausrichten.

    Dialog „Connect provider
    Wählen Sie Custom OpenAI-compatible provider aus dem Abschnitt Other.

  7. Die Anbieterdetails ausfüllen

    Geben Sie Folgendes in das Formular für den benutzerdefinierten Anbieter ein:

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/ (muss mit dem Port in Agent Redactor übereinstimmen)
    • API key: Leer lassen. Agent Redactor übernimmt die Authentifizierung über Header
    Formular für benutzerdefinierten Anbieter in OpenCode mit Provider ID agent-redactor, Display name Agent Redactor und Base URL http://localhost:8080/
    Füllen Sie die Anbieterdetails aus. Die Base URL muss mit dem Port Ihres Agent-Redactor-Proxys übereinstimmen.

  8. Ein Modell hinzufügen und absenden

    Scrollen Sie zum Abschnitt Models. Geben Sie die Modell-ID (z. B. nvidia/nemotron-3-ultra-550b-a55b:free) und einen Anzeigenamen ein (z. B. „Nemotron 3 Ultra"). Klicken Sie auf Submit, um zu speichern.

    Abschnitt Models im Formular für benutzerdefinierten Anbieter in OpenCode mit Modell-ID nvidia/nemotron-3-ultra-550b-a55b:free und Submit-Schaltfläche
    Modell hinzufügen und auf Submit klicken.

  9. Ihr Modell auswählen

    Suchen Sie im /model-Dialog nach „agent" – Sie sehen Ihren Agent Redactor-Anbieter mit dem Modell darunter. Wählen Sie es aus, um alle Anfragen über den Proxy zu leiten.

    Modellauswähler in OpenCode mit Suche nach agent, die den Anbieter Agent Redactor mit Nemotron 3 Ultra (Free) anzeigt
    Suchen Sie nach „agent", um Ihren Agent-Redactor-Anbieter zu finden, und wählen Sie das Modell aus.

  10. Chat starten

    Senden Sie eine Nachricht. In diesem Beispiel sagte der Nutzer „My name is Bob". Agent Redactor erkannte „Bob" als PII, schwärzte es vor der Weiterleitung an das LLM und stellte es in der Antwort wieder her.

    OpenCode-Chat über Agent Redactor, in dem der Name Bob geschwärzt und in der Antwort wiederhergestellt wurde
    „Bob" wurde auf dem Hinweg geschwärzt und auf dem Rückweg transparent wiederhergestellt.

Schwärzung verifizieren

Prüfen Sie den Bereich „Sitzungs-Schwärzungen" in Agent Redactor, um genau zu sehen, was abgefangen wurde.

Agent Redactor-Statistik mit Requests: 1, PII: 1 und Sitzungs-Schwärzungen mit PII private_person Bob
Der Statistikbereich zeigt „Requests: 1, PII: 1" und die Sitzungs-Schwärzungen listen den abgefangenen Wert mit Zeitstempel und Typ auf.
Tipp: Verwenden Sie Regex-Regeln und Stichwörter in Ihrem Profil, um projektspezifische Geheimnisse zu erfassen, die das KI-Modell möglicherweise übersieht – zum Beispiel interne Hostnamen, proprietäre IDs oder Projekt-Codenamen.