---
## Installation
```bash
opencode plugin add @slkiser/opencode-quota
```
Redémarrez OpenCode et tapez `/quota`. Une fenêtre s'ouvre avec vos limites. Cliquez sur un onglet (Usage, Limits, Plugin ou l'un des onglets Settings) ou appuyez sur `tab` pour passer de l'un à l'autre ; cliquez ou appuyez sur `esc` pour la fermer.
> [!IMPORTANT]
> Il vous faut OpenCode `2.0.26+` ; les commandes du terminal nécessitent aussi Node.js `22.13+` ou `23.4+`. Encore sur OpenCode 1 ? Lancez plutôt `npx @slkiser/opencode-quota@4 init`.
Modifier opencode.json vous-même
Ajoutez le plugin à `opencode.jsonc` ou `opencode.json`, en gardant vos autres plugins. Dans `~/.config/opencode`, il fonctionne dans tous les projets ; dans le dossier d'un projet, seulement dans celui-ci. Cette seule entrée charge à la fois le serveur et la TUI :
```jsonc
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@slkiser/opencode-quota"],
}
```
## Fonctionnalités
- **Conçu pour OpenCode 2 :** les paramètres s'appliquent en direct, dans chaque OpenCode ouvert.
- **Terminal :** `npx @slkiser/opencode-quota@latest show` fonctionne même quand OpenCode est fermé.
- **Web et Desktop :** `/quota`, `/quota_usage` et `/quota_status` publient leur rapport dans le chat sous forme de message de votre part. L'IA n'y répond jamais, et le plugin le retire de chaque requête envoyée à l'IA. Une fois le plugin désinstallé, les anciens rapports des chats passés ne sont plus filtrés. La police du Web n'aligne pas toujours les colonnes.
- **Scripts et barres d'état :** JSON, un fichier d'export et des métriques. Voir [Intégration externe](../external-integration.md).
## Commandes
| Commande | Ce qu'elle affiche |
| --- | --- |
| `/quota` | Limites. Web et Desktop : les limites à côté de la consommation des 7 derniers jours |
| `/quota_usage [range]` | Tokens et coût API : `today` (par défaut), `24h`, `7d`, `30d`, `90d`, `all`, `session` (avec ses sous-agents), `between` deux dates |
| `/quota_status` | Vérification de la configuration : connexions, fournisseurs, tarifs et avis |
| `/quota_settings` | Onglets de paramètres (TUI uniquement) |
Par exemple `/quota_usage 30d` ou `/quota_usage between 2026-09-01 2026-09-25`. Dans un terminal, qu'OpenCode soit ouvert ou fermé, `npx @slkiser/opencode-quota@latest show` affiche votre quota et `npx @slkiser/opencode-quota@latest status` vérifie votre configuration ([ce qui les distingue](../troubleshooting.md#terminal-commands)). Ajoutez `--help` pour voir toutes les options.
## Paramètres
Modifiez la barre latérale, la ligne d'état, les toasts, les couleurs, les formulations et les fournisseurs dans `/quota_settings`. **Save** n'écrit que ce que vous avez modifié dans `opencode-quota/settings.jsonc`, dans le dossier de configuration d'OpenCode, et conserve vos commentaires. Une modification du fichier atteint chaque TUI ouverte en quelques secondes. Les fournisseurs personnalisés, le chemin du Claude CLI et le chemin d'export se définissent uniquement dans le fichier. [Paramètres et valeurs par défaut](../configuration.md).
## Fournisseurs
Connectez-vous avec `/connect` et le fournisseur apparaît. Activez ou désactivez les fournisseurs dans `/quota_settings` → **Providers**.
\* Les noms avec un lien demandent une étape de plus ; les autres fonctionnent dès que vous êtes connecté. [Ce que chacun remonte](../providers.md#pre-configured-providers).
Le quota ChatGPT d'OpenAI nécessite une connexion Codex ([comment faire](../providers.md#openai-and-xai)). Gemini CLI ne fonctionne qu'avec les comptes Gemini Code Assist Standard ou Enterprise (organisation). Les utilisateurs Google particuliers doivent utiliser Google AGY. Les offres Entreprise des fournisseurs chinois n'affichent que la consommation de votre propre clé d'API de membre, sauf Alibaba Token Plan, qui affiche une ligne Credits par siège d'équipe. Les clés d'API proviennent d'OpenCode ou d'une [variable d'environnement](../providers.md#api-keys).
### Fournisseurs personnalisés
Suivez n'importe quel autre fournisseur, à partir de son API de quota ou d'une estimation locale. Demandez à votre agent d'ajouter un fournisseur personnalisé : il est enregistré désactivé, et vous l'activez dans `/quota_settings` → **Providers**. [Prompt à copier-coller](../providers.md#custom-providers).
## Mise à jour
```bash
opencode plugin update
```
Redémarrez OpenCode. Vous venez de la 4.x ou de la 5.x ? Vos paramètres sont convertis au premier démarrage, et les anciennes commandes `/tokens_*` fonctionnent toujours. Voir [Mise à jour](../updating.md).
## Dépannage
1. Lancez `/quota_status` dans une session OpenCode, ou `npx @slkiser/opencode-quota@latest status` dans un terminal.
2. Un fournisseur manque ? Reconnectez-vous à ce fournisseur dans OpenCode 2.
3. Vous utilisez un plugin compagnon (Cursor, Google) ? Placez-le **avant** `@slkiser/opencode-quota` dans `opencode.json`.
4. `claude` ou `bl` introuvable ? Voir [Environnement du service](../troubleshooting.md#service-environment).
5. `/quota_usage` est vide ? Lancez OpenCode une fois, puis utilisez un modèle.
D'autres solutions : [Dépannage](../troubleshooting.md).
## Références
Guides : [Configuration](../configuration.md) · [Fournisseurs](../providers.md) · [Dépannage](../troubleshooting.md) · [Intégration externe](../external-integration.md) · [Mise à jour](../updating.md)
Liens externes : [Documentation OpenCode](https://opencode.ai/docs/) · [Configuration OpenCode](https://opencode.ai/docs/config/) · [Plugins OpenCode](https://opencode.ai/docs/plugins/) · [TUI OpenCode](https://opencode.ai/docs/tui/) · [Données de tarifs models.dev](https://models.dev/) · [Téléchargements Node.js](https://nodejs.org/en/download)
## Contributeurs
Merci à toutes les personnes qui ont contribué à OpenCode Quota.
## Licence
MIT. OpenCode Quota n'est pas développé par l'équipe d'OpenCode et n'est affilié ni à OpenCode ni à aucun des fournisseurs listés ci-dessus.
