Configuration de la clé API Kimi Code

Clé API Kimi Code : définissez votre propre clé dans config.toml

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

~/.kimi-code/config.tomltoml
config
# ~/.kimi-code/config.toml
default_model = "aicodewith/claude-haiku-4-5-20251001"

[providers.aicodewith]
type = "openai"
base_url = "https://api.aicodewith.ai/v1"
api_key = "sk-***"

[models."aicodewith/claude-haiku-4-5-20251001"]
provider = "aicodewith"
model = "claude-haiku-4-5-20251001"
max_context_size = 200000

É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/.kimi-code/config.toml")"
cat > "$HOME/.kimi-code/config.toml" << 'EOF'
# ~/.kimi-code/config.toml
default_model = "aicodewith/claude-haiku-4-5-20251001"

[providers.aicodewith]
type = "openai"
base_url = "https://api.aicodewith.ai/v1"
api_key = "sk-***"

[models."aicodewith/claude-haiku-4-5-20251001"]
provider = "aicodewith"
model = "claude-haiku-4-5-20251001"
max_context_size = 200000
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 Kimi Code ? Installez-le (ignorez si déjà installé)

    Exécutez le script d'installation de Kimi curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash, puis kimi --version. Un numéro de version indique qu'il est installé.

    Installez kimi-code avec curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Il s'installe dans ~/.kimi-code/bin/kimi. KIMI_NO_MODIFY_PATH=1 dans la capture d'écran concerne uniquement notre machine de test ; vous n'en avez pas besoin. kimi --version affiche 2.1.1
  2. Collez la configuration dans config.toml et ajoutez votre clé API

    Ouvrez ~/.kimi-code/config.toml, collez le bloc en haut de cette page, et remplacez sk-*** par votre clé API (Obtenir une clé API). Après avoir sauvegardé, le fichier contient une ligne api_key = "sk-…".

    Dans [providers.aicodewith], définissez api_key = "sk-***" (masqué)
  3. Ouvrez un nouveau terminal et testez Kimi Code

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

    Vérification : fermez le terminal, ouvrez-en un nouveau, exécutez kimi -m aicodewith/claude-haiku-4-5-20251001 -p "Reply with exactly: OK" ; une réponse • OK signifie que c'est configuré
  4. Pas de OK ? Identifiez votre erreur

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

  5. Changer de modèle Kimi Code : modifiez le nom du modèle

    Remplacez le nom du modèle dans default_model et dans le bloc [models."…"] par le nouvel ID de modèle, et utilisez le même nom après -m dans la commande de test. Les ID de modèle se trouvent sur Modèles et tarifs.

Erreurs courantes

error: failed to run prompt: Provider "aicodewith" declares api_key_env = "AICODEWITH_API_KEY" in config.toml, but the environment variable is not set or is empty.

Ce que vous voyez

error: failed to run prompt: Provider "aicodewith" declares api_key_env = "AICODEWITH_API_KEY" in config.toml, but the environment variable is not set or is empty.
Cause
config.toml a api_key_env, mais AICODEWITH_API_KEY n'est pas défini dans le terminal
Comment corriger
Supprimez la ligne api_key_env et écrivez api_key = "votre clé" comme à l'étape 2

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

Aucune clé définie : config.toml utilise api_key_env = "AICODEWITH_API_KEY" et le nouveau terminal n'a pas cette variable. kimi échoue avec Provider "aicodewith" declares api_key_env … but the environment variable is not set or is empty.

error: failed to run prompt: provider.auth_error: 401 "请在请求中提供有效的 API Key。"

Ce que vous voyez

error: failed to run prompt: provider.auth_error: 401 "请在请求中提供有效的 API Key。"
(English: "Please provide a valid API key in the request.")
Cause
La valeur api_key est incorrecte
Comment corriger
Copiez à nouveau la clé depuis la console et remplacez la valeur entre guillemets

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

Avec une clé incorrecte (sk-wrong) : error: failed to run prompt: provider.auth_error: 401 "请在请求中提供有效的 API Key。"

404 "不支持的请求路径" (unsupported request path)

Ce que vous voyez

error: failed to run prompt: provider.api_error: 404 "不支持的请求路径,请检查 API 地址是否正确 (request_id: req_1791793075991_6c21900c)"
English: failed to run prompt: provider API error 404, unsupported request path, please check that the API address is correct (request_id: req_1791793075991_6c21900c)
Cause
base_url défini sur "https://api.aicodewith.ai/nope"
Comment corriger
Restaurez base_url sur https://api.aicodewith.ai/v1.

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

Une fenêtre montre la mauvaise ligne de configuration base_url = "https://api.aicodewith.ai/nope" puis kimi -m aicodewith/claude-haiku-4-5-20251001 -p "Reply with exactly: Hello from aicodewith.ai". Erreur réelle : error: failed to run prompt: provider.api_error: 404 "不支持的请求路径,请检查 API 地址是否正确 (request_id: req_1791793075991_6c21900c)". Anglais : failed to run prompt: provider API error 404, unsupported request path, please check that the API address is correct (request_id: req_1791793075991_6c21900c). base_url a été restauré sur https://api.aicodewith.ai/v1 par la suite, et une exécution normale a répondu Hello from aicodewith.ai.

FAQ

Comment utiliser ma propre clé API dans Kimi Code ?

Dans ~/.kimi-code/config.toml sous [providers.aicodewith], écrivez api_key = "votre clé" et définissez base_url sur https://api.aicodewith.ai/v1. Un nouveau terminal la conserve.

Pourquoi export OPENAI_API_KEY ne fonctionne-t-il pas ?

Kimi Code ne lit pas OPENAI_API_KEY. Placez la clé API dans le fichier de configuration.

Où se trouve le config.toml de Kimi Code ?

Par défaut ~/.kimi-code/config.toml. Déplacez la racine des données avec KIMI_CODE_HOME.

Kimi Code peut-il ajouter la clé API sans modifier le fichier ?

Oui. Tapez /provider dans Kimi Code, ou exécutez kimi provider dans le terminal et suivez les invites.

Que signifie type = "openai" ?

Kimi Code envoie les requêtes au format API OpenAI. AI Code With accepte ce format, vous définissez donc uniquement base_url et api_key.

Sources

Liens associés