Utiliser OneAster dans CC-Switch

Introduction

CC-Switch est une application de bureau open source qui unifie la gestion des configurations de fournisseurs d’API sur plusieurs outils CLI de codage IA tels que Claude Code, Codex et Gemini CLI. Elle transforme l’édition fastidieuse de fichiers de configuration en quelques clics dans une interface graphique — une fois qu’un fournisseur est ajouté, vous pouvez basculer instantanément entre les services API, sans avoir à éditer les fichiers de configuration à la main. En connectant OneAster via CC-Switch, vous pouvez facilement configurer le service OneAster pour Claude Code et Codex, et basculer librement entre plusieurs fournisseurs.

Prérequis

Avant de commencer, assurez-vous d’avoir :

Un outil CLI pris en charge installé Au moins un outil CLI pris en charge installé, comme Claude Code ou Codex CLI
Obtenu une clé API OneAster Connectez-vous à la console OneAster pour obtenir votre clé API (commence par sk-)

Astuce : si vous n’avez pas encore de compte OneAster, inscrivez-vous d’abord sur OneAster et obtenez votre clé API.

Étape 1 : Installer CC-Switch

Choisissez la méthode d’installation selon votre système d’exploitation :

macOS
Windows
Linux

Installer via Homebrew (recommandé) :

brew tap farion1231/ccswitch
brew install --cask cc-switch

Vous pouvez également télécharger l’installeur .dmg depuis les GitHub Releases. CC-Switch est signé et notarisé par Apple, donc il peut être installé directement (nécessite macOS 12 ou plus récent).

Téléchargez l’installeur .msi ou le .zip portable depuis les GitHub Releases.Nécessite Windows 10 ou plus récent.

Téléchargez le paquet approprié depuis les GitHub Releases :

Debian / Ubuntu : paquet .deb
Fedora / RHEL : paquet .rpm
Universel : format .AppImage
Arch Linux : paru -S cc-switch-bin

Au premier lancement, CC-Switch détecte automatiquement les outils CLI installés sur votre machine et peut importer les configurations existantes comme fournisseurs par défaut.

Étape 2 : Ajouter le fournisseur OneAster

En haut de la fenêtre principale de CC-Switch, vous pouvez basculer entre différents groupes d’outils CLI. Suivez les étapes ci-dessous selon l’outil que vous voulez configurer.

Configurer pour Claude Code
Configurer pour Codex

1. Basculer vers le groupe Claude CodeSélectionnez Claude Code en haut de la fenêtre principale.2. Ouvrir le panneau d’ajout de fournisseurCliquez sur le bouton + dans le coin supérieur droit de la fenêtre principale.3. Remplir les détails du fournisseurRemplissez le formulaire comme suit :

Champ	Valeur	Description
Name	`oneaster`	Libellé personnalisé pour identification
Endpoint URL	`https://api.oneaster.ai`	URL de base de l’API OneAster
API Key	`sk-xxxxxxxxxxxx`	Votre clé API OneAster
API Format	`Anthropic Messages`	Conservez le format natif Anthropic par défaut

CC-Switch main interface

4. Sauvegarder la configurationCliquez sur Add pour sauvegarder. OneAster apparaîtra dans la liste des fournisseurs.

1. Basculer vers le groupe CodexSélectionnez Codex en haut de la fenêtre principale.2. Ouvrir le panneau d’ajout de fournisseurCliquez sur le bouton + dans le coin supérieur droit de la fenêtre principale.3. Remplir les détails du fournisseurUn fournisseur Codex est configuré via deux blocs :Remplissez la clé API dans le bloc auth.json :

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

Remplissez la configuration du fournisseur dans le bloc config.toml :

model = "gpt-5.5"
model_provider = "oneaster"

[model_providers.oneaster]
name = "oneaster"
base_url = "https://api.oneaster.ai/v1"
wire_api = "responses"
requires_openai_auth = true

4. Sauvegarder la configurationNommez le fournisseur (par ex. oneaster) et cliquez sur Add pour sauvegarder. CC-Switch validera automatiquement le JSON et le TOML.

À propos de l’URL du point de terminaison : Claude Code utilise le format natif Anthropic avec l’URL https://api.oneaster.ai (sans /v1) ; Codex utilise le format compatible OpenAI avec l’URL https://api.oneaster.ai/v1 (avec /v1). Ne les confondez pas.

Étape 3 : Basculer entre les fournisseurs

Une fois ajouté, vous pouvez basculer entre OneAster et d’autres fournisseurs à tout moment :

Basculer dans la fenêtre principale

Sélectionnez OneAster dans la liste des fournisseurs
Cliquez sur le bouton Enable (ou Use)
Un toast « Switched successfully » confirme le changement

