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

# Настройка Claude Code с BetterToken

> Подключите BetterToken к Claude Code через ANTHROPIC_BASE_URL без суффикса /v1.

Для подключения BetterToken к Claude Code нужны только `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN`. **Не добавляйте** `/v1` к Claude Code Base URL.

## Требования

* Установленный Claude Code (см. [документацию Claude Code](https://docs.anthropic.com/en/docs/claude-code))
* API Key BetterToken (зарегистрироваться (`https://www.bettertoken.ai/register`))

<Warning>
  Перед настройкой очистите эти переменные окружения, чтобы они не переопределили ваш config file:

  ```bash theme={null}
  unset ANTHROPIC_AUTH_TOKEN
  unset ANTHROPIC_BASE_URL
  ```
</Warning>

## Настройка

<Tabs>
  <Tab title="Автоматическая настройка">
    Можно запустить автоматический скрипт BetterToken. Он записывает только provider-конфигурацию BetterToken и не заменяет предварительные требования выше. Скрипту нужен `Node.js`. Если API Key или модель не переданы явно, скрипт запросит их интерактивно, когда это поддерживается.

    Выберите шаг для своей ОС. Нужен только один вариант.

    <Steps>
      <Step title="macOS / Linux">
        ```bash theme={null}
        curl -fsSL https://www.bettertoken.ai/install-claudecode-provider.sh | bash
        ```
      </Step>

      <Step title="Windows">
        ```powershell theme={null}
        iwr https://www.bettertoken.ai/install-claudecode-provider.ps1 -OutFile "$env:TEMP\install-claudecode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-claudecode-provider.ps1"
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Настройка через CC Switch">
    Этот путь поддерживается в [инструкции CC Switch](/ru/ai-tools/cc-switch#claude-code).

    Перейдите сразу к [вкладке Claude Code в инструкции CC Switch](/ru/ai-tools/cc-switch#claude-code).

    После настройки в CC Switch вернитесь на эту страницу, чтобы проверить запуск, first launch и activation notes.
  </Tab>

  <Tab title="Ручная настройка">
    <Steps>
      <Step title="Проверьте группу API Key">
        Сначала проверьте, какую группу API Key BetterToken вы используете:

        * `Claude_*`: задайте только `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN`
        * `Codex_*`: задайте auth fields и добавьте Claude Code model mappings

        Обе группы используют Anthropic-протокол. В обоих случаях `ANTHROPIC_BASE_URL` должен быть `https://www.bettertoken.ai` без `/v1`.
      </Step>

      <Step title="Отредактируйте config file Claude Code">
        Расположение config file:

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

        Если вы используете ключ `Claude_*`, замените `YOUR_API_KEY` на API Key BetterToken:

        ```json theme={null}
        {
          "env": {
            "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
            "API_TIMEOUT_MS": "3000000"
          }
        }
        ```

        <Note>
          С ключом `Claude_*` вам не нужны `ANTHROPIC_MODEL`, `ANTHROPIC_SMALL_FAST_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` или другие model variables. Claude Code сам управляет выбором модели.
        </Note>
      </Step>

      <Step title="Добавьте model mappings для ключей Codex_*">
        Если ваш API Key относится к группе `Codex_*`, используйте эту конфигурацию:

        <Tip>
          Если вы используете ключ `Codex_*`, мы рекомендуем сначала настроить Claude Code через [CC Switch](/ru/ai-tools/cc-switch#claude-code). Он надежнее обрабатывает Claude Code model mappings и proxy toggle. Используйте ручной config ниже только если хотите поддерживать файл конфигурации самостоятельно.
        </Tip>

        ```json theme={null}
        {
          "env": {
            "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.4",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.4",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.4",
            "API_TIMEOUT_MS": "3000000"
          },
          "model": "opus"
        }
        ```

        Справочник полей:

        | Поле                                       | Описание                                                                              |
        | ------------------------------------------ | ------------------------------------------------------------------------------------- |
        | `ANTHROPIC_AUTH_TOKEN`                     | Ваш API Key BetterToken                                                               |
        | `ANTHROPIC_BASE_URL`                       | BetterToken `Base URL` для Claude Code                                                |
        | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Установите `1`, чтобы уменьшить фоновый трафик                                        |
        | `ANTHROPIC_DEFAULT_HAIKU_MODEL`            | Модель для задач уровня Haiku                                                         |
        | `ANTHROPIC_DEFAULT_SONNET_MODEL`           | Модель для задач уровня Sonnet                                                        |
        | `ANTHROPIC_DEFAULT_OPUS_MODEL`             | Модель для задач уровня Opus                                                          |
        | `model`                                    | Model tier Claude Code по умолчанию; `opus` использует `ANTHROPIC_DEFAULT_OPUS_MODEL` |

        <Note>
          `gpt-5.4` — пример ID модели **Codex group**. Используйте актуальные ID моделей **Codex group** из BetterToken model plaza (`https://www.bettertoken.ai/pricing`). Можно сопоставить все три уровня с одной моделью или выбрать разные модели.
        </Note>
      </Step>

      <Step title="Перезапустите Claude Code">
        После обновления config file полностью закройте Claude Code и запустите его снова, чтобы загрузилась новая конфигурация.
      </Step>

      <Step title="Завершите первый запуск">
        Если вы впервые используете Claude Code, выполните `claude` и пройдите onboarding prompts.
      </Step>

      <Step title="Запустите Claude Code">
        Откройте директорию проекта и выполните:

        ```bash theme={null}
        claude
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Использование расширения VS Code

Если вы используете Claude Code VS Code extension:

<Steps>
  <Step title="Установите расширение">
    Найдите **Claude Code** в VS Code marketplace и установите его.
  </Step>

  <Step title="Откройте настройки">
    Откройте UI настроек расширения.
  </Step>

  <Step title="Задайте переменные окружения">
    Если вы используете ключ `Claude_*`, нажмите **Edit in settings.json** и обновите `claudeCode.environmentVariables`:

    ```json theme={null}
    {
      "claudeCode.environmentVariables": [
        {
          "name": "ANTHROPIC_BASE_URL",
          "value": "https://www.bettertoken.ai"
        },
        {
          "name": "ANTHROPIC_AUTH_TOKEN",
          "value": "YOUR_API_KEY"
        },
        {
          "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
          "value": "1"
        },
        {
          "name": "API_TIMEOUT_MS",
          "value": "3000000"
        }
      ]
    }
    ```
  </Step>

  <Step title="Добавьте model mappings для ключей Codex_*">
    Если ваш API Key относится к группе `Codex_*`, используйте:

    ```json theme={null}
    {
      "claudeCode.environmentVariables": [
        {
          "name": "ANTHROPIC_BASE_URL",
          "value": "https://www.bettertoken.ai"
        },
        {
          "name": "ANTHROPIC_AUTH_TOKEN",
          "value": "YOUR_API_KEY"
        },
        {
          "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
          "value": "1"
        },
        {
          "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
          "value": "gpt-5.4"
        },
        {
          "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
          "value": "gpt-5.4"
        },
        {
          "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
          "value": "gpt-5.4"
        },
        {
          "name": "API_TIMEOUT_MS",
          "value": "3000000"
        }
      ]
    }
    ```

    <Note>
      `gpt-5.4` — только пример ID модели **Codex group**. Скопируйте актуальный model ID из BetterToken model plaza (`https://www.bettertoken.ai/pricing`). Когда расширение использует Opus tier по умолчанию, оно будет разрешаться через `ANTHROPIC_DEFAULT_OPUS_MODEL`.
    </Note>
  </Step>

  <Step title="Перезапустите расширение VS Code">
    После редактирования `settings.json` перезапустите VS Code или перезагрузите расширение Claude Code, чтобы новые настройки вступили в силу.
  </Step>
</Steps>

## Проверка

Запустите Claude Code и отправьте сообщение. Обычный ответ означает, что подключение работает.

Если авторизация не проходит, проверьте:

1. `ANTHROPIC_AUTH_TOKEN` содержит правильный API Key BetterToken
2. `ANTHROPIC_BASE_URL` равен `https://www.bettertoken.ai`
3. Ключи `Claude_*` не задают model variables, а ключи `Codex_*` содержат mappings `ANTHROPIC_DEFAULT_*_MODEL`
4. Старые переменные окружения не переопределяют ваш config

## FAQ

<AccordionGroup>
  <Accordion title="Что делать, если появляется API Error: Unable to connect to API (ConnectionRefused)?">
    Обычно это означает, что Claude Code не может подключиться к BetterToken API. Чаще всего причина в сети, proxy или firewall, а не в API Key или model mapping.

    Проверьте, что локальная сеть работает, затем убедитесь, что system proxy, корпоративная сеть, router или security software не блокируют `https://www.bettertoken.ai`. Если вы используете firewall, разрешите Claude Code доступ к этому адресу.
  </Accordion>
</AccordionGroup>