Dpannage

Problmes courants et comment les rsoudre.

Pour dboguer tous les problmes avec OpenCode, vous pouvez consulter les journaux ou les donnes de session qu’il stocke localement.

Journaux

Les fichiers journaux sont crits dans :

macOS/Linux : ~/.local/share/opencode/log/
Windows : %USERPROFILE%\.local\share\opencode\log\

Les fichiers journaux sont nomms avec des horodatages (par exemple, 2025-01-09T123456.log) et les 10 fichiers journaux les plus rcents sont conservs.

Vous pouvez dfinir le niveau de journalisation avec l’option de ligne de commande --log-level pour obtenir plus d’informations de dbogage. Par exemple, opencode --log-level DEBUG.

Stockage

opencode stocke les donnes de session et autres donnes d’application sur le disque dans :

macOS/Linux : ~/.local/share/opencode/
Windows : %USERPROFILE%\.local\share\opencode

Ce rpertoire contient :

auth.json - Donnes d’authentification comme les cls API, les jetons OAuth
log/ - Journaux d’application
project/ - Donnes spcifiques au projet comme les donnes de session et de message
- Si le projet est dans un rpertoire Git, il est stock dans ./<project-slug>/storage/
- S’il n’est pas un rpertoire Git, il est stock dans ./global/storage/

Obtenir de l’aide

Si vous rencontrez des problmes avec OpenCode :

Signaler des problmes sur GitHub

Le meilleur moyen de signaler des bugs ou de demander des fonctionnalits est via notre dpot GitHub :

github.com/anomalyco/opencode/issues

Avant de crer un nouveau problme, recherchez les problmes existants pour voir si le vtre a dj t signal.
Rejoignez notre Discord

Pour de l’aide en temps rel et des discussions communautaires, rejoignez notre serveur Discord :

opencode.ai/discord

Problmes courants

Voici quelques problmes courants et comment les rsoudre.

OpenCode ne dmarre pas

Vrifiez les journaux pour les messages d’erreur
Essayez de lancer avec --print-logs pour voir la sortie dans le terminal
Assurez-vous d’avoir la dernire version avec opencode upgrade

Problmes d’authentification

Essayez de vous rauthentifier avec la commande /connect dans le TUI
Vrifiez que vos cls API sont valides
Assurez-vous que votre rseau permet les connexions l’API du fournisseur

Modle non disponible

Vrifiez que vous tes authentifi auprs du fournisseur
Vrifiez que le nom du modle dans votre configuration est correct
Certains modles peuvent ncessiter un accs ou des abonnements spcifiques

Si vous rencontrez ProviderModelNotFoundError, vous faites trs probablement rfrence un modle de manire incorrecte. Les modles doivent tre rfrencs comme suit : <providerId>/<modelId>

Exemples :

openai/gpt-4.1
openrouter/google/gemini-2.5-flash
opencode/kimi-k2

Pour savoir quels modles sont accessibles, excutez opencode models

ProviderInitError

Si vous rencontrez un ProviderInitError, vous avez probablement une configuration invalide ou corrompue.

Pour rsoudre ce problme :

Vrifiez d’abord que votre fournisseur est correctement configur en suivant le guide des fournisseurs
Si le problme persiste, essayez d’effacer votre configuration stocke :
Fenêtre de terminal
```
rm -rf ~/.local/share/opencode
```
Rauthentifiez-vous avec votre fournisseur en utilisant la commande /connect dans le TUI.

AI_APICallError et problmes de package de fournisseur

Si vous rencontrez des erreurs d’appel API, cela peut tre d des packages de fournisseur obsoltes. opencode installe dynamiquement des packages de fournisseur (OpenAI, Anthropic, Google, etc.) selon les besoins et les met en cache localement.

Pour rsoudre les problmes de package de fournisseur :

Effacez le cache du package de fournisseur :
Fenêtre de terminal
```
rm -rf ~/.cache/opencode
```
Redmarrez opencode pour rinstaller les derniers packages de fournisseur

Cela forcera opencode tlcharger les versions les plus rcentes des packages de fournisseur, ce qui rsout souvent les problmes de compatibilit avec les paramtres de modle et les changements d’API.

Copier/coller ne fonctionne pas sur Linux

Les utilisateurs Linux doivent avoir l’un des utilitaires de presse-papiers suivants installs pour que la fonctionnalit copier/coller fonctionne :

Pour les systmes X11 :

apt install -y xclip
# ou
apt install -y xsel

Pour les systmes Wayland :

apt install -y wl-clipboard

Pour les environnements sans interface graphique :

apt install -y xvfb
# et excutez :
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

opencode dtectera si vous utilisez Wayland et prfrera wl-clipboard, sinon il essaiera de trouver des outils de presse-papiers dans l’ordre : xclip et xsel.