AI Code With

Configuration de la clé API Kilo Code

Clé API Kilo Code : définissez votre propre clé dans kilo.json

Collez le bloc ci-dessous dans kilo.json, remplacez par votre propre clé API, et Kilo Code peut utiliser les modèles Claude et GPT. Paiement à l'usage.

Commencer la configurationObtenir une clé API →
~/.config/kilo/kilo.jsonjson
config
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}

É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
mkdir -p "$(dirname "$HOME/.config/kilo/kilo.json")"
cat > "$HOME/.config/kilo/kilo.json" << 'EOF'
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}
EOF

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, ils ne sont donc pas listés.

  1. Pas encore de Kilo Code ? Installez-le (ignorez si déjà installé)

    Exécutez npm i -g @kilocode/cli, puis kilo --version. Un numéro de version signifie qu'il est installé.

    Installez la CLI Kilo Code avec npm i -g @kilocode/cli, puis kilo --version affiche 7.8.8 pour confirmer que cela fonctionne

  2. Collez la configuration dans kilo.json et ajoutez votre clé API

    Ouvrez ~/.config/kilo/kilo.json, collez le bloc depuis le haut de cette page, et remplacez sk-*** par votre clé API (Obtenir une clé API). Après l'enregistrement, le fichier contient une ligne "apiKey": "sk-…", et un nouveau terminal ou un redémarrage la conserve.

    Placez la clé directement dans provider.aicodewith.options.apiKey dans ~/.config/kilo/kilo.json (masquée ici sous sk-***)

  3. Ouvrez un nouveau terminal et testez Kilo Code

    Ouvrez un nouveau terminal et exécutez kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK". OK signifie que Kilo Code utilise votre clé API.

    Vérification : fermez le terminal, ouvrez-en un nouveau (sans export), exécutez kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" ; une réponse OK signifie que tout est configuré

  4. Pas de OK ? Identifiez votre erreur

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

  5. Changer de modèle Kilo Code : modifiez le nom après -m

    Après -m, écrivez aicodewith/ suivi d'un modèle listé sous models dans kilo.json, par exemple aicodewith/gpt-5.5. Pour ajouter un modèle, listez d'abord son ID de modèle sous models ; voir Modèles et tarifs.

Erreurs courantes

Aucune clé définie : Error: Unauthorized: 请在请求中提供有效的 API Key。

Ce que vous voyez

Error: Unauthorized: 请在请求中提供有效的 API Key。
(français : « Veuillez fournir une clé API valide dans la requête. »)
Cause
apiKey dans kilo.json est {env:AICODEWITH_API_KEY}, et le nouveau terminal n'a pas cette variable
Comment corriger
Écrivez votre clé directement dans apiKey, comme à l'étape 2

Revenir à l’étape 2 : Collez la configuration dans kilo.json →

Aucune clé définie : apiKey est encore {env:AICODEWITH_API_KEY} et le nouveau terminal n'a pas cette variable. Exécuter kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" affiche : Error: Unauthorized: 请在请求中提供有效的 API Key。 (français : « Veuillez fournir une clé API valide dans la requête. »)

Mauvaise clé : Error: Unauthorized: 请在请求中提供有效的 API Key。

Ce que vous voyez

Error: Unauthorized: 请在请求中提供有效的 API Key。
(français : « Veuillez fournir une clé API valide dans la requête. »)
Cause
apiKey est incorrect ; l'erreur est la même qu'avec aucune clé
Comment corriger
Copiez à nouveau la clé depuis la console et remplacez la valeur entre les guillemets de apiKey

Revenir à l’étape 2 : Collez la configuration dans kilo.json →

Mauvaise clé : grep -n sk-wrong ~/.config/kilo/kilo.json affiche que la ligne 10 est "apiKey": "sk-wrong". Exécuter kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" affiche : Error: Unauthorized: 请在请求中提供有效的 API Key。 (français : « Veuillez fournir une clé API valide dans la requête. ») — identique à l'erreur sans clé

Erreur : Model not found

Ce que vous voyez

Error: Model not found
Cause
Le modèle après -m n'est pas listé sous models dans kilo.json (par exemple aicodewith/no-such-model), donc Kilo Code s'arrête avant d'envoyer une requête
Comment corriger
Utilisez un modèle listé sous models, par exemple aicodewith/gpt-5.5

Revenir à l’étape 3 : Ouvrez un nouveau terminal et testez Kilo Code →

Erreur courante : si le nom du modèle est incorrect (ici aicodewith/no-such-model), kilo renvoie Error: Model not found. Kilo déclenche cette erreur lui-même (le modèle n'est pas listé dans kilo.json), avant qu'une requête ne soit envoyée. Utilisez un modèle listé dans la configuration, par exemple aicodewith/gpt-5.5

FAQ

Comment utiliser ma propre clé API dans Kilo Code ?

Dans ~/.config/kilo/kilo.json, ajoutez un fournisseur aicodewith avec baseURL https://api.aicodewith.ai/v1 et écrivez votre clé dans apiKey. Un nouveau terminal la conserve.

L'URL de base de Kilo Code doit-elle inclure /v1 ?

Oui. Utilisez https://api.aicodewith.ai/v1.

Où se trouve le kilo.json de Kilo Code ?

La configuration globale est ~/.config/kilo/kilo.json.

Kilo Code indique Unauthorized. Que faire ?

apiKey dans kilo.json est manquant ou incorrect. Voir Erreurs courantes ci-dessus pour la correction.

Sources

Liens associés

Obtenir une clé API AI Code WithModèles et tarifsIntégration opencodeAutres intégrations