> ## Documentation Index
> Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser GccAi dans CC-Switch

> Guide détaillé sur la configuration et l'utilisation des services API GccAi dans CC-Switch, vous permettant d'accéder à plusieurs modèles d'IA pour une programmation assistée avec une configuration simple.

## 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 GccAi via CC-Switch, vous pouvez facilement configurer le service GccAi pour Claude Code et Codex, et basculer librement entre plusieurs fournisseurs.

## Prérequis

Avant de commencer, assurez-vous d'avoir :

1. **Un outil CLI pris en charge installé**
   Au moins un outil CLI pris en charge installé, comme [Claude Code](https://gccai.heqingsong.uk/fr/integrations/dev-tool/claude-code.md) ou [Codex CLI](https://gccai.heqingsong.uk/fr/integrations/dev-tool/codex-cli.md)

2. **Obtenu une clé API GccAi**
   Connectez-vous à la [console GccAi](https://gccai.heqingsong.uk/keys) pour obtenir votre clé API (commence par `sk-`)

> [!NOTE]
>
> **Astuce :** si vous n'avez pas encore de compte GccAi, inscrivez-vous d'abord sur [GccAi](https://gccai.heqingsong.uk) et obtenez votre clé API.

## Étape 1 : Installer CC-Switch

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

**macOS**

Installer via Homebrew (recommandé) :

```bash theme={null}
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

Vous pouvez également télécharger l'installeur `.dmg` depuis les [GitHub Releases](https://github.com/farion1231/cc-switch/releases). CC-Switch est signé et notarisé par Apple, donc il peut être installé directement (nécessite macOS 12 ou plus récent).

**Windows**

Téléchargez l'installeur `.msi` ou le `.zip` portable depuis les [GitHub Releases](https://github.com/farion1231/cc-switch/releases).

Nécessite Windows 10 ou plus récent.

**Linux**

Téléchargez le paquet approprié depuis les [GitHub Releases](https://github.com/farion1231/cc-switch/releases) :

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

> [!NOTE]
>
> 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 GccAi

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**

**1. Basculer vers le groupe Claude Code**

Sélectionnez **Claude Code** en haut de la fenêtre principale.

**2. Ouvrir le panneau d'ajout de fournisseur**

Cliquez sur le bouton **+** dans le coin supérieur droit de la fenêtre principale.

**3. Remplir les détails du fournisseur**

Remplissez le formulaire comme suit :

| Champ | Valeur | Description |
| - | - | - |
| **Name** | `GccAi` | Libellé personnalisé pour identification |
| **Endpoint URL** | `https://gccai.heqingsong.uk` | URL de base de l'API GccAi |
| **API Key** | `sk-xxxxxxxxxxxx` | Votre clé API GccAi |
| **API Format** | `Anthropic Messages` | Conservez le format natif Anthropic par défaut |

![CC-Switch main interface](https://mintcdn.com/apicore/_1ZGW4_iuaSfzpC6/images/integrations/cc-switch/step-2.png?fit=max\&auto=format\&n=_1ZGW4_iuaSfzpC6\&q=85\&s=7d91af6ec3f40c7bb2666ba455a09faa)

**4. Sauvegarder la configuration**

Cliquez sur **Add** pour sauvegarder. GccAi apparaîtra dans la liste des fournisseurs.

**Configurer pour Codex**

**1. Basculer vers le groupe Codex**

Sélectionnez **Codex** en haut de la fenêtre principale.

**2. Ouvrir le panneau d'ajout de fournisseur**

Cliquez sur le bouton **+** dans le coin supérieur droit de la fenêtre principale.

**3. Remplir les détails du fournisseur**

Un fournisseur Codex est configuré via deux blocs :

Remplissez la clé API dans le bloc **auth.json** :

```json theme={null}
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
```

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

```toml theme={null}
model = "gpt-5.5"
model_provider = "gccai"

[model_providers.gccai]
name = "GccAi"
base_url = "https://gccai.heqingsong.uk/v1"
wire_api = "responses"
requires_openai_auth = true
```

**4. Sauvegarder la configuration**

Nommez le fournisseur (par ex. `GccAi`) et cliquez sur **Add** pour sauvegarder. CC-Switch validera automatiquement le JSON et le TOML.

> [!NOTE]
>
> **À propos de l'URL du point de terminaison :** Claude Code utilise le format natif Anthropic avec l'URL `https://gccai.heqingsong.uk` (sans `/v1`) ; Codex utilise le format compatible OpenAI avec l'URL `https://gccai.heqingsong.uk/v1` (avec
> `/v1`). Ne les confondez pas.

## Étape 3 : Basculer entre les fournisseurs

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

### Basculer dans la fenêtre principale

1. Sélectionnez **GccAi** dans la liste des fournisseurs
2. Cliquez sur le bouton **Enable** (ou **Use**)
3. Un toast « Switched successfully » confirme le changement

![CC-Switch main interface](https://mintcdn.com/apicore/LdtR-ceBhXT3_e8B/images/integrations/cc-switch/step-1.png?fit=max\&auto=format\&n=LdtR-ceBhXT3_e8B\&q=85\&s=46a838ac93d721254556c464cc0b4864)

### 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 :

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

> [!NOTE]
>
> **À 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 GccAi, 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 |

> [!TIP]
>
> 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](https://gccai.heqingsong.uk/fr/integrations/dev-tool/claude-code.md) et le [guide Codex
> CLI](https://gccai.heqingsong.uk/fr/integrations/dev-tool/codex-cli.md).

## 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 ?

1. Assurez-vous que la clé API commence par `sk-` et est copiée entièrement sans espaces supplémentaires
2. Allez dans la [console GccAi](https://gccai.heqingsong.uk/keys) pour confirmer que la clé est active
3. Vérifiez que l'URL du point de terminaison est correcte (Claude Code utilise `https://gccai.heqingsong.uk`, Codex utilise `https://gccai.heqingsong.uk/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 GccAi](https://gccai.heqingsong.uk/overview) 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 :

* 📚 [Centre de documentation GccAi](https://gccai.heqingsong.uk)
* 📚 [Page du projet CC-Switch](https://github.com/farion1231/cc-switch)
* 💬 [Communauté Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Support technique : [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)

***

> **[Commencer avec GccAi](https://gccai.heqingsong.uk)**
>
> Inscrivez-vous à GccAi maintenant, obtenez votre clé API et gérez plusieurs outils de codage IA sans effort dans CC-Switch !


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.