Connecter applications et agents de code

Choisissez un parcours, configurez la Base URL et l'API Key CostRouter, puis vérifiez la première requête dans les journaux.

Créer une API Key Modèles

Parcours 1

Connecter votre application IA

Conservez votre SDK ou client HTTP compatible. Remplacez uniquement la Base URL, l'API Key et l'ID du modèle.

Première étape recommandée

Première requête fonctionnelle

Exemple curl

curl -X POST "https://costrouter.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_COSTROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: CostRouter connected"
      }
    ],
    "stream": false
  }'

Trois valeurs à configurer

Base URL: https://costrouter.ai/v1
Autorisation: Bearer YOUR_COSTROUTER_API_KEY
Modèle : copiez l'ID exact depuis Modèles

Parcours 2

Configurer un agent de code

Chaque configuration indique le Base URL et la variable d’environnement qui contient votre API Key. Remplacez YOUR_COSTROUTER_API_KEY et le modèle indiqué, puis exécutez les commandes pour démarrer l’outil.

Codex

Configuration compatible avec CostRouter

Configurer

Installer Codex

Installez l’outil ou vérifiez que votre version actuelle démarre correctement.

Installer Codex

npm install -g @openai/codex
codex --version

Recommandé : tester d’abord

Copiez une commande pour vérifier la connexion

La commande exporte l’API Key dans le terminal actuel, puis lance Codex avec un fournisseur CostRouter temporaire. Elle ne modifie pas config.toml et cesse de s’appliquer à la fermeture du terminal.

Terminal actuel (zsh / bash)

export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" && \
codex \
  -c 'model_provider="costrouter"' \
  -c 'model="gpt-5.6-luna"' \
  -c 'model_providers.costrouter.name="CostRouter"' \
  -c 'model_providers.costrouter.wire_api="responses"' \
  -c 'model_providers.costrouter.env_key="OPENAI_API_KEY"' \
  -c 'model_providers.costrouter.base_url="https://costrouter.ai/v1"'

Configuration permanente

Enregistrez l’adresse du fournisseur et l’API Key dans config.toml afin que les prochaines sessions Codex les chargent automatiquement. La clé est stockée en clair sur cet appareil : réservez cette option à un poste personnel et protégez le fichier.

~/.codex/config.toml

model_provider = "costrouter"
model = "gpt-5.6-luna"

[model_providers.costrouter]
name = "CostRouter"
wire_api = "responses"
base_url = "https://costrouter.ai/v1"
experimental_bearer_token = "YOUR_COSTROUTER_API_KEY"

Utilisez une API Key dédiée à cet outil.
Choisissez un modèle disponible dans Modèles.
Redémarrez l'outil et vérifiez la requête dans les journaux.

Claude Code

Configuration compatible avec CostRouter

Configurer

Installer Claude Code

Installez l’outil ou vérifiez que votre version actuelle démarre correctement.

Installer Claude Code

npm install -g @anthropic-ai/claude-code
claude --version

Recommandé : tester d’abord

Copiez une commande pour vérifier la connexion

Exécutez la commande complète ci-dessous. Elle exporte le Base URL et l’API Key dans le terminal actuel sans modifier de fichier de configuration. Les valeurs expirent à la fermeture de ce terminal.

Terminal actuel (zsh / bash)

export ANTHROPIC_BASE_URL="https://costrouter.ai" \
  ANTHROPIC_AUTH_TOKEN="YOUR_COSTROUTER_API_KEY" && \
claude

Configuration permanente

Enregistrez ces valeurs dans le fichier de configuration de l’outil afin de les conserver après le redémarrage.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://costrouter.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_COSTROUTER_API_KEY"
  }
}

Utilisez une API Key dédiée à cet outil.
Choisissez un modèle disponible dans Modèles.
Redémarrez l'outil et vérifiez la requête dans les journaux.

Gemini CLI

Configuration compatible avec CostRouter

Configurer

Installer Gemini CLI

Installez l’outil ou vérifiez que votre version actuelle démarre correctement.

Installer Gemini CLI

npm install -g @google/gemini-cli
gemini --version

Recommandé : tester d’abord

Copiez une commande pour vérifier la connexion

Terminal actuel (zsh / bash)

export GOOGLE_GEMINI_BASE_URL="https://costrouter.ai" \
  GEMINI_API_KEY="YOUR_COSTROUTER_API_KEY" \
  GEMINI_MODEL="gemini-available-model-id" && \
gemini

Configuration permanente

Enregistrez ces valeurs dans le fichier de configuration de l’outil afin de les conserver après le redémarrage.

~/.gemini/settings.json

{
  "env": {
    "GOOGLE_GEMINI_BASE_URL": "https://costrouter.ai",
    "GEMINI_API_KEY": "YOUR_COSTROUTER_API_KEY",
    "GEMINI_MODEL": "gemini-available-model-id"
  }
}

Utilisez une API Key dédiée à cet outil.
Choisissez un modèle disponible dans Modèles.
Redémarrez l'outil et vérifiez la requête dans les journaux.

Cursor

Configuration compatible avec CostRouter

Configurer

Installer Cursor

Installez l’outil ou vérifiez que votre version actuelle démarre correctement.

Installer Cursor

cursor .

Recommandé : tester d’abord

Copiez une commande pour vérifier la connexion

Ces variables sont transmises uniquement à cette instance de Cursor et aux processus du projet. Leur prise en charge par l’Agent intégré dépend toujours de votre version de Cursor.

Terminal actuel (zsh / bash)

export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" \
  OPENAI_BASE_URL="https://costrouter.ai/v1" && \
cursor .

Configuration permanente

Enregistrez ces valeurs dans le fichier .env du projet pour le code et les scripts exécutés dans Cursor. La prise en charge d’un Base URL personnalisé par l’Agent intégré dépend de la version installée.

.env

OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY"
OPENAI_BASE_URL="https://costrouter.ai/v1"

Utilisez une API Key dédiée à cet outil.
Choisissez un modèle disponible dans Modèles.
Redémarrez l'outil et vérifiez la requête dans les journaux.

Gérer les profils d'agents locaux

cc-switch enregistre et change les profils fournisseur locaux. Ajoutez une fois votre Base URL et votre API Key CostRouter.

Obtenir cc-switch

Production

Avant la mise en ligne

Gardez les accès sous contrôle et les coûts visibles lorsque le trafic augmente.

Une clé par application, environnement ou agent.
Définissez les limites de dépenses, l'expiration, les modèles autorisés et les adresses IP.
Consultez les journaux après toute configuration ou changement de modèle.
Chargez les secrets depuis des variables d'environnement ou un coffre-fort.

Connecter votre application IA

Première requête fonctionnelle

Trois valeurs à configurer

Configurer un agent de code

Codex

Installer Codex

Copiez une commande pour vérifier la connexion

Configuration permanente

Claude Code

Installer Claude Code

Copiez une commande pour vérifier la connexion

Configuration permanente

Gemini CLI

Installer Gemini CLI

Copiez une commande pour vérifier la connexion

Configuration permanente

Cursor

Installer Cursor

Copiez une commande pour vérifier la connexion

Configuration permanente

Gérer les profils d'agents locaux

Avant la mise en ligne

Nous contacter