configuration API CC Switch

Utilisez en priorité l’import direct de la console 穷哥么 pour transmettre à CC Switch le fournisseur, l’endpoint, le modèle et la clé API. Une configuration manuelle est également décrite en cas d’échec.

Configuration rapide

Point de départ recommandé
https://qionggeme.com/console/token
Dans le menu d’action de la ligne de la clé API, choisissez « CC Switch ».
Protocole d’import
ccswitch://v1/import
Le lien peut contenir la clé API. Ne le copiez pas dans une conversation publique, un ticket ou une capture d’écran.
Endpoint Codex
https://qionggeme.com/v1
Protocole Responses natif, sans routage local.
Endpoint Claude / Gemini
https://qionggeme.com
État importé
enabled=true
Après l’import, vérifiez tout de même que le fournisseur cible est activé.

Prérequis :

Ce guide privilégie l’import direct déjà fourni dans la console ; vous n’avez pas à composer manuellement le Deep Link. Ses paramètres peuvent contenir la clé API en clair : ne partagez, ne transférez et ne capturez jamais un lien contenant la clé.

Étapes de configuration

  1. Ouvrir la page des clés API 穷哥么

    Accédez à https://qionggeme.com/console/token, trouvez la clé à importer, puis choisissez « CC Switch » dans le menu d’action de cette ligne. Ne copiez pas depuis la barre d’adresse le lien sensible qui sera généré.

  2. Choisir l’application, le nom du fournisseur et le modèle principal

    Dans la fenêtre, choisissez Claude, Codex ou Gemini, saisissez un nom de fournisseur facile à reconnaître, puis sélectionnez le modèle principal. L’ID doit être strictement identique à celui de la liste actuelle des modèles.

  3. Cliquer sur « Open CC Switch »

    La console génère un Deep Link ccswitch://v1/import et demande l’ouverture de CC Switch. Les données générées comprennent apiKey, model, homepage et enabled=true. L’endpoint Codex vaut https://qionggeme.com/v1, tandis que Claude et Gemini utilisent https://qionggeme.com.

  4. Confirmer l’import dans CC Switch

    CC Switch affiche un aperçu. Contrôlez l’application, le nom du fournisseur, l’endpoint et le modèle avant de confirmer. Le protocole officiel exige un aperçu et une validation par l’utilisateur ; annulez si la source n’est pas fiable ou si un champ paraît anormal.

  5. Vérifier l’activation et redémarrer le CLI cible

    Dans la liste des fournisseurs de l’application concernée, vérifiez que le nouveau fournisseur est activé. Si Claude Code, Codex ou Gemini CLI était déjà lancé avant l’import, fermez-le et redémarrez-le pour relire la configuration. Le guide officiel de bascule de Codex demande notamment de rouvrir le terminal.

  6. Ajouter manuellement le fournisseur si l’import échoue

    Dans l’onglet de l’application concernée de CC Switch, ajoutez un fournisseur personnalisé :

    • Onglet Codex : endpoint https://qionggeme.com/v1, clé API et modèle ; utilisez le protocole natif responses, sans routage local.
    • Onglet Claude : endpoint https://qionggeme.com, clé API et modèle, puis enregistrez et activez le fournisseur.

    Même en configuration manuelle, n’utilisez jamais le site de documentation et n’ajoutez pas /docs à l’endpoint API.

Exemple de configuration

# Liste de contrôle sûre (sans vraie clé API ni Deep Link complet)
Protocole: ccswitch://v1/import
resource: provider
Endpoint Codex: https://qionggeme.com/v1
Endpoint Claude/Gemini: https://qionggeme.com
Champs: apiKey, model, homepage, enabled=true

# Configuration manuelle de secours pour Codex
Base URL: https://qionggeme.com/v1
Wire API: responses
Routage local: inutile

Dépannage

Le bouton « Open CC Switch » n’ouvre pas l’application

