diff --git a/docs/uk/providers/anthropic.md b/docs/uk/providers/anthropic.md index 697b51dad..2c19cbded 100644 --- a/docs/uk/providers/anthropic.md +++ b/docs/uk/providers/anthropic.md @@ -1,96 +1,130 @@ --- read_when: - Ви хочете використовувати моделі Anthropic в OpenClaw -summary: Використання Anthropic Claude через API-ключі або Claude CLI в OpenClaw +summary: Використовуйте Anthropic Claude через API-ключі або Claude CLI в OpenClaw title: Anthropic x-i18n: - generated_at: "2026-04-06T15:30:39Z" + generated_at: "2026-04-12T09:50:38Z" model: gpt-5.4 provider: openai - source_hash: 423928fd36c66729985208d4d3f53aff1f94f63b908df85072988bdc41d5cf46 + source_hash: dabb5adc0d626995c3649c57cf4e1a94e48ce8908c004eecc21582af9c227f4d source_path: providers/anthropic.md workflow: 15 --- # Anthropic (Claude) -Anthropic створює сімейство моделей **Claude** і надає доступ через API та -Claude CLI. В OpenClaw підтримуються як API-ключі Anthropic, так і повторне використання Claude CLI. -Наявні застарілі профілі токенів Anthropic, якщо вони вже налаштовані, і далі -враховуються під час виконання. +Anthropic створює сімейство моделей **Claude**. OpenClaw підтримує два способи автентифікації: + +- **API key** — прямий доступ до Anthropic API з оплатою за використання (моделі `anthropic/*`) +- **Claude CLI** — повторне використання наявного входу Claude CLI на тому самому хості -Співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тож -OpenClaw вважає повторне використання Claude CLI та використання `claude -p` санкціонованими для цієї -інтеграції, якщо Anthropic не опублікує нову політику. +Співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому +OpenClaw вважає повторне використання Claude CLI та використання `claude -p` санкціонованими, якщо +Anthropic не опублікує нову політику. -Для довготривалих хостів gateway API-ключі Anthropic усе ще є найзрозумілішим і -найпередбачуванішим шляхом для production. Якщо ви вже використовуєте Claude CLI на хості, -OpenClaw може безпосередньо повторно використати цей вхід. +Для довготривалих хостів Gateway ключі Anthropic API key все ще є найзрозумілішим і +найпередбачуванішим шляхом для продакшну. Поточна публічна документація Anthropic: -- [Довідник CLI Claude Code](https://code.claude.com/docs/en/cli-reference) +- [Довідка з Claude Code CLI](https://code.claude.com/docs/en/cli-reference) - [Огляд Claude Agent SDK](https://platform.claude.com/docs/en/agent-sdk/overview) +- [Використання Claude Code з планом Pro або Max](https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan) +- [Використання Claude Code з планом Team або Enterprise](https://support.anthropic.com/en/articles/11845131-using-claude-code-with-your-team-or-enterprise-plan/) + -- [Використання Claude Code з вашим планом Pro або Max](https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan) -- [Використання Claude Code з вашим планом Team або Enterprise](https://support.anthropic.com/en/articles/11845131-using-claude-code-with-your-team-or-enterprise-plan/) +## Початок роботи -Якщо вам потрібен найзрозуміліший шлях виставлення рахунків, натомість використовуйте API-ключ Anthropic. -OpenClaw також підтримує інші варіанти на основі підписки, зокрема [OpenAI -Codex](/uk/providers/openai), [Qwen Cloud Coding Plan](/uk/providers/qwen), -[MiniMax Coding Plan](/uk/providers/minimax) і [Z.AI / GLM Coding -Plan](/uk/providers/glm). - + + + **Найкраще для:** стандартного доступу до API та оплати за використання. -## Варіант A: API-ключ Anthropic + + + Створіть API key у [Anthropic Console](https://console.anthropic.com/). + + + ```bash + openclaw onboard + # choose: Anthropic API key + ``` -**Найкраще підходить для:** стандартного доступу до API і тарифікації за використанням. -Створіть API-ключ у Anthropic Console. + Або передайте ключ напряму: -### Налаштування CLI + ```bash + openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY" + ``` + + + ```bash + openclaw models list --provider anthropic + ``` + + -```bash -openclaw onboard -# choose: Anthropic API key + ### Приклад конфігурації -# or non-interactive -openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY" -``` + ```json5 + { + env: { ANTHROPIC_API_KEY: "sk-ant-..." }, + agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } }, + } + ``` -### Фрагмент конфігурації Anthropic + -```json5 -{ - env: { ANTHROPIC_API_KEY: "sk-ant-..." }, - agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } }, -} -``` + + **Найкраще для:** повторного використання наявного входу Claude CLI без окремого API key. -## Типові параметри thinking (Claude 4.6) + + + Перевірте командою: -- Для моделей Anthropic Claude 4.6 в OpenClaw типовим значенням є `adaptive` thinking, якщо явний рівень thinking не задано. -- Ви можете перевизначити його для окремого повідомлення (`/think:`) або в параметрах моделі: - `agents.defaults.models["anthropic/"].params.thinking`. -- Пов’язана документація Anthropic: - - [Adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking) - - [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) + ```bash + claude --version + ``` + + + ```bash + openclaw onboard + # choose: Claude CLI + ``` -## Fast mode (Anthropic API) + OpenClaw виявляє та повторно використовує наявні облікові дані Claude CLI. + + + ```bash + openclaw models list --provider anthropic + ``` + + -Спільне перемикання `/fast` в OpenClaw також підтримує прямий публічний трафік Anthropic, зокрема запити з автентифікацією через API-ключ і OAuth, надіслані до `api.anthropic.com`. + + Подробиці налаштування та виконання для бекенда Claude CLI наведено в [CLI Backends](/uk/gateway/cli-backends). + -- `/fast on` зіставляється з `service_tier: "auto"` -- `/fast off` зіставляється з `service_tier: "standard_only"` -- Типове значення в конфігурації: + + Якщо вам потрібен найзрозуміліший шлях білінгу, використовуйте Anthropic API key. OpenClaw також підтримує варіанти у стилі підписки від [OpenAI Codex](/uk/providers/openai), [Qwen Cloud](/uk/providers/qwen), [MiniMax](/uk/providers/minimax) і [Z.AI / GLM](/uk/providers/glm). + + + + + +## Типові налаштування thinking (Claude 4.6) + +Моделі Claude 4.6 типово використовують `adaptive` thinking в OpenClaw, якщо явний рівень thinking не задано. + +Перевизначайте для окремого повідомлення через `/think:` або в параметрах моделі: ```json5 { agents: { defaults: { models: { - "anthropic/claude-sonnet-4-6": { - params: { fastMode: true }, + "anthropic/claude-opus-4-6": { + params: { thinking: "adaptive" }, }, }, }, @@ -98,25 +132,21 @@ openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY" } ``` -Важливі обмеження: + +Пов’язана документація Anthropic: +- [Adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking) +- [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) + -- OpenClaw додає рівні сервісу Anthropic лише для прямих запитів до `api.anthropic.com`. Якщо ви маршрутизуєте `anthropic/*` через proxy або gateway, `/fast` не змінює `service_tier`. -- Явні параметри моделі Anthropic `serviceTier` або `service_tier` перевизначають типове значення `/fast`, якщо встановлено обидва. -- Anthropic повідомляє про фактичний рівень у відповіді в полі `usage.service_tier`. Для облікових записів без місткості Priority Tier значення `service_tier: "auto"` усе одно може розв’язатися як `standard`. +## Кешування промптів -## Кешування prompt (Anthropic API) +OpenClaw підтримує функцію кешування промптів Anthropic для автентифікації через API key. -OpenClaw підтримує функцію кешування prompt від Anthropic. Це **лише для API**; застаріла автентифікація токеном Anthropic не враховує параметри кешу. - -### Конфігурація - -Використовуйте параметр `cacheRetention` у конфігурації моделі: - -| Value | Тривалість кешу | Опис | -| ------- | -------------- | ---- | -| `none` | Без кешування | Вимкнути кешування prompt | -| `short` | 5 хвилин | Типово для автентифікації за API Key | -| `long` | 1 година | Розширений кеш | +| Value | Тривалість кешу | Опис | +| ------------------- | --------------- | -------------------------------------- | +| `"short"` (типово) | 5 хвилин | Застосовується автоматично для автентифікації через API key | +| `"long"` | 1 година | Розширений кеш | +| `"none"` | Без кешування | Вимкнути кешування промптів | ```json5 { @@ -132,121 +162,141 @@ OpenClaw підтримує функцію кешування prompt від Anth } ``` -### Типові значення + + + Використовуйте параметри на рівні моделі як базову лінію, а потім перевизначайте для конкретних агентів через `agents.list[].params`: -Коли використовується автентифікація через API Key Anthropic, OpenClaw автоматично застосовує `cacheRetention: "short"` (5-хвилинний кеш) для всіх моделей Anthropic. Ви можете перевизначити це, явно встановивши `cacheRetention` у конфігурації. + ```json5 + { + 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" } }, + ], + }, + } + ``` -### Перевизначення cacheRetention для окремого агента + Порядок об’єднання конфігурації: -Використовуйте params на рівні моделі як базовий рівень, а потім перевизначайте конкретних агентів через `agents.list[].params`. + 1. `agents.defaults.models["provider/model"].params` + 2. `agents.list[].params` (відповідний `id`, перевизначення за ключем) -```json5 -{ - agents: { - defaults: { - model: { primary: "anthropic/claude-opus-4-6" }, - models: { - "anthropic/claude-opus-4-6": { - params: { cacheRetention: "long" }, // baseline for most agents + Це дозволяє одному агенту зберігати довготривалий кеш, тоді як інший агент на тій самій моделі вимикає кешування для імпульсного трафіку або трафіку з низьким повторним використанням. + + + + + - Моделі Anthropic Claude на Bedrock (`amazon-bedrock/*anthropic.claude*`) приймають наскрізну передачу `cacheRetention`, якщо це налаштовано. + - Для моделей Bedrock, що не належать Anthropic, під час виконання примусово встановлюється `cacheRetention: "none"`. + - Типові розумні налаштування для API key також задають `cacheRetention: "short"` для посилань Claude-on-Bedrock, якщо явне значення не встановлено. + + + +## Розширене налаштування + + + + Спільний перемикач `/fast` в OpenClaw підтримує прямий трафік Anthropic (API key та OAuth до `api.anthropic.com`). + + | Command | Відповідає | + |---------|------------| + | `/fast on` | `service_tier: "auto"` | + | `/fast off` | `service_tier: "standard_only"` | + + ```json5 + { + agents: { + defaults: { + models: { + "anthropic/claude-sonnet-4-6": { + params: { fastMode: true }, + }, + }, }, }, - }, - list: [ - { id: "research", default: true }, - { id: "alerts", params: { cacheRetention: "none" } }, // override for this agent only - ], - }, -} -``` + } + ``` -Порядок злиття конфігурації для параметрів, пов’язаних із кешем: + + - Вставляється лише для прямих запитів до `api.anthropic.com`. Для маршрутів через проксі `service_tier` залишається без змін. + - Явні параметри `serviceTier` або `service_tier` мають пріоритет над `/fast`, якщо задано обидва. + - Для акаунтів без доступної ємності Priority Tier значення `service_tier: "auto"` може звестися до `standard`. + -1. `agents.defaults.models["provider/model"].params` -2. `agents.list[].params` (для відповідного `id`, перевизначає за ключем) + -Це дає змогу одному агенту зберігати довготривалий кеш, тоді як інший агент на тій самій моделі вимикає кешування, щоб уникнути витрат на запис для імпульсного трафіку з низьким повторним використанням. + + Вікно контексту Anthropic 1M доступне лише в бета-режимі. Увімкніть його для конкретної моделі: -### Примітки щодо Bedrock Claude - -- Моделі Anthropic Claude на Bedrock (`amazon-bedrock/*anthropic.claude*`) приймають наскрізну передачу `cacheRetention`, якщо її налаштовано. -- Для моделей Bedrock, що не належать Anthropic, під час виконання примусово встановлюється `cacheRetention: "none"`. -- Розумні типові значення Anthropic API-key також встановлюють `cacheRetention: "short"` для посилань на моделі Claude-on-Bedrock, якщо явне значення не задано. - -## Вікно контексту 1M (бета Anthropic) - -Вікно контексту Anthropic 1M перебуває за beta-gate. В OpenClaw його можна ввімкнути для кожної моделі окремо -через `params.context1m: true` для підтримуваних моделей Opus/Sonnet. - -```json5 -{ - agents: { - defaults: { - models: { - "anthropic/claude-opus-4-6": { - params: { context1m: true }, + ```json5 + { + agents: { + defaults: { + models: { + "anthropic/claude-opus-4-6": { + params: { context1m: true }, + }, + }, }, }, - }, - }, -} -``` + } + ``` -OpenClaw зіставляє це з `anthropic-beta: context-1m-2025-08-07` у запитах -Anthropic. + OpenClaw відображає це у `anthropic-beta: context-1m-2025-08-07` у запитах. -Це активується лише тоді, коли для цієї моделі `params.context1m` явно встановлено в `true`. + + Потрібен доступ до довгого контексту для ваших облікових даних Anthropic. Застаріла автентифікація токеном (`sk-ant-oat-*`) відхиляється для запитів із контекстом 1M — OpenClaw записує попередження в лог і повертається до стандартного вікна контексту. + -Вимога: Anthropic має дозволяти використання довгого контексту для цих облікових даних. + + -Примітка: Anthropic наразі відхиляє бета-запити `context-1m-*` під час використання -застарілої автентифікації токеном Anthropic (`sk-ant-oat-*`). Якщо ви налаштуєте -`context1m: true` з цим застарілим режимом автентифікації, OpenClaw запише попередження в журнал і -повернеться до стандартного вікна контексту, пропустивши заголовок бета `context1m`, -але зберігши обов’язкові бета-заголовки OAuth. +## Усунення несправностей -## Бекенд Claude CLI + + + Токен-автентифікація Anthropic може завершити дію або бути відкликаною. Для нових налаштувань перейдіть на Anthropic API key. + -Вбудований бекенд Anthropic `claude-cli` підтримується в OpenClaw. + + Автентифікація є **окремою для кожного агента**. Нові агенти не успадковують ключі головного агента. Повторно запустіть онбординг для цього агента або налаштуйте API key на хості Gateway, а потім перевірте командою `openclaw models status`. + -- Співробітники Anthropic повідомили нам, що таке використання знову дозволене. -- Тому OpenClaw вважає повторне використання Claude CLI та використання `claude -p` - санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику. -- API-ключі Anthropic залишаються найзрозумілішим шляхом для production для постійно активних хостів gateway - та явного серверного контролю виставлення рахунків. -- Докладно про налаштування та виконання див. у [/gateway/cli-backends](/uk/gateway/cli-backends). + + Виконайте `openclaw models status`, щоб побачити, який профіль автентифікації активний. Повторно запустіть онбординг або налаштуйте API key для шляху цього профілю. + -## Примітки + + Перевірте `openclaw models status --json` для `auth.unusableProfiles`. Обмеження Anthropic за частотою запитів можуть бути прив’язані до конкретної моделі, тому сусідня модель Anthropic усе ще може бути придатною для використання. Додайте ще один профіль Anthropic або дочекайтеся завершення cooldown. + + -- У публічній документації Anthropic про Claude Code усе ще описано пряме використання CLI, таке як - `claude -p`, а співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw - знову дозволене. Ми вважаємо ці вказівки остаточними, якщо Anthropic - не опублікує нову зміну політики. -- Anthropic setup-token залишається доступним в OpenClaw як підтримуваний шлях автентифікації токеном, але OpenClaw тепер надає перевагу повторному використанню Claude CLI та `claude -p`, коли це доступно. -- Докладно про автентифікацію та правила повторного використання див. у [/concepts/oauth](/uk/concepts/oauth). + +Більше допомоги: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). + -## Усунення неполадок +## Пов’язане -**Помилки 401 / токен раптово недійсний** - -- Автентифікація токеном Anthropic може сплинути або бути відкликана. -- Для нових налаштувань перейдіть на API-ключ Anthropic. - -**Не знайдено API-ключ для постачальника "anthropic"** - -- Автентифікація є **для кожного агента окремо**. Нові агенти не успадковують ключі головного агента. -- Повторно запустіть onboarding для цього агента або налаштуйте API-ключ на хості - gateway, а потім перевірте через `openclaw models status`. - -**Не знайдено облікових даних для профілю `anthropic:default`** - -- Виконайте `openclaw models status`, щоб побачити, який профіль автентифікації активний. -- Повторно запустіть onboarding або налаштуйте API-ключ для шляху цього профілю. - -**Немає доступного профілю автентифікації (усі в кулдауні/недоступні)** - -- Перевірте `openclaw models status --json` для `auth.unusableProfiles`. -- Кулдауни rate-limit Anthropic можуть бути прив’язані до конкретної моделі, тож споріднена модель Anthropic - усе ще може бути придатною, навіть якщо поточна перебуває в кулдауні. -- Додайте інший профіль Anthropic або дочекайтеся завершення кулдауну. - -Докладніше: [/gateway/troubleshooting](/uk/gateway/troubleshooting) і [/help/faq](/uk/help/faq). + + + Вибір провайдерів, посилань на моделі та поведінки failover. + + + Налаштування бекенда Claude CLI та подробиці виконання. + + + Як працює кешування промптів у різних провайдерів. + + + Подробиці автентифікації та правила повторного використання облікових даних. + +