AI Code With

Configuration de la clé API Goose

Clé API Goose : définissez votre propre clé dans config.yaml

Collez le bloc ci-dessous dans config.yaml, placez votre propre clé API dans ~/.bashrc, et Goose peut utiliser les modèles Claude. Payez à l'usage.

Démarrer la configurationObtenir une clé API →
~/.config/goose/config.yamlyaml
config
GOOSE_PROVIDER: openai
GOOSE_MODEL: claude-haiku-4-5-20251001
OPENAI_HOST: https://api.aicodewith.ai
OPENAI_BASE_PATH: v1/chat/completions

Étapes de configuration

Enregistrez cette clé pour les terminaux suivants

Une fois connecté, cette commande inclut votre propre clé. Copiez-la, exécutez-la une fois, et l'outil conserve la clé à l'emplacement que nous avons testé.

bash
for rc in "$HOME/.zshrc" "$HOME/.bashrc"; do
  touch "$rc"
  echo 'export OPENAI_API_KEY=sk-***' >> "$rc"
done

Les visiteurs déconnectés ne voient qu'un espace réservé. Connectez-vous et nous remplirons votre clé. Sign in · Obtenir une clé dans la console

Copier ne fait que placer la commande dans le presse-papiers. Vous devez encore l'exécuter dans un terminal, ou coller la clé dans les paramètres de l'outil. Comment obtenir une clé API

Ces étapes ont été testées sur Linux (bash). macOS et Windows n'ont pas encore été testés, donc ils ne sont pas listés.

  1. Goose n'est pas encore installé ? Installez-le (ignorez si déjà installé)

    Exécutez curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash, puis goose --version. Un numéro de version signifie qu'il est installé.

    Installer Goose : curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash (CONFIGURE=false ignore la configuration interactive). Il s'installe dans ~/.local/bin/goose. goose --version affiche 1.54.0

  2. Collez la configuration dans config.yaml

    Ouvrez ~/.config/goose/config.yaml, collez le bloc depuis le haut de cette page, et enregistrez. Vous n'avez plus besoin de les exporter.

    Le point de terminaison dans ~/.config/goose/config.yaml

  3. Placez votre clé API dans ~/.bashrc

    Exécutez echo 'export OPENAI_API_KEY=sk-***' >> ~/.bashrc, en remplaçant sk-*** par votre clé API (Obtenir une clé API). La dernière ligne de ~/.bashrc doit être cette ligne.

    Vérifiez que la dernière ligne de ~/.bashrc est export OPENAI_API_KEY=sk-*** (masquée ici)

  4. Ouvrez un nouveau terminal et testez Goose

    Ouvrez un nouveau terminal et exécutez goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK". OK signifie que Goose utilise votre clé API.

    Vérification : fermez le terminal, ouvrez-en un nouveau, exécutez goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" ; une réponse OK signifie que tout est configuré

  5. Pas de OK ? Identifiez votre erreur

    Comparez l'erreur dans votre terminal avec les Erreurs courantes ci-dessous. Chacune indique la cause et le correctif.

  6. Changer de modèle Goose : modifiez GOOSE_MODEL

    Remplacez le nom du modèle après GOOSE_MODEL dans config.yaml par le nouvel ID de modèle, en respectant exactement l'orthographe. Les ID de modèle se trouvent sur Modèles et tarifs.

Erreurs courantes

Aucune clé définie : échec de l'authentification pour https://api.aicodewith.ai/v1/chat/completions. Statut : 401 Unauthorized. Réponse : {"error":"请在请求中提供有效的 API Key。"}

Ce que vous voyez

error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}.
(English: "Please provide a valid API key in the request.")
Cause
Le terminal n'a pas OPENAI_API_KEY : il n'est pas dans ~/.bashrc, ou vous l'avez ajouté mais vous n'avez pas ouvert un nouveau terminal
Comment corriger
Mettez la clé dans ~/.bashrc comme à l'étape 3, puis ouvrez un nouveau terminal

Revenir à l’étape 3 : Placez votre clé API dans ~/.bashrc →

Aucune clé définie : le nouveau terminal n'a pas OPENAI_API_KEY. Exécuter goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" affiche, deux fois : error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}. (English: "Please provide a valid API key in the request.") suivi de Please retry if you think this is a transient or recoverable error.

Mauvaise clé : échec de l'authentification pour https://api.aicodewith.ai/v1/chat/completions. Statut : 401 Unauthorized. Réponse : {"error":"请在请求中提供有效的 API Key。"}

Ce que vous voyez

error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}.
(English: "Please provide a valid API key in the request.")
Cause
OPENAI_API_KEY dans ~/.bashrc est incorrecte ; l'erreur est la même que sans clé
Comment corriger
Copiez à nouveau la clé depuis la console, corrigez la dernière ligne de ~/.bashrc, puis ouvrez un nouveau terminal

Revenir à l’étape 3 : Placez votre clé API dans ~/.bashrc →

Mauvaise clé : tail -n 1 ~/.bashrc affiche export OPENAI_API_KEY=sk-wrong. Exécuter goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" affiche, deux fois : error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}. (English: "Please provide a valid API key in the request.") — la même chose que sans clé

404 "不支持的请求路径" (chemin de requête non pris en charge)

Ce que vous voyez

404 "不支持的请求路径" (chemin de requête non pris en charge)
Cause
OPENAI_BASE_PATH est incorrect (par exemple nope/chat/completions), donc la requête va vers https://api.aicodewith.ai/nope/chat/completions
Comment corriger
Rétablissez-le sur v1/chat/completions

Revenir à l’étape 2 : Collez la configuration dans config.yaml →

Erreur courante : un OPENAI_BASE_PATH incorrect (ici nope/chat/completions) envoie la requête vers https://api.aicodewith.ai/nope/chat/completions et retourne 404 (chemin non pris en charge). Rétablissez-le sur v1/chat/completions. Remarque : ce relais a encore accepté (testé) un HOST qui inclut déjà /v1, donc ce n'est pas un moyen fiable de détecter un mauvais réglage

FAQ

Comment utiliser ma propre clé API dans Goose ?

Dans ~/.config/goose/config.yaml, définissez GOOSE_PROVIDER: openai, OPENAI_HOST: https://api.aicodewith.ai et OPENAI_BASE_PATH: v1/chat/completions, puis ajoutez export OPENAI_API_KEY=your key à ~/.bashrc.

Le OPENAI_HOST de Goose doit-il inclure /v1 ?

Non. Définissez OPENAI_HOST sur https://api.aicodewith.ai et mettez /v1 dans OPENAI_BASE_PATH.

Goose affiche 401. Que faire maintenant ?

Le terminal n'a pas OPENAI_API_KEY, ou la clé est incorrecte. Voir les erreurs courantes ci-dessus pour la correction.

Goose ne trouve pas le modèle. Que faire maintenant ?

Assurez-vous que GOOSE_MODEL correspond exactement à un Model ID AI Code With.

Sources

Liens connexes

Obtenir une clé API AI Code WithModèles et tarifsAutres intégrations