Vérifiez que CC Switch est installé et a déjà été lancé. L’installation enregistre normalement le protocole ccswitch://. Si ce protocole n’est pas associé, réinstallez l’application ou réparez l’enregistrement selon la documentation officielle, puis relancez l’import depuis la page des clés API.

CC Switch signale un échec d’import ou des champs manquants

Ne modifiez pas manuellement le lien contenant la clé. Revenez dans la console, choisissez à nouveau l’application, le nom et le modèle principal, puis rouvrez CC Switch. Si l’échec persiste, utilisez la configuration manuelle ci-dessus avec https://qionggeme.com/v1 ou https://qionggeme.com selon l’application, sans /docs.

L’import réussit, mais le CLI utilise encore l’ancien fournisseur

Confirmez dans CC Switch que le nouveau fournisseur est activé, puis fermez complètement et relancez le CLI cible. Pour Codex, fermez la fenêtre de terminal courante et ouvrez-en une nouvelle.

Codex échoue ou semble exiger un routage local

Contrôlez que l’endpoint Codex est https://qionggeme.com/v1 et que le protocole natif est responses. L’API qionggeme n’a pas besoin du routage local de CC Switch. Une conversion n’est nécessaire que pour un fournisseur qui ne prend pas en charge Responses nativement.

Erreur 401, solde insuffisant ou modèle introuvable

Vérifiez la validité de la clé, ses autorisations et le solde, puis confirmez l’ID sur la page des tarifs. Ne publiez ni la clé ni un Deep Link qui la contient pour demander de l’aide.

Prêt à commencer ?

Créez un compte 穷哥么 pour obtenir une clé API et accéder aux modèles disponibles.

Créer un compte

Questions fréquentes

Quels champs l’import CC Switch écrit-il ?

L’import de fournisseur généré par qionggeme comprend apiKey, model, homepage et enabled=true, ainsi qu’un endpoint dépendant de l’application : https://qionggeme.com/v1 pour Codex et https://qionggeme.com pour Claude/Gemini.

Puis-je envoyer le lien ccswitch:// à quelqu’un ?

Ne partagez jamais un Deep Link contenant une clé API. Les paramètres peuvent exposer directement le secret dans une conversation, un ticket, une capture d’écran, l’historique synchronisé du navigateur ou des journaux. Pour collaborer, retirez les champs sensibles et demandez à l’autre personne d’utiliser sa propre clé.

Pourquoi Codex n’a-t-il pas besoin du routage local ?

Parce que l’endpoint Codex de qionggeme, https://qionggeme.com/v1, prend nativement en charge Responses. Il suffit de fournir la Base URL, la clé et le modèle. Une conversion locale n’est utile que pour un fournisseur non compatible Responses.

Pourquoi l’import ne prend-il pas effet immédiatement ?

Vérifiez d’abord que le fournisseur est activé. Un CLI déjà lancé peut conserver l’ancienne configuration ; redémarrez-le. La documentation de bascule de Codex demande de fermer le terminal courant puis d’en ouvrir un nouveau.

Puis-je mettre une adresse contenant /docs dans l’endpoint ?

Non. Codex utilise https://qionggeme.com/v1, tandis que Claude et Gemini utilisent https://qionggeme.com. Un endpoint API ne contient jamais /docs.

Guides associés

configuration API personnalisée Codex CLI

Utilisez le mécanisme officiel de model provider de Codex pour accéder à 穷哥么. La clé reste dans une variable d’environnement et le fournisseur utilise l’API Responses.

Lire le guide →

configuration API Claude Code

Définissez des variables d’environnement pour utiliser Claude Code avec l’API 穷哥么 et accéder aux capacités de programmation de Claude sans abonnement officiel.

Lire le guide →

configuration API Cockpit Tools

Cockpit Tools gère des profils Codex. Suivez l’ordre « ajouter le fournisseur → l’associer à une instance → activer et démarrer » pour que Codex utilise réellement l’API 穷哥么.

Lire le guide →