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 :
- Redémarrez VS Code.
- Connectez-vous via GitHub/GitLab/Google (ou utilisez-le de manière anonyme pour l'autocomplétion uniquement).
- 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 Extensiondepuis la palette de commandes (Ctrl+Maj+P).
JetBrains (IntelliJ, PyCharm, etc.)
- Ouvrez Settings > Plugins.
- Recherchez
Codeiumet installez-le. - Redémarrez l'IDE.
- 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
- Ouvrez le panneau de chat Codeium (
Ctrl+Maj+Idans VS Code). - Tapez
/cascadepour 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+/explainpour 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 :
- Ouvrez Settings (
Ctrl+,). - Recherchez
Codeium: Enable Autocomplete. - Activez ou désactivez la case à cocher.
JetBrains :
- Allez dans Settings > Tools > Codeium.
- 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
Tabentre en conflit avec les snippets, utilisezEnterà 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
| Action | Raccourci VS Code | Raccourci JetBrains |
|---|---|---|
| Ouvrir le Chat | Ctrl+Maj+I | Ctrl+Maj+C |
| Accepter une Suggestion | Tab | Tab |
| Rejeter une Suggestion | Échap | Échap |
| Déclencher une Suggestion | Alt+\ | Alt+Entrée |
| Basculer l'Autocomplétion | Ctrl+Maj+A | Ctrl+Alt+A |
| Mode Cascade | /cascade (dans le chat) | /cascade (dans le chat) |
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 :
Configuration d'un Modèle Local :
- Ouvrez
settings.json(VS Code/JetBrains). - 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
- Ouvrez le répertoire racine de votre monorepo dans votre IDE.
- 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 :
- Importer
AuthClientdansuser.py. - Remplacer les méthodes d'authentification obsolètes.
- Générer un fichier
migrations/002_add_auth_client.sql.
- Importer
7. Fonctionnalités Gratuites vs. Pro
| Fonctionnalité | Version Gratuite | Version Pro (12 $/utilisateur/mois) |
|---|---|---|
| Autocomplétion | ✅ Illimitée | ✅ Illimitée |
| Chat | 50 requêtes/jour | ✅ Illimité |
| Contexte Multi-Fichiers | ❌ (Fichier unique) | ✅ (32k tokens) |
| Mode Cascade | ❌ | ✅ |
| Commandes Personnalisées | ❌ | ✅ |
| Support Prioritaire | ❌ | ✅ |
| Auto-Hébergement | ❌ | ✅ (Enterprise uniquement) |
| Cadre de Posture de Sécurité IA | ASSESS uniquement | ASSESS + PROTECT + DETECT |
Passer à la version Pro :
- Ouvrez le panneau Codeium dans votre IDE.
- Cliquez sur Upgrade et sélectionnez un plan.
Erreurs Courantes et Solutions
| Erreur | Cause | Solution |
|---|---|---|
Rate limit exceeded | Limite de chat de la version gratuite (50/jour) | Passez à la version Pro ou attendez 24 heures. |
No suggestions | Autocomplétion désactivée ou problème réseau | Vérifiez settings.json ou exécutez Codeium: Restart Extension. |
Multi-file context failed | Fichier trop volumineux ou exclu | Réduisez la taille du fichier ou mettez à jour excludedDirectories. |
Authentication failed | Jeton expiré | Exécutez codeium auth dans le terminal ou reconnectez-vous via l'IDE. |
Local model not found | Chemin incorrect ou format de modèle | Vérifiez localModelPath dans settings.json et la compatibilité du modèle. |
Alternatives en Un Coup d'Œil
| Outil | Meilleur Pour | Inconvénients |
|---|---|---|
| Codeium | Confidentialité, auto-hébergement, version gratuite | Communauté plus petite que Copilot |
| GitHub Copilot | Plus grand modèle, intégration IDE profonde | Pas d'auto-hébergement, préoccupations de télémétrie |
| Cursor | Workflows axés sur le chat | Modèle propriétaire, pas d'options locales |
Prochaines Étapes
- Configurez le mode Cascade pour vos tâches les plus répétitives (ex. :
/cascade /refactor /test). - Configurez des commandes personnalisées pour les vérifications de sécurité (ex. :
/secure-auditpour scanner les secrets). - 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.
