Passer au contenu principal

FAQ générale

Commencez par attendre quelques minutes le temps que la mise à jour s’applique. Si cela ne suffit pas, déconnectez-vous de Windsurf sur le site, redémarrez votre IDE, puis reconnectez-vous à Windsurf. Assurez-vous également d’avoir installé la dernière version de Windsurf.
Vous pouvez annuler votre offre payante en accédant à votre profil en cliquant sur votre icône en haut à droite du site Windsurf.Pour annuler votre abonnement Pro, ouvrez la page Facturation dans le panneau de navigation à gauche et cliquez sur “Cancel Plan”.Pour annuler votre abonnement Teams, ouvrez la page Manage Team dans le panneau de navigation à gauche et cliquez sur “Cancel Plan”.
Comme indiqué sur notre page Sécurité, vous pouvez refuser la télémétrie des extraits de code dans vos paramètres du compte. Pour plus d’informations, veuillez consulter nos Conditions d’utilisation.
Vous pouvez supprimer votre compte en accédant à vos paramètres du compte, en faisant défiler la page jusqu’en bas, puis en cliquant sur “Delete Account”.
Si vous faites partie d’une organisation, veuillez contacter votre administrateur.
Vous pouvez partager vos demandes de fonctionnalités et vos retours via nos canaux communautaires : Reddit, Discord ou Twitter/X.Vous pouvez aussi nous contacter via notre plateforme de support.

Je rencontre des problèmes de limitation de débit

Nous sommes soumis à des limites de débit et, malheureusement, atteignons parfois la capacité des modèles premium avec lesquels nous travaillons. Nous œuvrons activement à augmenter ces limites et à répartir équitablement la capacité dont nous disposons. Cela ne devrait pas durer. Si vous rencontrez cette erreur, veuillez patienter quelques instants, puis réessayez.

Pylance ou Pyright ne fonctionne pas / La coloration syntaxique Python est défaillante ou de mauvaise qualité

Nous avons développé une extension Pyright spécialement pour Windsurf. Recherchez « Windsurf Pyright » ou collez @id:codeium.windsurfPyright dans la recherche d’extensions.

Comment télécharger les logs de diagnostic à envoyer à l’équipe d’assistance Windsurf ?

Vous pouvez télécharger les logs de diagnostic en ouvrant le panneau Cascade, en appuyant sur les trois points en haut à droite, puis en cliquant sur « Download Diagnostics ».

Sur macOS, un message s’affiche : « Windsurf » est endommagé et ne peut pas être ouvert.

Ce message est dû à un faux positif des fonctions de sécurité de macOS. Vous pouvez généralement résoudre le problème en allant dans « Réglages Système -> Confidentialité et sécurité » et en cliquant sur « Autoriser » ou « Ouvrir quand même » pour Windsurf. Si cela échoue ou n’est pas possible, essayez les étapes suivantes :
  1. Assurez-vous que Windsurf se trouve dans votre dossier /Applications et que vous l’exécutez depuis cet emplacement.
  2. Vérifiez le type de processeur : si votre Mac a une puce Intel, assurez-vous d’avoir la version Intel. S’il s’agit d’un Mac avec Apple Silicon (M1, M2 ou M3), assurez-vous d’avoir la version Apple Silicon. Vous pouvez choisir le type de processeur sur la page de téléchargement Mac.
  3. Essayez de retélécharger le DMG et de réinstaller depuis la page de téléchargement officielle, car la fonctionnalité de sécurité incriminée est généralement déclenchée lors du téléchargement.
  4. Assurez-vous que Windsurf (et la fenêtre « Windsurf is Damaged ») est fermé, puis exécutez xattr -c "/Applications/Windsurf.app/".

J’ai reçu un message d’erreur à propos des mises à jour sur Windows, ou les mises à jour n’apparaissent pas sous Windows.

Par exemple :
Les mises à jour sont désactivées car vous exécutez l’installation à portée utilisateur de Windsurf en tant qu’administrateur.
Nous ne pouvons pas mettre à jour automatiquement Windsurf lorsqu’il est lancé en tant qu’administrateur. Veuillez relancer Windsurf avec une installation à portée utilisateur pour effectuer la mise à jour.

Sur macOS, Remote SSH échoue avec “Undefined error: 0” alors que SSH fonctionne dans le Terminal

