Connecter applications et agents de code

Choisissez un parcours, configurez l’URL de base et la clé API CostRouter, puis vérifiez la première requête dans les journaux.

Parcours 1

Connecter votre application IA

Conservez votre SDK ou client HTTP compatible. Remplacez uniquement l’URL de base, la clé API et l'ID du modèle.

Première étape recommandée

Tester une première requête

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

  • URL de base: 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 l’URL de base et la variable d’environnement contenant votre clé API. Remplacez YOUR_COSTROUTER_API_KEY et l’identifiant du modèle, puis exécutez les commandes pour démarrer l’outil.

Codex

Codex

Configuration compatible avec CostRouter

Configurer
1

Installer Codex

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

Installer Codex

npm install -g @openai/codex
codex --version
2
Recommandé : tester d’abord

Copiez une commande pour vérifier la connexion

La commande définit la clé API pour la session de terminal actuelle, puis lance Codex avec une configuration CostRouter temporaire. Le fichier config.toml n’est pas modifié. Ces réglages s’appliquent uniquement à cette session.

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"'
3

Configuration permanente

Enregistrez l’adresse du fournisseur et la clé API 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 clé API 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.
Antigravity

Claude Code

Configuration compatible avec CostRouter

Configurer
1

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
2
Recommandé : tester d’abord

Copiez une commande pour vérifier la connexion

Exécutez la commande complète ci-dessous. Elle définit l’URL de base et la clé API pour la session de terminal actuelle, sans modifier les fichiers de configuration. Ces réglages s’appliquent uniquement à cette session.

Terminal actuel (zsh / bash)

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

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 clé API 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

Gemini CLI

Configuration compatible avec CostRouter

Configurer
1

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
2
Recommandé : tester d’abord

Copiez une commande pour vérifier la connexion

Exécutez la commande complète ci-dessous. Elle définit l’URL de base et la clé API pour la session de terminal actuelle, sans modifier les fichiers de configuration. Ces réglages s’appliquent uniquement à cette session.

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
3

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 clé API 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

Cursor

Configuration compatible avec CostRouter

Configurer
1

Installer Cursor

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

Installer Cursor

cursor .
2
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 .
3

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’une URL de base personnalisée 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 clé API 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 URL de base et votre clé API 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 applications IA et agents de code | CostRouter