Hoe Windsurf (Codeium) in te stellen: Een praktische handleiding

TL;DR

• Installatie in 2 minuten: VS Code (ext install Codeium.codeium) of JetBrains (zoek "Codeium" in plugins).
• Cascade-modus: Agentic workflows voor meertraps coderen (bijv. /refactor + /test).
• Gratis versie: Onbeperkte autocomplete, 50 chatverzoeken/dag. Pro (€12/gebruiker/maand) geeft onbeperkte chat vrij.
• Privacy: Geen telemetrie, zelf te hosten (Enterprise). In lijn met het AI-beveiligingspostuurkader voor de PROTECT- en COMPLY-fasen.

1. Installatie en setup

VS Code (Aanbevolen)

# Installatie via CLI (VS Code moet geopend zijn)
code --install-extension Codeium.codeium

Verwachte uitvoer:

Installing extensions...
Extension 'Codeium.codeium' v3.12.0 was successfully installed.

Na installatie:

1. Herstart VS Code.
2. Meld aan via GitHub/GitLab/Google (of gebruik anoniem voor alleen autocomplete).
3. Accepteer machtigingen (lezen/schrijven naar werkruimtebestanden voor context).

Let op:

• Als autocomplete niet verschijnt, controleer de statusbalk (rechtsonder) op foutmeldingen. Voer Codeium: Restart Extension uit via de opdrachtpalette (Ctrl+Shift+P).

JetBrains (IntelliJ, PyCharm, etc.)

1. Open Instellingen > Plugins.
2. Zoek naar Codeium en installeer.
3. Herstart de IDE.
4. Meld aan via de pop-up.

Let op:

• JetBrains-plugins updaten langzamer dan VS Code. Voor de nieuwste functies, gebruik Codeium’s JetBrains nightly builds.

CLI (Terminal)

# Installeer Python-pakket (vereist Python 3.8+)
pip install codeium --upgrade

Verifieer installatie:

codeium --version
# Uitvoer: codeium, version 3.12.0

Authenticatie:

codeium auth
# Opent browser om aan te melden. Token wordt opgeslagen in ~/.codeium/credentials.json.

2. Cascade-modus (Agentic coding)

Cascade-modus stelt u in staat om AI-acties te koppelen (bijv. refactoren → testen → documenteren) in één prompt. Belangrijk voor de ASSESS- en PROTECT-fasen van het AI-beveiligingspostuurkader (bijv. geautomatiseerde beveiligingsoplossingen).

Cascade inschakelen

1. Open het Codeium-chatvenster (Ctrl+Shift+I in VS Code).
2. Typ /cascade om een meertrapsworkflow te starten.

Voorbeeld: Veilige refactor

Prompt:

/cascade
1. Refactor deze Python-functie om type hints te gebruiken en harde geheimen te verwijderen.
2. Voeg inputvalidatie toe voor de parameter `user_id`.
3. Genereer een unittests met pytest.

Verwachte uitvoer:

# Gerefactorde functie (stap 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 moet een UUID-string van 36 tekens zijn")
    # ... rest van de functie

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

Professionele tip:

• Gebruik /cascade + /explain om wijzigingen te controleren op compliance (COMPLY-fase van het AI-beveiligingspostuurkader).
• Sla veelgebruikte workflows op als aangepaste opdrachten (zie sectie 5).

3. Autocomplete-configuratie

Autocomplete in-/uitschakelen

VS Code:

1. Open Instellingen (Ctrl+,).
2. Zoek naar Codeium: Enable Autocomplete.
3. Schakel het selectievakje in/uit.

JetBrains:

1. Ga naar Instellingen > Tools > Codeium.
2. Vink Enable Autocomplete aan/uit.

Aanpassen van triggertoetsen

Voeg toe aan settings.json (VS Code):

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

Let op:

• Als Tab conflicteert met snippets, gebruik dan Enter.

Taalspecifieke instellingen

{
  "codeium.languageSettings": {
    "python": {
      "maxSuggestions": 5, // Standaard: 3
      "suggestionDelay": 200 // ms (standaard: 300)
    },
    "javascript": {
      "disableAutocomplete": true // Voor specifieke talen
    }
  }
}

4. Opdrachtpalette en sneltoetsen

Essentiële sneltoetsen

Aangepaste opdrachten

Definieer slash-opdrachten in ~/.codeium/commands.json:

{
  "commands": [
    {
      "name": "secure-refactor",
      "description": "Code refactoren met beveiligingscontroles",
      "prompt": "/cascade\n1. Voeg inputvalidatie toe\n2. Verwijder harde geheimen\n3. Voeg logging toe voor gevoelige operaties"
    }
  ]
}

Gebruik: Typ /secure-refactor in het chatvenster.

5. Modelselectie

Cloudmodellen (standaard)

Codeium gebruikt eigen modellen die geoptimaliseerd zijn voor code. Geen configuratie nodig voor gratis/Pro-versies.

Lokale modellen (experimenteel)

Vereisten:

• 16GB+ RAM, NVIDIA GPU (aanbevolen).
• Installeer Ollama of LM Studio.

Lokaal model configureren:

1. Open settings.json (VS Code/JetBrains).
2. Voeg toe:

{
  "codeium.useLocalModel": true,
  "codeium.localModelPath": "/pad/naar/model.gguf" // bijv. CodeLlama-7B
}

Let op:

• Lokale modellen zijn langzamer en missen context over meerdere bestanden. Gebruik alleen voor offline werk.

6. Werken met monorepo's

Meerdere bestanden als context inschakelen

1. Open de hoofdmap van uw monorepo in uw IDE.
2. Codeium indexeert automatisch bestanden in de werkruimte.

Beperkingen:

• Maximaal 32k tokens voor context (lange bestanden kunnen worden afgekapt).
• Voor grote repo's (>10k bestanden), sluit mappen uit in settings.json:

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

Voorbeeld: Refactor over meerdere bestanden

Prompt:

/cascade
1. Werk de klasse `UserService` in `backend/services/user.py` bij om de nieuwe `AuthClient` uit `backend/clients/auth.py` te gebruiken.
2. Genereer een migratiescript voor de wijzigingen in het databaseschema.

Verwachte uitvoer:

• Codeium zal:
  1. AuthClient importeren in user.py.
  2. Verouderde auth-methoden vervangen.
  3. Een bestand migrations/002_add_auth_client.sql genereren.

7. Gratis versie vs. Pro-functies

Upgrade naar Pro:

1. Open het Codeium-paneel in uw IDE.
2. Klik op Upgrade en selecteer een abonnement.

Veelvoorkomende fouten en oplossingen

Alternatieven in een oogopslag

Wat nu?

1. Stel Cascade-modus in voor uw meest repetitieve taken (bijv. /cascade /refactor /test).
2. Configureer aangepaste opdrachten voor beveiligingscontroles (bijv. /secure-audit om naar geheimen te scannen).
3. Onderzoek zelfhosting als u in een gereguleerde sector werkt (neem contact op met Codeium Enterprise).

Voor teams die AI-tools adopteren, biedt Hyperion Consulting AI-beveiligingspostuurkader-workshops aan om Codeium af te stemmen op uw beveiligings- en compliance-doelen. Lees meer op hyperion-consulting.io.