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

# Використання Claude Code з CometAPI

> Скористайтеся цим посібником, щоб налаштувати Claude Code з CometAPI через сумісні з Anthropic облікові дані, параметри base URL і Claude model ID.

Скористайтеся цим посібником, щоб підключити [Claude Code](https://code.claude.com/docs/en/overview) до CometAPI.

Офіційні посилання:

* [Огляд Claude Code](https://code.claude.com/docs/en/overview)
* [Початок роботи з Claude Code](https://code.claude.com/docs/en/getting-started)

<Note>
  Доступність моделей змінюється з часом. Актуальні Claude model ID дивіться
  на [сторінці моделей CometAPI](/uk/overview/models).
</Note>

## Передумови

* Ключ CometAPI з вашої [панелі керування](https://www.cometapi.com) (починається з `sk-`)
* Встановлений Git
* Підтримувана ОС: macOS, Linux або Windows

## Встановлення Claude Code

<Steps>
  <Step title="Запустіть офіційний інсталятор">
    <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 потрібно спочатку встановити [Git for Windows](https://git-scm.com/downloads/win).</Info>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Перевірте встановлення">
    ```bash theme={null}
    claude --version
    ```
  </Step>
</Steps>

## Налаштування endpoint CometAPI

Створіть або відредагуйте файл налаштувань:

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

Замініть `sk-your-cometapi-key` на ваш справжній ключ CometAPI, а потім запустіть Claude Code:

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

## Усунення несправностей

<AccordionGroup>
  <Accordion title="settings.json не набирає чинності">
    1. Повністю перезапустіть термінал, закривши всі вікна та відкривши його знову.
    2. Якщо це все одно не працює, створіть `~/.claude.json` і додайте:

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

    3. Як запасний варіант, експортуйте змінні середовища напряму:

    ```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 або Please run /login">
    Переконайтеся, що `~/.claude/settings.json` існує, а формат JSON є коректним: без зайвих ком наприкінці та з правильними лапками. Перевірте на [jsonlint.com](https://jsonlint.com).
  </Accordion>

  <Accordion title="Використовуються кешовані офіційні облікові дані">
    Claude Code надає пріоритет кешованим офіційним обліковим даним. Виконайте `/logout` у Claude Code, закрийте його, а потім перезапустіть.

    Якщо це все одно не допомагає, видаліть файл кешованої авторизації:

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

  <Accordion title="Статус показує offline">
    Claude Code перевіряє з’єднання через Google. `offline` означає, що Google недоступний. Це не впливає на використання CometAPI.
  </Accordion>

  <Accordion title="Fetch або вебперегляд не працює">
    Функція Fetch у Claude Code спочатку звертається до нативного сервісу Anthropic, для чого потрібен прямий доступ до інтернету. Може знадобитися системний проксі.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-code#howto",
        "name": "Використання Claude Code з CometAPI",
        "description": "Скористайтеся цим посібником, щоб налаштувати Claude Code з CometAPI через сумісні з Anthropic облікові дані, налаштування base URL і Claude model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-1",
            "position": 1,
            "name": "Перевірте передумови",
            "text": "Виконайте крок «Перевірте передумови» в посібнику «Використання Claude Code з CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-2",
            "position": 2,
            "name": "Встановіть Claude Code",
            "text": "Виконайте крок «Встановіть Claude Code» в посібнику «Використання Claude Code з CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-3",
            "position": 3,
            "name": "Налаштуйте endpoint CometAPI",
            "text": "Виконайте крок «Налаштуйте endpoint CometAPI» в посібнику «Використання Claude Code з CometAPI»."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Документація CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Інтеграції",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Використання Claude Code з CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-code"
          }
        ]
      }
    ]
    }
    `}
</script>