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

# Anthropic

Anthropic разрабатывает семейство моделей **Claude**. OpenClaw поддерживает два способа аутентификации:

* **Ключ API** — прямой доступ к Anthropic API с оплатой по фактическому использованию (модели `anthropic/*`)
* **Claude CLI** — повторное использование существующего входа Claude Code на том же хосте

<Warning>
  Бэкенд Claude CLI в OpenClaw запускает установленный Claude Code CLI в
  неинтерактивном режиме печати. Текущая документация Anthropic для Claude Code описывает
  `claude -p` как использование Agent SDK/программный режим. Обновление поддержки Anthropic от 15 июня 2026 года
  приостановило объявленное изменение тарификации Agent SDK. Сейчас Anthropic сообщает, что
  Claude Agent SDK, `claude -p` и использование сторонними приложениями по-прежнему расходуют
  лимиты использования подписки. Ранее объявленный ежемесячный кредит Agent SDK
  недоступен, пока Anthropic пересматривает этот план.

  Интерактивный Claude Code по-прежнему расходует лимиты плана Claude, в который выполнен вход. Аутентификация по ключу API
  остается прямой оплатой API по фактическому использованию. Для долговременных хостов Gateway,
  общей автоматизации и предсказуемых производственных расходов используйте ключ Anthropic API.

  Перед тем как полагаться на поведение тарификации подписки, проверяйте текущие статьи поддержки Anthropic:

  * [Справочник Claude Code CLI](https://code.claude.com/docs/en/cli-usage)
  * [Использование Claude Agent SDK с вашим планом Claude](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan)
  * [Использование Claude Code с вашим планом Pro или Max](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan)
  * [Использование Claude Code с вашим планом Team или Enterprise](https://support.claude.com/en/articles/11845131-using-claude-code-with-your-team-or-enterprise-plan)
  * [Управление расходами Claude Code](https://code.claude.com/docs/en/costs)
</Warning>

## Начало работы

<Tabs>
  <Tab title="Ключ API">
    **Лучше всего подходит для:** стандартного доступа к API и оплаты по фактическому использованию.

    <Steps>
      <Step title="Получите ключ API">
        Создайте ключ API в [Anthropic Console](https://console.anthropic.com/).
      </Step>

      <Step title="Запустите онбординг">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard
        # choose: Anthropic API key
        ```

        Или передайте ключ напрямую:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
        ```
      </Step>

      <Step title="Проверьте, что модель доступна">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider anthropic
        ```
      </Step>
    </Steps>

    ### Пример конфигурации

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
      agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
    }
    ```
  </Tab>

  <Tab title="Claude CLI">
    **Лучше всего подходит для:** повторного использования существующего входа Claude CLI без отдельного ключа API.

    <Steps>
      <Step title="Убедитесь, что Claude CLI установлен и вход выполнен">
        Проверьте с помощью:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        claude --version
        ```
      </Step>

      <Step title="Запустите онбординг">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard
        # choose: Claude CLI
        ```

        OpenClaw обнаруживает и повторно использует существующие учетные данные Claude CLI.
      </Step>

      <Step title="Проверьте, что модель доступна">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider anthropic
        ```
      </Step>
    </Steps>

    <Note>
      Подробности настройки и выполнения для бэкенда Claude CLI находятся в [бэкендах CLI](/ru/gateway/cli-backends).
    </Note>

    <Warning>
      Повторное использование Claude CLI предполагает, что процесс OpenClaw выполняется на том же хосте, где
      выполнен вход Claude CLI. Установки Docker могут сохранять домашний каталог контейнера и выполнять вход в
      Claude Code там; см.
      [бэкенд Claude CLI в Docker](/ru/install/docker#claude-cli-backend-in-docker).
      Другие контейнерные установки, такие как [Podman](/ru/install/podman), не монтируют хостовый
      `~/.claude` в настройку или среду выполнения; используйте там ключ Anthropic API или выберите
      провайдера с управляемым OpenClaw OAuth, например
      [OpenAI Codex](/ru/providers/openai).
    </Warning>

    ### Пример конфигурации

    Предпочитайте каноническую ссылку на модель Anthropic плюс переопределение среды выполнения CLI:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "anthropic/claude-opus-4-8" },
          models: {
            "anthropic/claude-opus-4-8": {
              agentRuntime: { id: "claude-cli" },
            },
          },
        },
      },
    }
    ```

    Устаревшие ссылки на модели `claude-cli/claude-opus-4-7` по-прежнему работают для
    совместимости, но новая конфигурация должна сохранять выбор провайдера/модели как
    `anthropic/*` и помещать бэкенд выполнения в политику среды выполнения провайдера/модели.

    ### Тарификация и `claude -p`

    OpenClaw использует неинтерактивный путь `claude -p` Claude Code для запусков Claude CLI.
    Anthropic сейчас рассматривает этот путь как использование Agent SDK/программный режим:

    * Обновление поддержки Anthropic от 15 июня 2026 года приостановило ранее объявленный
      отдельный план кредитов Agent SDK.
    * Сейчас Claude Agent SDK по подписному плану, `claude -p` и использование сторонними
      приложениями по-прежнему расходуют лимиты использования подписки, в которую выполнен вход.
    * Ранее объявленный ежемесячный кредит Agent SDK недоступен, пока
      Anthropic пересматривает этот план.
    * Входы через Console/ключ API используют оплату API по фактическому использованию и не получают
      кредит Agent SDK подписки.

    См. [статью о плане Agent SDK](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan)
    Anthropic для уведомления о паузе, а также статьи о планах Claude Code для поведения подписок
    [Pro/Max](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan)
    и
    [Team/Enterprise](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).

    Anthropic может менять тарификацию Claude Code и поведение лимитов скорости без
    релиза OpenClaw. Проверяйте `claude auth status`, `/status` и
    связанные документы Anthropic, когда важна предсказуемость расходов.

    <Tip>
      Для общей производственной автоматизации используйте ключ Anthropic API вместо
      Claude CLI. OpenClaw также поддерживает варианты в стиле подписки от
      [OpenAI Codex](/ru/providers/openai), [Qwen Cloud](/ru/providers/qwen),
      [MiniMax](/ru/providers/minimax) и [Z.AI / GLM](/ru/providers/zai).
    </Tip>
  </Tab>
</Tabs>

## Значения по умолчанию для рассуждения (Claude Fable 5, 4.8 и 4.6)

`anthropic/claude-fable-5` всегда использует адаптивное рассуждение и по умолчанию задает `high`
усилие. Поскольку Anthropic не разрешает отключать рассуждение для этой модели,
`/think off` и `/think minimal` используют `low` усилие. OpenClaw также опускает пользовательские
значения температуры для запросов Fable 5.

Claude Opus 4.8 по умолчанию в OpenClaw оставляет рассуждение выключенным. Когда вы явно включаете адаптивное рассуждение с помощью `/think high|xhigh|max`, OpenClaw отправляет значения усилия Anthropic для Opus 4.8; модели Claude 4.6 по умолчанию используют `adaptive`.

Переопределяйте для отдельного сообщения с помощью `/think:<level>` или в параметрах модели:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-8": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
```

<Note>
  Связанная документация Anthropic:

  * [Адаптивное рассуждение](https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking)
  * [Расширенное рассуждение](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
</Note>

## Кэширование промптов

OpenClaw поддерживает функцию кэширования промптов Anthropic для аутентификации по ключу API.

| Значение                 | Длительность кэша | Описание                                                  |
| ------------------------ | ----------------- | --------------------------------------------------------- |
| `"short"` (по умолчанию) | 5 минут           | Автоматически применяется для аутентификации по ключу API |
| `"long"`                 | 1 час             | Расширенный кэш                                           |
| `"none"`                 | Без кэширования   | Отключить кэширование промптов                            |

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="Переопределения кэша для отдельных агентов">
    Используйте параметры уровня модели как базовую настройку, затем переопределяйте конкретных агентов через `agents.list[].params`:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "anthropic/claude-opus-4-6" },
          models: {
            "anthropic/claude-opus-4-6": {
              params: { cacheRetention: "long" },
            },
          },
        },
        list: [
          { id: "research", default: true },
          { id: "alerts", params: { cacheRetention: "none" } },
        ],
      },
    }
    ```

    Порядок слияния конфигурации:

    1. `agents.defaults.models["provider/model"].params`
    2. `agents.list[].params` (соответствует `id`, переопределяет по ключу)

    Это позволяет одному агенту сохранять долгоживущий кэш, пока другой агент на той же модели отключает кэширование для всплескового трафика или трафика с низким повторным использованием.
  </Accordion>

  <Accordion title="Заметки о Bedrock Claude">
    * Модели Anthropic Claude на Bedrock (`amazon-bedrock/*anthropic.claude*`) принимают сквозную передачу `cacheRetention`, когда она настроена.
    * Для моделей Bedrock, не относящихся к Anthropic, во время выполнения принудительно задается `cacheRetention: "none"`.
    * Умные значения по умолчанию для ключа API также задают `cacheRetention: "short"` для ссылок Claude-on-Bedrock, когда явное значение не установлено.
  </Accordion>
</AccordionGroup>

## Расширенная конфигурация

<AccordionGroup>
  <Accordion title="Быстрый режим">
    Общий переключатель `/fast` в OpenClaw поддерживает прямой трафик Anthropic (ключ API и OAuth к `api.anthropic.com`).

    | Команда     | Сопоставляется с                |
    | ----------- | ------------------------------- |
    | `/fast on`  | `service_tier: "auto"`          |
    | `/fast off` | `service_tier: "standard_only"` |

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          models: {
            "anthropic/claude-sonnet-4-6": {
              params: { fastMode: true },
            },
          },
        },
      },
    }
    ```

    <Note>
      * Внедряется только для прямых запросов к `api.anthropic.com`. Прокси-маршруты оставляют `service_tier` без изменений.
      * Явные параметры `serviceTier` или `service_tier` переопределяют `/fast`, когда заданы оба.
      * В аккаунтах без емкости Priority Tier значение `service_tier: "auto"` может разрешаться в `standard`.
    </Note>
  </Accordion>

  <Accordion title="Понимание медиа (изображения и PDF)">
    Встроенный Plugin Anthropic регистрирует понимание изображений и PDF. OpenClaw
    автоматически разрешает медиа-возможности из настроенной аутентификации Anthropic — дополнительная
    конфигурация не нужна.

    | Свойство            | Значение                   |
    | ------------------- | -------------------------- |
    | Модель по умолчанию | `claude-opus-4-8`          |
    | Поддерживаемый ввод | Изображения, PDF-документы |

    Когда изображение или PDF прикреплены к беседе, OpenClaw автоматически
    направляет их через провайдера понимания медиа Anthropic.
  </Accordion>

  <Accordion title="Контекстное окно 1M">
    Контекстное окно 1M Anthropic доступно на моделях Claude 4.x с поддержкой GA,
    таких как Opus 4.8, Opus 4.7, Opus 4.6 и Sonnet 4.6. OpenClaw автоматически задает для этих моделей
    размер 1M:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          models: {
            "anthropic/claude-opus-4-6": {},
          },
        },
      },
    }
    ```

    Старые конфигурации могут сохранять `params.context1m: true`, но OpenClaw больше не отправляет
    устаревший бета-заголовок `context-1m-2025-08-07`. Старые записи конфигурации `anthropicBeta`
    с этим значением игнорируются при разрешении заголовков запроса, а
    неподдерживаемые старые модели Claude остаются на своем обычном контекстном окне.

    `params.context1m: true` также применяется к бэкенду Claude CLI
    (`claude-cli/*`) для подходящих моделей Opus и Sonnet с поддержкой GA, сохраняя
    контекстное окно среды выполнения для этих CLI-сеансов в соответствии с поведением прямого API.

    <Warning>
      Требуется доступ к длинному контексту для ваших учетных данных Anthropic. Аутентификация OAuth/токеном подписки сохраняет требуемые бета-заголовки Anthropic, но OpenClaw удаляет устаревший бета-заголовок 1M, если он остается в старой конфигурации.
    </Warning>
  </Accordion>

  <Accordion title="Контекст 1M Claude Opus 4.8">
    `anthropic/claude-opus-4-8` и его вариант `claude-cli` по умолчанию имеют окно
    контекста 1M — `params.context1m: true` не требуется.
  </Accordion>
</AccordionGroup>

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Ошибки 401 / токен внезапно стал недействительным">
    Аутентификация токеном Anthropic истекает, и токен может быть отозван. Для новых настроек вместо этого используйте ключ API Anthropic.
  </Accordion>

  <Accordion title="Не найден ключ API для провайдера &#x22;anthropic&#x22;">
    Аутентификация Anthropic выполняется **для каждого агента** — новые агенты не наследуют ключи основного агента. Повторно выполните onboarding для этого агента (или настройте ключ API на хосте Gateway), затем проверьте с помощью `openclaw models status`.
  </Accordion>

  <Accordion title="Не найдены учетные данные для профиля &#x22;anthropic:default&#x22;">
    Запустите `openclaw models status`, чтобы увидеть, какой профиль аутентификации активен. Повторно выполните onboarding или настройте ключ API для этого пути профиля.
  </Accordion>

  <Accordion title="Нет доступного профиля аутентификации (все в периоде ожидания)">
    Проверьте `auth.unusableProfiles` в `openclaw models status --json`. Периоды ожидания из-за ограничения скорости Anthropic могут быть привязаны к модели, поэтому родственная модель Anthropic все еще может быть доступна. Добавьте еще один профиль Anthropic или дождитесь окончания периода ожидания.
  </Accordion>
</AccordionGroup>

<Note>
  Дополнительная помощь: [Устранение неполадок](/ru/help/troubleshooting) и [FAQ](/ru/help/faq).
</Note>

## Связанные материалы

<CardGroup cols={2}>
  <Card title="Выбор модели" href="/ru/concepts/model-providers" icon="layers">
    Выбор провайдеров, ссылок на модели и поведения переключения при сбое.
  </Card>

  <Card title="Бэкенды CLI" href="/ru/gateway/cli-backends" icon="terminal">
    Настройка бэкенда Claude CLI и сведения о выполнении.
  </Card>

  <Card title="Кэширование промптов" href="/ru/reference/prompt-caching" icon="database">
    Как кэширование промптов работает у разных провайдеров.
  </Card>

  <Card title="OAuth и аутентификация" href="/ru/gateway/authentication" icon="key">
    Сведения об аутентификации и правила повторного использования учетных данных.
  </Card>
</CardGroup>
