Windsurf (Codeium) einrichten: Eine praktische Anleitung

TL;DR

• Installation in 2 Minuten: VS Code (ext install Codeium.codeium) oder JetBrains (im Plugin-Bereich nach "Codeium" suchen).
• Kaskadenmodus: Agentische Workflows für mehrstufige Code-Erstellung (z. B. /refactor + /test).
• Kostenlose Version: Unbegrenzte Autovervollständigung, 50 Chat-Anfragen/Tag. Pro-Version (12 $/Nutzer/Monat) schaltet unbegrenzten Chat frei.
• Datenschutz: Keine Telemetrie, selbst hostbar (Enterprise). Entspricht dem AI-Sicherheitsrahmenwerk für die Phasen PROTECT und COMPLY.

1. Installation und Einrichtung

VS Code (Empfohlen)

# Installation über CLI (VS Code muss geöffnet sein)
code --install-extension Codeium.codeium

Erwartete Ausgabe:

Installing extensions...
Extension 'Codeium.codeium' v3.12.0 wurde erfolgreich installiert.

Nach der Installation:

1. VS Code neu laden.
2. Anmeldung über GitHub/GitLab/Google (oder anonym für Autovervollständigung nutzen).
3. Berechtigungen akzeptieren (Lese-/Schreibzugriff auf Arbeitsbereichsdateien für Kontext).

Achtung:

• Falls die Autovervollständigung nicht erscheint, Statusleiste (unten rechts) auf Fehler prüfen. Befehl Codeium: Restart Extension über die Befehlspalette (Strg+Umschalt+P) ausführen.

JetBrains (IntelliJ, PyCharm, etc.)

1. Einstellungen > Plugins öffnen.
2. Nach Codeium suchen und installieren.
3. IDE neu starten.
4. Über das Popup anmelden.

Achtung:

• JetBrains-Plugins werden langsamer aktualisiert als VS Code. Für die neuesten Funktionen Codeiums JetBrains Nightly Builds nutzen.

CLI (Terminal)

# Python-Paket installieren (erfordert Python 3.8+)
pip install codeium --upgrade

Installation überprüfen:

codeium --version
# Ausgabe: codeium, version 3.12.0

Authentifizierung:

codeium auth
# Öffnet den Browser zur Anmeldung. Token wird in ~/.codeium/credentials.json gespeichert.

2. Kaskadenmodus (Agentische Code-Erstellung)

Der Kaskadenmodus ermöglicht das Verketten von KI-Aktionen (z. B. Refactoring → Test → Dokumentation) in einer einzigen Eingabe. Wichtig für die Phasen ASSESS und PROTECT des AI Security Posture Framework™ (z. B. automatisierte Sicherheitskorrekturen).

Kaskadenmodus aktivieren

1. Codeium-Chat-Panel in VS Code öffnen (Strg+Umschalt+I).
2. /cascade eingeben, um einen mehrstufigen Workflow zu starten.

Beispiel: Sicheres Refactoring

Eingabe:

/cascade
1. Diese Python-Funktion mit Type Hints versehen und hartcodierte Geheimnisse entfernen.
2. Eingabevalidierung für den Parameter `user_id` hinzufügen.
3. Einen Unit-Test mit pytest generieren.

Erwartete Ausgabe:

# Refaktorierte Funktion (Schritt 1)
def get_user_data(user_id: str, api_key: str = os.getenv("API_KEY")) -> dict:
    if not isinstance(user_id, str) or len(user_id) != 36:
        raise ValueError("user_id muss eine 36-stellige UUID-Zeichenkette sein")
    # ... Rest der Funktion

# Generierter Test (Schritt 3)
def test_get_user_data():
    with patch("os.getenv", return_value="test_key"):
        assert get_user_data("123e4567-e89b-12d3-a456-426614174000") == {...}

Profi-Tipp:

• /cascade + /explain nutzen, um Änderungen für die Compliance zu prüfen (COMPLY-Phase des AI Security Posture Framework™).
• Häufige Workflows als benutzerdefinierte Befehle speichern (siehe Abschnitt 5).

3. Autovervollständigung konfigurieren

Autovervollständigung aktivieren/deaktivieren

VS Code:

1. Einstellungen öffnen (Strg+,).
2. Nach Codeium: Enable Autocomplete suchen.
3. Kontrollkästchen aktivieren/deaktivieren.

JetBrains:

