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.
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
Configuration compatible avec CostRouter
Configurer
Codex
Configuration compatible avec CostRouter
Installer Codex
Installez l’outil ou vérifiez que votre version actuelle démarre correctement.
Installer Codex
npm install -g @openai/codex
codex --versionCopiez 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"'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.
Claude Code
Configuration compatible avec CostRouter
Configurer
Claude Code
Configuration compatible avec CostRouter
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 --versionCopiez 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" && \
claudeConfiguration 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 CLI
Configuration compatible avec CostRouter
Configurer
Gemini CLI
Configuration compatible avec CostRouter
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 --versionCopiez 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" && \
geminiConfiguration 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
Configuration compatible avec CostRouter
Configurer
Cursor
Configuration compatible avec CostRouter
Installer Cursor
Installez l’outil ou vérifiez que votre version actuelle démarre correctement.
Installer Cursor
cursor .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’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.
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.