Goose avec un hôte OpenAI personnalisé

Définissez ces quatre variables avant de lancer Goose, et Goose fonctionne avec les modèles Claude, GPT et Grok grâce à votre clé AIGROW.

Vous avez déjà un code ? Utilisez-le sur l’accès API, puis créez une clé.

Shell, avant de lancer goose

export GOOSE_PROVIDER=openai
export OPENAI_HOST=https://aigrow.gg
export OPENAI_API_KEY=ag_your_key_here
export GOOSE_MODEL=claude-opus-5.5

Remplacez ag_your_key_here par une clé obtenue sur l’accès API.

Où se trouve le réglage

Fournisseurs personnalisés, macOS et Linux
~/.config/goose/custom_providers/
Fournisseurs personnalisés, Windows
%APPDATA%\Block\goose\config\custom_providers\

Ou un fournisseur personnalisé

Enregistrez ce fichier sous le nom aigrow.json dans le dossier des fournisseurs personnalisés. Ici, base_url est l’adresse complète des chat completions.

{
  "name": "aigrow",
  "engine": "openai",
  "display_name": "AIGROW",
  "api_key_env": "AIGROW_API_KEY",
  "base_url": "https://aigrow.gg/v1/chat/completions",
  "models": [
    {
      "name": "claude-opus-5.5",
      "context_limit": 1000000
    },
    {
      "name": "grok-4.7",
      "context_limit": 500000
    }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Lancez ensuite une session avec ce fournisseur

Le fichier du fournisseur lit la clé dans AIGROW_API_KEY.

export AIGROW_API_KEY=ag_your_key_here
goose session start --provider aigrow

Quel modèle choisir

Saisissez l’identifiant exactement comme il est écrit ici.

Claude Opus 5.5claude-opus-5.5
Le modèle par défaut dans chaque bloc de cette page, et le modèle Claude le moins cher ici par token envoyé et reçu. Contexte : 1 000 000 tokens.
Grok 4.7grok-4.7
Le prix de sortie le plus bas ici. Son contexte fait la moitié de celui des modèles Claude. Contexte : 500 000 tokens.
GPT-6 Astragpt-6-astra
Pour un modèle GPT. Il coûte autant par token que Fable, et plus qu’Opus. Contexte : 1 050 000 tokens.
Claude Fable 5.1claude-fable-5.1
Coûte plus cher par token qu’Opus. Comparez les deux dans le classement du code avant de changer. Contexte : 1 000 000 tokens.

La grille tarifaire indique chaque identifiant et son tarif en crédits, les tarifs de l’API Claude donnent les prix publics, et le classement des modèles pour le code compare les modèles sur des requêtes de programmation.

Vérifier que tout fonctionne

D’abord la clé seule, puis Goose avec cette clé.

La clé

Demandez la liste des modèles. Il faut une clé valide, et cela ne coûte rien.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Avec une clé valide, vous recevez la liste en retour :

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    ...
  ],
  "has_more": false
}

Goose

Exécutez une requête avec le modèle indiqué.

goose run --model claude-opus-5.5 -t "Reply with the word ready"

Si la configuration fonctionne, la réponse s’affiche :

ready

En cas d’échec

D’abord les erreurs propres à Goose, puis les réponses que l’endpoint renvoie à n’importe quel outil.

404 à chaque requête
OPENAI_HOST correspond à la racine, https://aigrow.gg, sans rien après : Goose ajoute lui-même v1/chat/completions. Si vous avez modifié OPENAI_BASE_PATH, remettez-le sur v1/chat/completions.
401 No api key passed in
Goose n’a pas chargé la clé. Il ignore une clé écrite dans config.yaml : exportez donc OPENAI_API_KEY dans le shell ou enregistrez-la depuis Goose Desktop.
goose configure n’accepte pas l’identifiant du modèle
goose configure ne propose que les modèles qu’il connaît. Définissez plutôt GOOSE_MODEL, ou ajoutez --model quand vous lancez goose.
Mon outil affiche une erreur 401 ou d’authentification
La clé est absente ou mal saisie. Copiez-la de nouveau depuis Accès API sur le tableau de bord, et vérifiez qu’elle est bien transmise comme clé, et non comme nom de modèle. Une clé révoquée provoque la même erreur : créez-en une nouvelle et remplacez-la.
J’obtiens une erreur 402 ou un message sur le crédit
Votre solde est vide. Ouvrez Accès API sur le tableau de bord, activez un code ou achetez un autre pack, et la requête suivante passera. Rien d’autre à modifier.
J’obtiens une erreur 404 ou « Unknown model »
Le modèle doit être l’un de ceux que l’endpoint propose, par exemple claude-opus-5.5. Les écritures propres aux fournisseurs fonctionnent aussi (claude-opus-5-5, anthropic/claude-opus-5.5), mais un identifiant daté ou tout modèle hors du catalogue est rejeté avant que la requête soit transmise, et rien n’est facturé. Envoyez GET /v1/models avec votre clé pour obtenir la liste à jour, ou consultez les identifiants dans la grille tarifaire.
Les requêtes sont rejetées avec l’erreur 429
La capacité de l’endpoint est partagée entre tous les clients : environ 20 requêtes par minute et 4 simultanément. Chaque erreur 429 contient un en-tête retry-after, et les SDK OpenAI et Anthropic attendent ce délai puis réessaient automatiquement. Dans votre propre boucle, attendez le nombre de secondes indiqué ou réduisez le nombre de requêtes simultanées.
Le modèle est indisponible pour le moment
Une erreur 404 indiquant que le modèle n’est pas disponible pour le moment signifie qu’il est brièvement hors service chez le fournisseur en amont. Ce n’est pas un problème lié à votre clé ou à votre solde. Réessayez dans un instant ou envoyez la requête à un autre modèle.
J’obtiens une erreur 502 ou 503
Un incident passager en amont ou de configuration, sans débit sur votre solde. Réessayez la requête ; si l’échec persiste, contactez-nous via la boutique et nous examinerons le problème.

