> ## 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 Claude Code avec CometAPI

> Utilisez ce guide pour configurer Claude Code avec CometAPI via des identifiants compatibles Anthropic, les paramètres d’URL de base et les model ID Claude.

Utilisez ce guide pour connecter [Claude Code](https://code.claude.com/docs/en/overview) à CometAPI.

Références officielles :

* [Présentation de Claude Code](https://code.claude.com/docs/en/overview)
* [Premiers pas avec Claude Code](https://code.claude.com/docs/en/getting-started)

<Note>
  La disponibilité des modèles évolue au fil du temps. Pour connaître les model ID Claude actuels, consultez
  la [page des modèles CometAPI](/fr/overview/models).
</Note>

## Prérequis

* Une clé CometAPI depuis votre [tableau de bord](https://www.cometapi.com) (commence par `sk-`)
* Git installé
* Système d’exploitation pris en charge : macOS, Linux ou Windows

## Installer Claude Code

<Steps>
  <Step title="Exécuter l’installateur officiel">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={null}
        curl -fsSL https://claude.ai/install.sh | bash
        ```
      </Tab>

      <Tab title="Homebrew">
        ```bash theme={null}
        brew install --cask claude-code
        ```
      </Tab>

      <Tab title="Windows">
        PowerShell:

        ```powershell theme={null}
        irm https://claude.ai/install.ps1 | iex
        ```

        CMD:

        ```batch theme={null}
        curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
        ```

        <Info>Windows nécessite que [Git for Windows](https://git-scm.com/downloads/win) soit installé au préalable.</Info>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Vérifier l’installation">
    ```bash theme={null}
    claude --version
    ```
  </Step>
</Steps>

## Configurer le point de terminaison CometAPI

Créez ou modifiez le fichier de paramètres :

* macOS / Linux : `~/.claude/settings.json`
* Windows : `%USERPROFILE%\.claude\settings.json`

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}
```

Remplacez `sk-your-cometapi-key` par votre véritable clé CometAPI, puis démarrez Claude Code :

```bash theme={null}
cd your-project
claude
```

## Dépannage

<AccordionGroup>
  <Accordion title="settings.json ne prend pas effet">
    1. Redémarrez complètement votre terminal en fermant toutes les fenêtres puis en le rouvrant.
    2. Si cela ne fonctionne toujours pas, créez `~/.claude.json` et ajoutez :

    ```json theme={null}
    {
      "hasCompletedOnboarding": true
    }
    ```

    3. En solution de repli, exportez directement les variables d’environnement :

    ```bash theme={null}
    # Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
    export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
    export ANTHROPIC_BASE_URL="https://api.cometapi.com"
    ```
  </Accordion>

  <Accordion title="Clé API invalide ou Please run /login">
    Vérifiez que `~/.claude/settings.json` existe et que le format JSON est valide, sans virgules finales et avec des guillemets corrects. Validez sur [jsonlint.com](https://jsonlint.com).
  </Accordion>

  <Accordion title="Les identifiants officiels mis en cache sont utilisés">
    Claude Code priorise les identifiants officiels mis en cache. Exécutez `/logout` dans Claude Code, fermez-le, puis redémarrez.

    Si cela échoue toujours, supprimez le fichier d’authentification mis en cache :

    ```bash theme={null}
    rm -rf ~/.config/claude-code/auth.json
    ```
  </Accordion>

  <Accordion title="Le statut affiche hors ligne">
    Claude Code vérifie la connectivité via Google. `offline` signifie que Google est inaccessible. Cela n’affecte pas l’utilisation de CometAPI.
  </Accordion>

  <Accordion title="Fetch ou la navigation web échoue">
    La fonctionnalité Fetch de Claude Code appelle d’abord le service natif d’Anthropic, qui nécessite un accès Internet direct. Un proxy à l’échelle du système peut être nécessaire.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-code#howto",
        "name": "Utiliser Claude Code avec CometAPI",
        "description": "Utilisez ce guide pour configurer Claude Code avec CometAPI via des identifiants compatibles Anthropic, des paramètres d’URL de base et des model ID Claude.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-1",
            "position": 1,
            "name": "Vérifier les prérequis",
            "text": "Effectuez l’étape Vérifier les prérequis dans le guide Utiliser Claude Code avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-2",
            "position": 2,
            "name": "Installer Claude Code",
            "text": "Effectuez l’étape Installer Claude Code dans le guide Utiliser Claude Code avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-3",
            "position": 3,
            "name": "Configurer le point de terminaison CometAPI",
            "text": "Effectuez l’étape Configurer le point de terminaison CometAPI dans le guide Utiliser Claude Code 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 Claude Code avec CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-code"
          }
        ]
      }
    ]
    }
    `}
</script>