Si Remote SSH dans Windsurf échoue immédiatement alors que la même connexion SSH fonctionne dans le Terminal, VS Code ou d’autres applications, cela est généralement dû au fait que macOS bloque l’accès de Windsurf au réseau local. Dans le journal de sortie Remote - SSH (View → Output → Remote - SSH), vous verrez :
suivi de SSH server closed unexpectedly. Error code: 255. Le message Undefined error: 0 (plutôt que “Connection refused” ou “Network unreachable”) est l’indicateur clé — c’est l’erreur que macOS renvoie lorsqu’une application ne dispose pas de l’autorisation Réseau local dans Confidentialité & sécurité. Pour résoudre ce problème :
  1. Ouvrez Réglages système → Confidentialité & sécurité → Réseau local.
  2. Recherchez Windsurf dans la liste et activez l’option.
  3. Redémarrez Windsurf et réessayez la connexion.
Si Windsurf n’apparaît pas dans la liste Réseau local, essayez d’abord d’initier une connexion SSH depuis Windsurf pour déclencher la demande d’autorisation de macOS. Si la demande a déjà été ignorée et que l’option n’apparaît pas, la suppression puis la réinstallation de Windsurf relanceront la demande lors du prochain démarrage.

Quels domaines dois-je autoriser dans les filtres/pare-feu réseau, VPN ou proxys ?

Si vous utilisez un filtrage réseau, des pare-feu, des services VPN ou travaillez dans des environnements à accès réseau restreint, vous pourriez rencontrer des problèmes de connectivité avec Windsurf. Pour garantir un fonctionnement fluide, veuillez autoriser les domaines suivants dans votre configuration réseau :
  • *.codeium.com
  • *.windsurf.com
  • *.codeiumdata.com

Sous Linux, Windsurf ne se lance pas (ou plante au démarrage)

C’est généralement dû à un problème d’autorisations d’Electron, que VSCode rencontre également, et c’est attendu lorsque vous utilisez l’archive tar sous Linux. La manière la plus simple de corriger le problème est d’exécuter ce qui suit :
Vous devriez ensuite pouvoir lancer Windsurf. Vous pouvez aussi exécuter windsurf avec l’option --no-sandbox, même si nous ne le recommandons pas. Si cela échoue, essayez ce qui suit.

J’ai reçu un message d’erreur indiquant « Windsurf failed to start »

Attention : la suppression de ces dossiers effacera votre historique de conversation et vos paramètres locaux !
Supprimez le dossier suivant : Windows : C:\Users\<YOUR_USERNAME>\.codeium\windsurf\cascade Linux/Mac : ~/.codeium/windsurf/cascade puis essayez de relancer l’IDE.

Mon panneau Cascade devient blanc

Veuillez nous contacter si cela se produit ! Un enregistrement d’écran nous aiderait beaucoup. Ce problème se résout souvent en effaçant l’historique du Chat (~/.codeium/windsurf/cascade).

La session de terminal semble bloquée dans Cascade

Si une commande dans le terminal a fini de s’exécuter mais que Cascade indique toujours que la session est en cours ou bloquée, cela peut être dû à plusieurs problèmes : Profil de terminal par défaut non défini Cela peut être dû au fait que le profil de terminal par défaut n’est pas explicitement défini. Pour résoudre ce problème, vous pouvez définir le profil de terminal par défaut dans les paramètres de votre éditeur. Ouvrez l’interface des paramètres (Cmd/Ctrl + ,), recherchez “terminal default profile”, et définissez la valeur appropriée pour votre système d’exploitation. Vous pouvez aussi ajouter ce qui suit à votre settings.json : Pour macOS : “terminal.integrated.defaultProfile.osx”: “zsh” Pour Windows : “terminal.integrated.defaultProfile.windows”: “PowerShell” Pour Linux : “terminal.integrated.defaultProfile.linux”: “bash” Remplacez la valeur par votre shell préféré (par exemple, bash, zsh, PowerShell, Command Prompt, etc.). Thèmes zsh personnalisés Dans certains cas, un thème zsh très personnalisé (par exemple, des thèmes provenant de Oh My Zsh, Powerlevel10k ou d’autres frameworks de prompt) peut également amener Cascade à croire qu’une commande est toujours en cours d’exécution alors qu’elle est terminée. Pour vérifier si c’est la cause du problème : ouvrez votre fichier ~/.zshrc dans un éditeur de texte, désactivez temporairement votre thème en commentant les lignes qui le définissent ou le chargent, comme ZSH_THEME="...", source ~/.p10k.zsh ou eval "$(oh-my-posh init zsh)", puis enregistrez le fichier, redémarrez Windsurf (ou ouvrez un nouveau terminal dans Windsurf), puis exécutez à nouveau une commande. Si la session de terminal ne semble plus bloquée dans Cascade, vous pouvez soit conserver un thème plus simple dans ~/.zshrc, soit créer une configuration zsh distincte et minimale utilisée uniquement par le terminal Windsurf afin que vos autres terminaux puissent continuer à utiliser le thème plus complexe. Suivi du contexte du terminal avec systemd (Linux) Sur certaines distributions Linux récentes (signalé à partir de Fedora 43), la chaîne de démarrage du shell (~/.bashrc → /etc/bashrc → /etc/profile.d/80-systemd-osc-context.sh) peut activer le « suivi de contexte du terminal » de systemd, qui émet des séquences d’échappement OSC 3008 via PS0 ou PROMPT_COMMAND. Ces séquences de contrôle supplémentaires peuvent interférer avec l’analyse de la sortie par Cascade, ce qui peut faire apparaître une commande comme bloquée ou donner l’impression que la sortie capturée est manquante ou tronquée — même si le terminal l’affiche correctement. Pour contourner ce problème, empêchez l’émission des séquences de contexte OSC dans le terminal de Cascade en ne chargeant pas /etc/bashrc depuis votre ~/.bashrc, ou en créant un fichier de configuration de shell minimal utilisé uniquement pour Windsurf/Cascade.

