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

# Utiliser Codex avec CometAPI

> Utilisez ce guide pour configurer Codex avec CometAPI comme fournisseur de modèles en modifiant les paramètres du fournisseur dans le fichier config.toml au niveau utilisateur.

Utilisez ce guide pour exécuter [Codex](https://developers.openai.com/codex/quickstart) avec CometAPI comme fournisseur de modèles.

Références officielles :

* [Guide de démarrage Codex](https://developers.openai.com/codex/quickstart)
* [Bases de la configuration de Codex](https://developers.openai.com/codex/config-basic)
* [Fournisseurs de modèles personnalisés de Codex](https://developers.openai.com/codex/config-advanced#custom-model-providers)
* [Authentification Codex](https://developers.openai.com/codex/auth)
* [Codex sur Windows](https://developers.openai.com/codex/windows)

## Prérequis

| Exigence           | Détails                                                                                                                            |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| OS                 | macOS, Linux, Windows PowerShell natif, ou Windows avec WSL                                                                        |
| Git                | 2.23+ recommandé                                                                                                                   |
| Codex              | Installez l’application Codex ou le Codex CLI depuis le [guide de démarrage Codex](https://developers.openai.com/codex/quickstart) |
| Clé d’API CometAPI | Obtenez-en une depuis le [tableau de bord CometAPI](https://www.cometapi.com/console/token)                                        |
| Model ID           | Utilisez un model ID depuis la [page Models](/fr/overview/models)                                                                  |

## Choisissez une méthode de configuration

Nous proposons deux options pour vous aider à configurer Codex rapidement.

<CardGroup cols={2}>
  <Card title="Option 1: Configurer Codex manuellement (recommandé)" icon="bolt" href="#configure-codex-manually">
    Modifiez directement le fichier `~/.codex/config.toml` au niveau utilisateur. C’est la méthode la plus fiable, en particulier pour les utilisateurs de Windows et WSL.
  </Card>

  <Card title="Option 2: Configurer via un script" icon="puzzle-piece" href="#run-the-setup-script">
    Exécutez le script d’installation comme raccourci. Il écrit la même configuration de fournisseur et stocke la clé d’API CometAPI pour Codex.
  </Card>
</CardGroup>

## Configurer Codex manuellement

Codex lit les paramètres par défaut du fournisseur personnel à partir du fichier `~/.codex/config.toml` au niveau utilisateur. Configurez le fournisseur CometAPI à cet endroit, et non dans un fichier de projet `.codex/config.toml`. Codex ignore les paramètres provider et provider-auth dans les fichiers de configuration de projet.

La configuration recommandée utilise un fournisseur nommé `cometapi` et une authentification adossée à une commande. Cela permet de garder CometAPI séparé du fournisseur OpenAI intégré, ne nécessite pas l’héritage des variables d’environnement du shell et ne remplace pas `~/.codex/auth.json`.

<Tabs>
  <Tab title="macOS / Linux / WSL">
    Stockez votre clé API CometAPI dans un fichier de clé local :

    ```bash theme={null}
    mkdir -p "$HOME/.codex"
    printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
    chmod 600 "$HOME/.codex/cometapi_key"
    ```

    Ajoutez cette configuration à `~/.codex/config.toml` :

    ```toml theme={null}
    model_provider = "cometapi"
    model = "your-model-id"

    [model_providers.cometapi]
    name = "CometAPI"
    base_url = "https://api.cometapi.com/v1"
    wire_api = "responses"

    [model_providers.cometapi.auth]
    command = "sh"
    args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    Stockez votre clé API CometAPI dans le répertoire d’accueil Codex de Windows :

    ```powershell theme={null}
    New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
    Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY
    ```

    Ajoutez cette configuration à `$HOME\.codex\config.toml` :

    ```toml theme={null}
    model_provider = "cometapi"
    model = "your-model-id"

    [model_providers.cometapi]
    name = "CometAPI"
    base_url = "https://api.cometapi.com/v1"
    wire_api = "responses"

    [model_providers.cometapi.auth]
    command = "powershell.exe"
    args = [
      "-NoProfile",
      "-Command",
      "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
    ]
    ```
  </Tab>
</Tabs>

<Note>
  Codex natif sur Windows utilise `$HOME\.codex`, généralement `C:\Users\<user>\.codex`. WSL utilise le `~/.codex` de la distribution Linux. Modifiez le répertoire correspondant à l’environnement dans lequel l’agent Codex s’exécute.
</Note>

## Utiliser l’authentification par variable d’environnement

Si vous préférez conserver la clé API CometAPI dans une variable d’environnement, utilisez `env_key` au lieu du bloc `[model_providers.cometapi.auth]`.

Utilisez cette configuration de fournisseur uniquement lorsque `COMETAPI_KEY` est disponible dans l’environnement qui lance Codex :

```toml theme={null}
model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"
```

<Warning>
  Ne combinez pas `env_key` avec `[model_providers.cometapi.auth]`. Codex prend en charge une seule méthode d’authentification par fournisseur personnalisé.
</Warning>

## Exécuter le script de configuration

Le script de configuration est facultatif. Il écrit la même configuration du provider `cometapi` dans `~/.codex/config.toml`, stocke votre clé d’API CometAPI dans `~/.codex/cometapi_key`, crée des sauvegardes avant les modifications de fichiers et vérifie la configuration avec `codex exec` lorsque le CLI Codex est disponible.

Pour macOS, Linux ou WSL, exécutez l’installateur interactif :

```bash theme={null}
sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"
```

Pour une configuration non interactive, transmettez explicitement la clé d’API :

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"
```

Pour PowerShell natif sous Windows, exécutez l’installateur interactif :

```powershell theme={null}
powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"
```

Pour une configuration Windows non interactive, transmettez explicitement la clé d’API :

```powershell theme={null}
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"
```

<Warning>
  Par défaut, le script ne remplace pas `~/.codex/auth.json` et ne supprime pas une connexion ChatGPT. Utilisez `--force-auth-json` ou `-ForceAuthJson` uniquement si vous voulez que le script gère la connexion par clé d’API Codex via `auth.json`.
</Warning>

## Choisir ou modifier un model ID

Utilisez un model ID depuis la [page Models](/fr/overview/models). En configuration manuelle, modifiez la valeur de `model` dans `~/.codex/config.toml`.

Pour macOS, Linux ou WSL, transmettez `--model` lorsque vous exécutez le script de configuration :

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id
```

Pour PowerShell natif sous Windows, transmettez `-Model` lorsque vous exécutez le script de configuration :

```powershell theme={null}
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"
```

<Note>
  Le script utilise `CODEX_HOME` lorsqu’il est défini. Sinon, il écrit dans le `~/.codex` de l’environnement actuel.
</Note>

## Vérifier la configuration

Pour vérifier la configuration avec le CLI Codex, exécutez cette commande en lecture seule depuis n’importe quel projet local :

```bash theme={null}
codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"
```

Si le CLI Codex n’est pas disponible dans `PATH`, ouvrez l’application Codex et envoyez un court Prompt depuis un projet local.

## Dépannage

<AccordionGroup>
  <Accordion title="Codex utilise toujours le fournisseur OpenAI par défaut">
    Vérifiez que `model_provider = "cometapi"` se trouve dans le fichier `~/.codex/config.toml` au niveau utilisateur.
  </Accordion>

  <Accordion title="La clé API a changé">
    Mettez à jour `~/.codex/cometapi_key`, ou réexécutez le script d'installation avec la valeur `$COMETAPI_KEY` mise à jour.
  </Accordion>

  <Accordion title="Le script PowerShell échoue pendant les vérifications préalables">
    Utilisez les étapes manuelles de PowerShell natif Windows, puis exécutez la commande de vérification.
  </Accordion>

  <Accordion title="La configuration shell via un pipeline ne demande aucune clé API">
    Utilisez `--key "$COMETAPI_KEY"`, définissez `COMETAPI_KEY`, ou exécutez la commande interactive `sh -c "$(curl ...)"`.
  </Accordion>

  <Accordion title="La connexion expire ou utilise la mauvaise URL de base">
    Vérifiez que `base_url` est défini sur `https://api.cometapi.com/v1` dans `~/.codex/config.toml`.
  </Accordion>

  <Accordion title="Le modèle est introuvable">
    Consultez la [page Models](/fr/overview/models) pour voir les model IDs disponibles.
  </Accordion>

  <Accordion title="La configuration Windows affecte le mauvais environnement">
    Modifiez `$HOME\.codex` pour le mode natif Windows, ou modifiez `~/.codex` dans WSL pour le mode agent WSL.
  </Accordion>

  <Accordion title="La connexion ChatGPT a changé">
    N'utilisez pas `--force-auth-json` ou `-ForceAuthJson` sauf si vous souhaitez le mode de connexion par clé API.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/codex#howto",
        "name": "Utiliser Codex avec CometAPI",
        "description": "Utilisez ce guide pour configurer Codex avec CometAPI en modifiant les paramètres du fournisseur dans le fichier config.toml au niveau utilisateur.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-1",
            "position": 1,
            "name": "Vérifier les prérequis",
            "text": "Effectuez l'étape Vérifier les prérequis dans le guide Utiliser Codex avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-2",
            "position": 2,
            "name": "Choisir un parcours de configuration",
            "text": "Effectuez l'étape Choisir un parcours de configuration dans le guide Utiliser Codex avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-3",
            "position": 3,
            "name": "Configurer Codex manuellement",
            "text": "Effectuez l'étape Configurer Codex manuellement dans le guide Utiliser Codex avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-4",
            "position": 4,
            "name": "Utiliser l'authentification par variable d'environnement",
            "text": "Effectuez l'étape Utiliser l'authentification par variable d'environnement dans le guide Utiliser Codex avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-5",
            "position": 5,
            "name": "Exécuter le script d'installation",
            "text": "Effectuez l'étape Exécuter le script d'installation dans le guide Utiliser Codex avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-6",
            "position": 6,
            "name": "Choisir ou modifier un model ID",
            "text": "Effectuez l'étape Choisir ou modifier un model ID dans le guide Utiliser Codex avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-7",
            "position": 7,
            "name": "Vérifier la configuration",
            "text": "Effectuez l'étape Vérifier la configuration dans le guide Utiliser Codex avec CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentation CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Intégrations",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Utiliser Codex avec CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/codex"
          }
        ]
      }
    ]
    }
    `}
</script>