# Goose

> Ajoutez Tchavi à Goose avec un fichier de fournisseur prêt à l'emploi et faites-le tourner sur des crédits rechargés par mobile money.

- Canonical: https://tchavi.com/fr/docs/coding-agents/goose

---


Fait partie des guides [agents de code](/docs/coding-agents).

Goose est un agent open source qui tourne dans votre terminal ou en application de bureau et travaille sur votre projet avec le modèle de votre choix. Il charge des fournisseurs supplémentaires depuis des fichiers JSON, et Tchavi en publie un : Tchavi apparaît donc dans la liste des fournisseurs de Goose comme un fournisseur intégré.

## 1. Télécharger le fichier du fournisseur

Goose lit chaque fichier `.json` de son dossier `custom_providers` au démarrage.

Sur macOS ou Linux :

```bash
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://tchavi.com/goose/tchavi.json -o ~/.config/goose/custom_providers/tchavi.json
```

Sur Windows, dans PowerShell :

```powershell
$dir = "$env:APPDATA\Block\goose\config\custom_providers"
New-Item -ItemType Directory -Force $dir | Out-Null
Invoke-WebRequest https://tchavi.com/goose/tchavi.json -OutFile "$dir\tchavi.json"
```

Si Goose Desktop était ouvert, quittez-le et rouvrez-le. Voici le fichier complet :

```json
{
  "name": "tchavi",
  "engine": "openai",
  "display_name": "Tchavi",
  "description": "One API key for 100+ text, image, video and audio models, paid with mobile money from a single credit balance.",
  "api_key_env": "TCHAVI_API_KEY",
  "base_url": "https://tchavi.com/api/v1",
  "dynamic_models": true,
  "models": [
    { "name": "claude-sonnet-5-5", "context_limit": 1000000 },
    { "name": "gpt-6-sol", "context_limit": 272000 },
    { "name": "deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true,
  "model_doc_link": "https://tchavi.com/models?utm_source=goose&utm_medium=docs",
  "setup_steps": [
    "Create an account at https://tchavi.com/register?utm_source=goose&utm_medium=docs",
    "Top up your credit balance with mobile money at https://tchavi.com/dashboard/billing?utm_source=goose&utm_medium=docs",
    "Create an API key at https://tchavi.com/dashboard/api-keys?utm_source=goose&utm_medium=docs",
    "Paste the key above as TCHAVI_API_KEY",
    "Full guide: https://tchavi.com/docs/coding-agents/goose?utm_source=goose&utm_medium=docs"
  ]
}
```

Le fichier ne contient aucune clé. Il nomme seulement la variable où Goose va la lire, `TCHAVI_API_KEY`. Les textes du fichier sont en anglais, la langue de l'interface de Goose.

## 2. Renseigner la clé

Créez une clé dans le [tableau de bord](/dashboard/api-keys) et rechargez votre solde depuis la [page de facturation](/dashboard/billing) avant le premier appel. [Paiements mobile money](/docs/payments) liste les pays et les opérateurs.

Dans le terminal, exportez la clé dans le shell depuis lequel vous lancez Goose :

```bash
export TCHAVI_API_KEY=sk-tch-votre-cle
```

Dans Goose Desktop, ouvrez **Settings**, puis **Models**, puis **Configure providers**, choisissez **Tchavi** et collez la clé. Goose la garde dans le trousseau de votre système.

## 3. Envoyer un premier prompt

Depuis le dossier d'un projet :

```bash
goose session --provider tchavi --model deepseek-v4.1-flash
```

Puis demandez quelque chose qui oblige Goose à utiliser ses outils :

```text
Liste les fichiers de ce dossier et dis-moi en deux phrases ce que fait ce projet.
```

Pour une seule exécution, sans session interactive :

```bash
goose run --provider tchavi --model deepseek-v4.1-flash -t "Résume le README en trois points."
```

Pour faire de Tchavi le choix par défaut, définissez `GOOSE_PROVIDER=tchavi` et `GOOSE_MODEL=deepseek-v4.1-flash`, ou choisissez-les une fois dans `goose configure`.

## Modèles

Le fichier déclare trois modèles pour que le sélecteur ne soit jamais vide :

| Modèle                | Bien pour                                               |
| --------------------- | ------------------------------------------------------- |
| `claude-sonnet-5-5`   | Le choix par défaut pour la plupart du code             |
| `gpt-6-sol`           | Une alternative qui prend en charge les appels d'outils |
| `deepseek-v4.1-flash` | Les modifications courantes et les tâches de fond       |

Comme `dynamic_models` est activé, Goose demande aussi la liste complète à Tchavi (`GET /v1/models`) avec votre clé : tout identifiant renvoyé par cet endpoint fonctionne avec `--model`. Goose pilote votre projet par des appels d'outils : choisissez un modèle dont `capabilities.tools` vaut `true` dans cette liste. Les prix de chaque modèle sont dans le [catalogue](/models).

<Callout type="note" title="Pourquoi 272 000 pour gpt-6-sol">
  `context_limit` indique à Goose la place dont dispose un modèle. GPT-6 Sol accepte davantage, mais
  un prompt de plus de 272 000 tokens est facturé à son tarif plus élevé pour les prompts longs,
  affiché sur sa [page modèle](/m/openai/gpt-6-sol). Augmentez ce nombre dans votre copie du fichier
  si vous voulez toute la fenêtre.
</Callout>

<Callout type="warning" title="Gardez la clé hors du fichier">
  N'écrivez jamais la clé dans `tchavi.json`. Les équipes partagent souvent leurs fichiers de
  fournisseurs ou les commitent, et la clé partirait avec. La variable d'environnement ou le
  trousseau sont les bons endroits.
</Callout>

## Quand quelque chose échoue

| Ce que vous voyez                          | Ce que cela signifie                                    | Solution                                                                                            |
| ------------------------------------------ | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `missing required key TCHAVI_API_KEY`      | Goose n'a trouvé aucune clé                             | Exportez-la dans le shell depuis lequel vous lancez Goose, ou collez-la dans Goose Desktop          |
| `401` / `invalid_api_key`                  | La clé est fausse, révoquée ou n'est pas une clé Tchavi | Créez une nouvelle clé dans le [tableau de bord](/dashboard/api-keys) ; elle commence par `sk-tch-` |
| `402` / `insufficient_credits`             | Votre solde est trop bas pour cette requête             | Rechargez depuis la [page de facturation](/dashboard/billing) ; voir [paiements](/docs/payments)    |
| `404` / `model_not_found`                  | Aucun modèle n'a cet identifiant                        | Vérifiez l'orthographe avec `GET /v1/models`                                                        |
| `403` / `model_not_allowed`                | Ce modèle existe mais n'est pas disponible              | Choisissez un autre identifiant dans `GET /v1/models`                                               |
| Tchavi absent de la liste des fournisseurs | Le fichier n'est pas dans le dossier `custom_providers` | Vérifiez le chemin et l'extension `.json`, puis redémarrez Goose                                    |

Chaque requête envoyée par Goose apparaît dans **Usage** du tableau de bord, avec son modèle, ses tokens et les crédits débités.

---

Retour aux [agents de code](/docs/coding-agents)