1. Zu Einstellungen > Tools > Codeium gehen.
2. Enable Autocomplete aktivieren/deaktivieren.

Auslösetasten anpassen

In settings.json (VS Code) hinzufügen:

{
  "codeium.enableAutoSuggestions": true,
  "codeium.suggestionTriggerKeys": ["Tab", "Enter"] // Standard: ["Tab"]
}

Achtung:

• Falls Tab mit Snippets kollidiert, stattdessen Enter verwenden.

Sprachspezifische Einstellungen

{
  "codeium.languageSettings": {
    "python": {
      "maxSuggestions": 5, // Standard: 3
      "suggestionDelay": 200 // ms (Standard: 300)
    },
    "javascript": {
      "disableAutocomplete": true // Für bestimmte Sprachen
    }
  }
}

4. Befehlspalette und Tastenkürzel

Wichtige Tastenkürzel

Benutzerdefinierte Befehle

Slash-Befehle in ~/.codeium/commands.json definieren:

{
  "commands": [
    {
      "name": "secure-refactor",
      "description": "Code mit Sicherheitsprüfungen refaktorieren",
      "prompt": "/cascade\n1. Eingabevalidierung hinzufügen\n2. Hartcodierte Geheimnisse entfernen\n3. Protokollierung für sensible Vorgänge hinzufügen"
    }
  ]
}

Verwendung: Im Chat-Panel /secure-refactor eingeben.

5. Modellauswahl

Cloud-Modelle (Standard)

Codeium nutzt proprietäre Modelle, die für Code optimiert sind. Für die kostenlose und Pro-Version ist keine Konfiguration erforderlich.

Lokale Modelle (Experimentell)

Anforderungen:

• 16 GB+ RAM, NVIDIA-GPU (empfohlen).
• Ollama oder LM Studio installieren.

Lokales Modell konfigurieren:

1. settings.json (VS Code/JetBrains) öffnen.
2. Folgendes hinzufügen:

{
  "codeium.useLocalModel": true,
  "codeium.localModelPath": "/pfad/zum/modell.gguf" // z. B. CodeLlama-7B
}

Achtung:

• Lokale Modelle sind langsamer und verfügen nicht über Kontext über mehrere Dateien. Nur für Offline-Arbeit nutzen.

6. Arbeiten mit Monorepos

Mehrdatei-Kontext aktivieren

1. Das Stammverzeichnis Ihres Monorepos in der IDE öffnen.
2. Codeium indiziert automatisch Dateien im Arbeitsbereich.

Einschränkungen:

• Maximal 32k Tokens für Kontext (lange Dateien können abgeschnitten werden).
• Bei großen Repositories (>10k Dateien) Verzeichnisse in settings.json ausschließen:

{
  "codeium.excludedDirectories": [
    "**/node_modules",
    "**/dist",
    "**/.git"
  ]
}

Beispiel: Refactoring über mehrere Dateien

Eingabe:

/cascade
1. Die Klasse `UserService` in `backend/services/user.py` aktualisieren, um den neuen `AuthClient` aus `backend/clients/auth.py` zu verwenden.
2. Ein Migrationsskript für die Datenbankschema-Änderungen generieren.

Erwartete Ausgabe:

• Codeium wird:
  1. AuthClient in user.py importieren.
  2. Veraltete Authentifizierungsmethoden ersetzen.
  3. Eine Datei migrations/002_add_auth_client.sql generieren.

7. Kostenlose Version vs. Pro-Features

Upgrade auf Pro:

1. Codeium-Panel in der IDE öffnen.
2. Auf Upgrade klicken und einen Tarif auswählen.

Häufige Fehler und Lösungen

Alternativen im Überblick

Nächste Schritte

1. Kaskadenmodus für repetitive Aufgaben einrichten (z. B. /cascade /refactor /test).
2. Benutzerdefinierte Befehle für Sicherheitsprüfungen konfigurieren (z. B. /secure-audit zum Scannen nach Geheimnissen).
3. Selbsthosting prüfen, falls Sie in einer regulierten Branche tätig sind (Kontakt zu Codeium Enterprise aufnehmen).

Für Teams, die KI-Tools einführen, bietet Hyperion Consulting Workshops zum AI Security Posture Framework™ an, um Codeium mit Ihren Sicherheits- und Compliance-Zielen in Einklang zu bringen. Weitere Informationen finden Sie unter hyperion-consulting.io.