CC-Switch main interface

Basculer depuis la barre des tâches système

CC-Switch reste dans la barre des tâches système, vous pouvez donc basculer sans ouvrir la fenêtre principale :

Cliquez sur l’icône CC-Switch dans la barre des tâches système
Cliquez sur le nom du fournisseur cible dans le menu — cela prend effet immédiatement

À propos de l’activation : Claude Code prend en charge le hot-switching — les nouvelles sessions reprennent automatiquement la nouvelle configuration. Après avoir basculé pour Codex, vous devez redémarrer le terminal ou Codex pour que le changement prenne effet.

Modèles pris en charge

Après avoir basculé vers le fournisseur OneAster, vous pouvez utiliser différents modèles dans l’outil CLI correspondant :

ID du modèle	Points forts	Cas d’utilisation recommandés
`claude-opus-4-6`	Le plus puissant globalement	Architecture complexe, débogage difficile
`claude-sonnet-4-6`	Performance & vitesse équilibrées	Codage quotidien, génération de code
`gpt-5.5`	Excellentes compétences en codage	Tâches d’ingénierie complexes
`gpt-4o`	Haute performance, rapide	Codage quotidien, itération rapide

Dans Claude Code, utilisez la commande /model pour changer de modèle ; dans Codex, utilisez également la commande /model. Pour la liste complète des modèles, consultez le guide Claude Code et le guide Codex CLI.

FAQ

Q1 : Le changement de fournisseur ne prend pas effet ?

Claude Code : prend en charge le hot-switching — démarrez une nouvelle session ; si cela ne fonctionne toujours pas, redémarrez Claude Code
Codex : après le changement, redémarrez le terminal ou Codex

Q2 : La clé API est signalée comme invalide ?

Assurez-vous que la clé API commence par sk- et est copiée entièrement sans espaces supplémentaires
Allez dans la console OneAster pour confirmer que la clé est active
Vérifiez que l’URL du point de terminaison est correcte (Claude Code utilise https://api.oneaster.ai, Codex utilise https://api.oneaster.ai/v1)

Q3 : Erreur de format lors de l’ajout d’un fournisseur Codex ?

CC-Switch valide auth.json (syntaxe JSON) et config.toml (syntaxe TOML). Vérifiez que :

Les crochets, guillemets et virgules dans le JSON sont complets
Aucun guillemet pleine largeur / intelligent n’est utilisé
Les noms de champs dans le TOML sont écrits correctement

Q4 : Quels fichiers CC-Switch modifie-t-il ?

CC-Switch écrit dans les fichiers de configuration de chaque outil :

Claude Code : ~/.claude/settings.json
Codex : ~/.codex/config.toml et ~/.codex/auth.json

CC-Switch sauvegarde automatiquement ces fichiers avant de basculer, vous n’avez donc pas besoin de les éditer à la main.

Q5 : Comment consulter l’utilisation et la facturation de l’API ?

Connectez-vous à la console OneAster pour consulter les statistiques d’appels API, les détails de consommation des tokens et les tendances des coûts.

Support et aide

Si vous rencontrez des problèmes lors de l’utilisation de CC-Switch :

Commencer avec OneAster

Inscrivez-vous à OneAster maintenant, obtenez votre clé API et gérez plusieurs outils de codage IA sans effort dans CC-Switch !

​Introduction

​Prérequis

​Étape 1 : Installer CC-Switch

​Étape 2 : Ajouter le fournisseur OneAster

​Étape 3 : Basculer entre les fournisseurs

​Basculer dans la fenêtre principale

​Basculer depuis la barre des tâches système

​Modèles pris en charge

​FAQ

​Q1 : Le changement de fournisseur ne prend pas effet ?

​Q2 : La clé API est signalée comme invalide ?

​Q3 : Erreur de format lors de l’ajout d’un fournisseur Codex ?

​Q4 : Quels fichiers CC-Switch modifie-t-il ?

​Q5 : Comment consulter l’utilisation et la facturation de l’API ?

​Support et aide

Commencer avec OneAster

Introduction

Prérequis

Étape 1 : Installer CC-Switch

Étape 2 : Ajouter le fournisseur OneAster

Étape 3 : Basculer entre les fournisseurs

Basculer dans la fenêtre principale

Basculer depuis la barre des tâches système

Modèles pris en charge

FAQ

Q1 : Le changement de fournisseur ne prend pas effet ?

Q2 : La clé API est signalée comme invalide ?

Q3 : Erreur de format lors de l’ajout d’un fournisseur Codex ?

Q4 : Quels fichiers CC-Switch modifie-t-il ?

Q5 : Comment consulter l’utilisation et la facturation de l’API ?

Support et aide