Comment Configurer Windsurf (Codeium) : Guide Pratique

TL;DR

• Installation en 2 minutes : VS Code (ext install Codeium.codeium) ou JetBrains (recherchez « Codeium » dans les plugins).
• Mode Cascade : Workflows agentiques pour le codage multi-étapes (ex. : /refactor + /test).
• Version gratuite : Autocomplétion illimitée, 50 requêtes de chat/jour. La version Pro (12 $/utilisateur/mois) débloque le chat illimité.
• Confidentialité : Aucune télémétrie, possibilité d'auto-hébergement (Enterprise). Conforme au Cadre de Posture de Sécurité IA pour les phases PROTECT et COMPLY.

1. Installation et Configuration

VS Code (Recommandé)

# Installation via CLI (VS Code doit être ouvert)
code --install-extension Codeium.codeium

Sortie attendue :

Installing extensions...
Extension 'Codeium.codeium' v3.12.0 a été installée avec succès.

Post-installation :

1. Redémarrez VS Code.
2. Connectez-vous via GitHub/GitLab/Google (ou utilisez-le de manière anonyme pour l'autocomplétion uniquement).
3. Acceptez les autorisations (lecture/écriture des fichiers de l'espace de travail pour le contexte).

Attention :

• Si l'autocomplétion n'apparaît pas, vérifiez la barre d'état (en bas à droite) pour les erreurs. Exécutez Codeium: Restart Extension depuis la palette de commandes (Ctrl+Maj+P).

JetBrains (IntelliJ, PyCharm, etc.)

1. Ouvrez Settings > Plugins.
2. Recherchez Codeium et installez-le.
3. Redémarrez l'IDE.
4. Connectez-vous via la fenêtre pop-up.

Attention :

• Les plugins JetBrains sont mis à jour moins fréquemment que ceux de VS Code. Pour les dernières fonctionnalités, utilisez les versions nocturnes de Codeium pour JetBrains.

CLI (Terminal)

# Installation du package Python (nécessite Python 3.8+)
pip install codeium --upgrade

Vérification de l'installation :

codeium --version
# Sortie : codeium, version 3.12.0

Authentification :

codeium auth
# Ouvre le navigateur pour la connexion. Le jeton est enregistré dans ~/.codeium/credentials.json.

2. Mode Cascade (Codage Agentique)

Le mode Cascade vous permet d'enchaîner des actions d'IA (ex. : refactoriser → tester → documenter) dans une seule invite. Essentiel pour les phases ASSESS et PROTECT du Cadre de Posture de Sécurité IA (ex. : corrections de sécurité automatisées).

Activation du Mode Cascade

1. Ouvrez le panneau de chat Codeium (Ctrl+Maj+I dans VS Code).
2. Tapez /cascade pour démarrer un workflow multi-étapes.

Exemple : Refactorisation Sécurisée

Invite :

/cascade
1. Refactorisez cette fonction Python pour utiliser des annotations de type et supprimer les secrets codés en dur.
2. Ajoutez une validation des entrées pour le paramètre `user_id`.
3. Générez un test unitaire avec pytest.

Sortie attendue :

# Fonction refactorisée (étape 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 doit être une chaîne UUID de 36 caractères")
    # ... reste de la fonction

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

Conseil Pro :

• Utilisez /cascade + /explain pour auditer les modifications en vue de la conformité (phase COMPLY du Cadre de Posture de Sécurité IA).
• Enregistrez les workflows courants en tant que commandes personnalisées (voir Section 5).

3. Configuration de l'Autocomplétion

Activation/Désactivation de l'Autocomplétion

VS Code :

1. Ouvrez Settings (Ctrl+,).
2. Recherchez Codeium: Enable Autocomplete.
3. Activez ou désactivez la case à cocher.

JetBrains :

1. Allez dans Settings > Tools > Codeium.
2. Cochez/décochez Enable Autocomplete.

Personnalisation des Touches de Déclenchement

Ajoutez dans settings.json (VS Code) :

{
  "codeium.enableAutoSuggestions": true,
  "codeium.suggestionTriggerKeys": ["Tab", "Enter"] // Par défaut : ["Tab"]
}

Attention :

• Si Tab entre en conflit avec les snippets, utilisez Enter à la place.

Paramètres par Langage

{
  "codeium.languageSettings": {
    "python": {
      "maxSuggestions": 5, // Par défaut : 3
      "suggestionDelay": 200 // ms (par défaut : 300)
    },
    "javascript": {
      "disableAutocomplete": true // Pour des langages spécifiques
    }
  }
}

4. Palette de Commandes et Raccourcis

Raccourcis Essentiels

Commandes Personnalisées

Définissez des commandes slash dans ~/.codeium/commands.json :

{
  "commands": [
    {
      "name": "secure-refactor",
      "description": "Refactoriser le code avec des vérifications de sécurité",
      "prompt": "/cascade\n1. Ajouter une validation des entrées\n2. Supprimer les secrets codés en dur\n3. Ajouter un journal pour les opérations sensibles"
    }
  ]
}

Utilisation : Tapez /secure-refactor dans le panneau de chat.

5. Sélection du Modèle

Modèles Cloud (Par Défaut)

Codeium utilise des modèles propriétaires optimisés pour le code. Aucune configuration n'est nécessaire pour les versions gratuite et Pro.

Modèles Locaux (Expérimental)

Prérequis :

• 16 Go+ de RAM, GPU NVIDIA (recommandé).
• Installez Ollama ou LM Studio.

Configuration d'un Modèle Local :

1. Ouvrez settings.json (VS Code/JetBrains).
2. Ajoutez :

{
  "codeium.useLocalModel": true,
  "codeium.localModelPath": "/chemin/vers/model.gguf" // ex. : CodeLlama-7B
}

Attention :

• Les modèles locaux sont plus lents et manquent de contexte multi-fichiers. À utiliser uniquement pour un travail hors ligne.

6. Travail avec les Monorepos

Activation du Contexte Multi-Fichiers

1. Ouvrez le répertoire racine de votre monorepo dans votre IDE.
2. Codeium indexe automatiquement les fichiers de l'espace de travail.

Limitations :

• Maximum de 32k tokens pour le contexte (les fichiers longs peuvent être tronqués).
• Pour les grands dépôts (>10k fichiers), excluez les répertoires dans settings.json :

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

Exemple : Refactorisation Inter-Fichiers

Invite :

/cascade
1. Mettez à jour la classe `UserService` dans `backend/services/user.py` pour utiliser le nouveau `AuthClient` de `backend/clients/auth.py`.
2. Générez un script de migration pour les modifications du schéma de la base de données.

Sortie attendue :

• Codeium va :
  1. Importer AuthClient dans user.py.
  2. Remplacer les méthodes d'authentification obsolètes.
  3. Générer un fichier migrations/002_add_auth_client.sql.

7. Fonctionnalités Gratuites vs. Pro

Passer à la version Pro :

1. Ouvrez le panneau Codeium dans votre IDE.
2. Cliquez sur Upgrade et sélectionnez un plan.

Erreurs Courantes et Solutions

Alternatives en Un Coup d'Œil

Prochaines Étapes

1. Configurez le mode Cascade pour vos tâches les plus répétitives (ex. : /cascade /refactor /test).
2. Configurez des commandes personnalisées pour les vérifications de sécurité (ex. : /secure-audit pour scanner les secrets).
3. Explorez l'auto-hébergement si vous êtes dans un secteur réglementé (contactez Codeium Enterprise).

Pour les équipes adoptant des outils d'IA, Hyperion Consulting propose des ateliers Cadre de Posture de Sécurité IA pour aligner Codeium avec vos objectifs de sécurité et de conformité. Pour en savoir plus, consultez hyperion-consulting.io.