Ce qui ne fonctionne pas avec AIGROW

  • Une clé dans config.yaml. Goose la lit dans l’environnement ou dans son trousseau, jamais dans ce fichier.

  • Recherche web en direct au sein du modèle. Un outil de recherche web envoyé avec une requête reçoit une réponse fondée sur ce que le modèle sait déjà, sans résultats en direct. Un outil qui récupère des pages sur votre propre machine continue de fonctionner.

  • Tout point d’accès autre que ces trois : /v1/messages, /v1/chat/completions et /v1/models. L’API Responses, les embeddings et le comptage de tokens renvoient une erreur 404.

  • Les champs de routage tels que models, route, provider et plugins. Ils sont ignorés : une requête va donc toujours au seul modèle qu’elle indique.

Ce que coûte un mois d’utilisation de Goose

L’utilisation de Goose est facturée au token, aux tarifs en crédits de la grille tarifaire. Un agent renvoie toute la conversation à chaque étape : une longue tâche coûte donc plus que son dernier message ne le laisse penser. Le journal d’activité de l’accès API indique le coût de chaque requête.

Questions sur Goose et une API personnalisée

OPENAI_HOST inclut-il /v1 ?
Non. OPENAI_HOST vaut https://aigrow.gg, c’est-à-dire la racine, et Goose ajoute v1/chat/completions à partir de OPENAI_BASE_PATH. Un fichier de fournisseur personnalisé fonctionne autrement : son base_url est l’adresse complète des chat completions.
Puis-je ajouter AIGROW dans Goose Desktop ?
Oui. Sous Settings > Models > Configure providers, choisissez Add Custom Provider, puis définissez le type sur OpenAI compatible, l’URL de l’API, votre clé et les identifiants de modèle.
Comment utiliser un modèle que goose configure n’affiche pas ?
Définissez GOOSE_MODEL avec l’identifiant, par exemple claude-opus-5.5, ou lancez goose run --model suivi de l’identifiant.

Sources : Goose Providers. Consulté le 21 octobre 2026.

Configurer un autre outil

  • Claude CodeProtocole Anthropic

    Quatre variables d’environnement, dans le shell ou dans settings.json.

  • ClineProtocole OpenAI

    Le fournisseur OpenAI Compatible, quatre champs dans l’écran des paramètres.

  • Roo CodeProtocole OpenAI

    Le fournisseur OpenAI Compatible, avec les mêmes champs que dans Cline.

  • Kilo CodeProtocole OpenAI

    Un fournisseur personnalisé dans l’onglet Providers ; la liste des modèles se remplit toute seule.

  • ContinueProtocole OpenAI

    Une entrée models dans config.yaml, avec provider openai et un apiBase.

  • AiderProtocole OpenAI

    OPENAI_API_BASE et OPENAI_API_KEY, puis openai/ avant l’identifiant du modèle.

  • OpenCodeProtocole OpenAI

    Un bloc provider dans opencode.json et la clé via /connect.

  • ZedProtocoles Anthropic et OpenAI

    Un fournisseur compatible Anthropic pour Claude, un fournisseur compatible OpenAI pour GPT et Grok.

  • Vercel AI SDKProtocoles Anthropic et OpenAI

    Le fournisseur OpenAI Compatible pour tous les modèles, ou le fournisseur Anthropic pour Claude.

  • OpenAI Agents SDKProtocole OpenAI

    Votre propre client AsyncOpenAI, basculé sur chat completions, avec le traçage désactivé.

  • LangChainProtocoles Anthropic et OpenAI

    ChatOpenAI avec base_url pour tous les modèles, ou ChatAnthropic pour Claude.

Le guide de l’API présente les SDK, curl, les endpoints et les limites de débit.

Collez le bloc : Goose fonctionne alors avec votre crédit.

Achetez un pack de crédits, utilisez le code reçu par e-mail sur l’accès API, créez une clé et placez-la à la place de ag_your_key_here.