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

# Usare Claude Code con CometAPI

> Usa questa guida per configurare Claude Code con CometAPI tramite credenziali compatibili con Anthropic, impostazioni del base URL e model ID di Claude.

Usa questa guida per collegare [Claude Code](https://code.claude.com/docs/en/overview) a CometAPI.

Riferimenti ufficiali:

* [Panoramica di Claude Code](https://code.claude.com/docs/en/overview)
* [Introduzione a Claude Code](https://code.claude.com/docs/en/getting-started)

<Note>
  La disponibilità dei modelli cambia nel tempo. Per i model ID attuali di Claude, controlla
  la [pagina Modelli di CometAPI](/it/overview/models).
</Note>

## Prerequisiti

* Una chiave CometAPI dal tuo [dashboard](https://www.cometapi.com) (inizia con `sk-`)
* Git installato
* Sistema operativo supportato: macOS, Linux o Windows

## Installa Claude Code

<Steps>
  <Step title="Esegui l'installer ufficiale">
    <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 richiede che [Git for Windows](https://git-scm.com/downloads/win) sia installato prima.</Info>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Verifica l'installazione">
    ```bash theme={null}
    claude --version
    ```
  </Step>
</Steps>

## Configura l'endpoint di CometAPI

Crea o modifica il file delle impostazioni:

* 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"
  }
}
```

Sostituisci `sk-your-cometapi-key` con la tua vera chiave CometAPI, quindi avvia Claude Code:

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

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="settings.json non ha effetto">
    1. Riavvia completamente il terminale chiudendo tutte le finestre e riaprendolo.
    2. Se ancora non funziona, crea `~/.claude.json` e aggiungi:

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

    3. Come soluzione di riserva, esporta direttamente le variabili d'ambiente:

    ```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="API Key non valida oppure esegui /login">
    Verifica che `~/.claude/settings.json` esista e che il formato JSON sia valido, senza virgole finali e con le virgolette corrette. Convalidalo su [jsonlint.com](https://jsonlint.com).
  </Accordion>

  <Accordion title="Vengono usate credenziali ufficiali memorizzate nella cache">
    Claude Code dà priorità alle credenziali ufficiali memorizzate nella cache. Esegui `/logout` all'interno di Claude Code, chiudilo e poi riavvialo.

    Se continua a non funzionare, rimuovi il file di autenticazione memorizzato nella cache:

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

  <Accordion title="Lo stato mostra offline">
    Claude Code verifica la connettività tramite Google. `offline` significa che Google non è raggiungibile. Questo non influisce sull'utilizzo di CometAPI.
  </Accordion>

  <Accordion title="Fetch o la navigazione web non funzionano">
    La funzionalità Fetch di Claude Code chiama prima il servizio nativo di Anthropic, che richiede accesso diretto a internet. Potrebbe essere necessario un proxy a livello di sistema.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-code#howto",
        "name": "Usare Claude Code con CometAPI",
        "description": "Usa questa guida per configurare Claude Code con CometAPI tramite credenziali compatibili con Anthropic, impostazioni dell'URL di base e model ID di Claude.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-1",
            "position": 1,
            "name": "Controllare i prerequisiti",
            "text": "Completa il passaggio Controllare i prerequisiti nella guida Usare Claude Code con CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-2",
            "position": 2,
            "name": "Installare Claude Code",
            "text": "Completa il passaggio Installare Claude Code nella guida Usare Claude Code con CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-3",
            "position": 3,
            "name": "Configurare l'endpoint CometAPI",
            "text": "Completa il passaggio Configurare l'endpoint CometAPI nella guida Usare Claude Code con CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentazione CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrazioni",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Usare Claude Code con CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-code"
          }
        ]
      }
    ]
    }
    `}
</script>