Conteneur Docker non visible dans Remote Explorer lors de l’utilisation de WSL

Lors de la connexion à des conteneurs Docker dans WSL, la fenêtre Remote Explorer peut ne pas afficher les conteneurs disponibles pour s’y connecter, ce qui oblige les utilisateurs à utiliser la solution de contournement via la palette de commandes. Utilisez Cmd+P (macOS) ou Ctrl+P (Windows) → “Dev Containers: Attach to Running Container” pour voir la liste complète des conteneurs en cours d’exécution
Pour Windows :
Sous Linux :
Remplacez la valeur par votre shell préféré (par exemple, bash, zsh, PowerShell, Command Prompt, etc.). Thèmes zsh personnalisés Dans certains cas, un thème zsh très personnalisé (par exemple, des thèmes provenant de Oh My Zsh, Powerlevel10k ou d’autres frameworks de prompt) peut également amener Cascade à croire qu’une commande est toujours en cours d’exécution alors qu’elle est terminée. Pour vérifier si c’est la cause du problème :
  1. Ouvrez votre fichier ~/.zshrc dans un éditeur de texte.
  2. Désactivez temporairement votre thème en commentant les lignes qui le définissent ou le chargent, comme ZSH_THEME="...", source ~/.p10k.zsh ou eval "$(oh-my-posh init zsh)".
  3. Enregistrez le fichier, redémarrez Windsurf (ou ouvrez un nouveau terminal dans Windsurf), puis exécutez à nouveau une commande.
Si la session de terminal ne semble plus bloquée dans Cascade, vous pouvez soit conserver un thème plus simple dans ~/.zshrc, soit créer une configuration zsh distincte et minimale utilisée uniquement par le terminal Windsurf afin que vos autres terminaux puissent continuer à utiliser le thème plus complexe. Suivi du contexte du terminal avec systemd (Linux) Sur certaines distributions Linux récentes (signalé à partir de Fedora 43), la chaîne de démarrage du shell (~/.bashrc → /etc/bashrc → /etc/profile.d/80-systemd-osc-context.sh) peut activer le « suivi de contexte du terminal » de systemd, qui émet des séquences d’échappement OSC 3008 via PS0 ou PROMPT_COMMAND. Ces séquences de contrôle supplémentaires peuvent interférer avec l’analyse de la sortie par Cascade, ce qui peut faire apparaître une commande comme bloquée ou donner l’impression que la sortie capturée est manquante ou tronquée — même si le terminal l’affiche correctement. Pour contourner ce problème, empêchez l’émission des séquences de contexte OSC dans le terminal de Cascade en ne chargeant pas /etc/bashrc depuis votre ~/.bashrc, ou en créant un fichier de configuration de shell minimal utilisé uniquement pour Windsurf/Cascade.

Conteneur Docker non visible dans Remote Explorer lors de l’utilisation de WSL

Lors de la connexion à des conteneurs Docker dans WSL, la fenêtre Remote Explorer peut ne pas afficher les conteneurs disponibles pour s’y connecter, ce qui oblige les utilisateurs à utiliser la solution de contournement via la palette de commandes. Utilisez Cmd+P (macOS) ou Ctrl+P (Windows) → “Dev Containers: Attach to Running Container” pour voir la liste complète des conteneurs en cours d’exécution.