> Усі статті WIKI Helomi: /wiki/llms.txt

# Ключі моделей (Anthropic, OpenAI, Kimi, Gemini)

Вкладка «ШІ» в «Інтеграціях» — місце, де організація підключає своїх ШІ-співробітників і ключі мовних моделей: Anthropic (Claude), OpenAI (ChatGPT), Moonshot (Kimi), Google (Gemini). Платформа своїх ключів не позичає: запити йдуть вашим ключем і за ваш рахунок, а використання видно в пульті кожного ШІ. Без ключа API теж можна працювати — підключити свій чат за підпискою через файл сесії.

## Можливості
- Картка кожного ШІ-співробітника організації: стан, вид («Мозок», «Програма», «Агент»), модель, хто підключив; три дії — «Увімкнено», «Відкрити», «WIKI».
- Шаблони каталогу, яких ще нема в організації (напр. «Ломі», якщо її прибрали), — «Додати» і «WIKI».
- «Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM» — підключити свій ШІ за файлом сесії чи токеном («Підключити» і «WIKI»).
- Чотири картки ключів моделей; ключ зберігається зашифрованим і назад не віддається.
- «Перевірити» показує список доступних моделей — без запиту до самої моделі й без витрат.
- «Підключити свій чат — без ключа API»: ключ сесії і файл для Claude, ChatGPT, Kimi чи Gemini.

## 1. Налаштування
Дорога: «Налаштування» → «Інтеграції» → вкладка «ШІ». Угорі — блок «ШІ-співробітники · N», нижче — «Ключі моделей · N/4» з картками «Anthropic (Claude)», «OpenAI (ChatGPT)», «Moonshot (Kimi)», «Google (Gemini)». У вкладці «Усі» ті самі блоки йдуть у групі «ШІ».

Додає, вмикає й підключає ШІ і вводить ключі адміністратор; налаштовувати ШІ-співробітника може ще й той, хто його підключив. Хто не має доступу до ШІ-співробітників, блоку з картками не бачить — лише картки ключів.

Де взяти ключ: у консолі розробника відповідного сервісу (Anthropic Console, OpenAI Platform, Moonshot, Google AI Studio) — розділ ключів API. Для Claude за підпискою Max чи Team ключ можна отримати з кредитами API — розділ 5.

## 2. Блок «ШІ-співробітники»
- **Картка співробітника**: аватар в ореолі, ім'я, роль, пігулки стану й виду, модель (або «модель — ваш ШІ (Claude, ChatGPT, Kimi…)» для зовнішнього), «підключив …». Дій рівно три: перемикач «Увімкнено» (вимкнений ШІ не робить нічого), «Відкрити» (вікно ШІ: програма чи агент на весь екран, Ломі — її віконце, Остап і свій ШІ — налаштування на вкладці «API») і «WIKI» (стаття ШІ шторкою). Налаштування й підключення — у вікні, кружечок «Налаштування» праворуч угорі.
- **Шаблон каталогу** з пігулкою «не додано» → «Додати» → та сама шторка, що в «Налаштування → Команда → ШІ-співробітники», з вибраним шаблоном. Після додавання відкриваються налаштування на вкладці «API»; «WIKI» — стаття шаблону.
- **«Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM»** → «Підключити» → шторка «Остап — свій ШІ», далі — налаштування Остапа на вкладці «API» з чорною «Створити ключ і завантажити файл».

Докладно про картку, вікно, налаштування, доступи, «спочатку запитати» й ліміти — [ШІ-співробітники](ai-employees.md); про підключення свого чату — [Остап](ai-ostap.md); про Ломі — [Ломі](kamila.md).

## 3. Ввести й перевірити ключ моделі
1. Відкрийте картку моделі, напр. «Anthropic (Claude)» → «Підключення».
2. Рядок ключа (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `MOONSHOT_API_KEY` або `GOOGLE_AI_KEY`) → «Ввести» → вставте ключ («показати» — побачити, що вставили) → «Зберегти ключ».
3. Ключ зберігається зашифрованим; далі показується лише «задано (••••1234)». Повністю він більше ніде не з'являється й назад через API не віддається. «Змінити» — замінити, «Прибрати» — стерти з CRM.
4. «Перевірити» → «Зв'язок є: моделей: N (перші назви…)». Це лише список моделей, запиту до моделі й витрат нема.
5. У налаштуваннях ШІ-співробітника, вкладка «API» → «Модель», оберіть провайдера й модель — співробітник почне ходити цим ключем.

Перемикач «Інтеграція» на картці моделі — лише позначка; працює ключ. Ключ не вставляйте в чат і не пересилайте — лише в картку.

## 4. Підключити свій чат — без ключа API
На кожній із чотирьох карток є блок «Підключити свій чат — без ключа API»: ваша підписка Claude, ChatGPT, Kimi чи Gemini керує Helomi через чат.
1. «Ключ і файл» → «Створити ключ і завантажити файл».
2. З'явиться ШІ-співробітник «<Провайдер> · сесія» (напр. «Claude · сесія») зі своїми доступами, і завантажиться файл:
   - Claude — пакет навички (.zip): у Claude «Налаштування → Можливості → Навички → Завантажити», або в теку сесії Claude Code / Cowork;
   - ChatGPT — файл-інструкція (.md): прикріпіть у чат або в інструкції свого GPT;
   - Kimi — файл-інструкція (.md) у чат Kimi;
   - Gemini — файл-інструкція (.md) у чат або в Gem.
3. Пишіть у чат: «покажи прострочені угоди», «створи задачу», «зроби розділ Ремонти».

Під кнопкою — «Файл «…» завантажено (ключ …)» і посилання на співробітника: там його «Доступи й ліміти» (вкладка «Налаштування»), а ключ відкликається на вкладці «API». Ключ сесії діє як пароль — не пересилайте файл стороннім.

## 5. Кредити API для підписок Claude Max і Team
Власники підписок Claude отримують кредити API додатково до ліміту підписки: Max 5x — 100 $ на місяць, Max 20x — 200 $ на місяць, Team — до 500 $. Кредити діють лише на API і згоряють у кінці циклу підписки.

Як забрати:
1. claude.ai → Settings → Billing → «API credits».
2. Прив'яжіть організацію Claude Console (потрібно бути на плані 7 днів; прив'язка одна).
3. Кредити видно в Console → Settings → Billing → Promotional credits.
4. Там же, у Console, створіть ключ API і вставте його в картку «Anthropic (Claude)» (розділ 3).

Джерело: https://platform.claude.com/docs/en/about-claude/api-credits-for-subscribers

## Платформні ключі для Ломі
Адміністратор платформи може задати в консолі платформи → «Ломі» один ключ Google (голос) і один ключ Anthropic (мозок) для всіх компаній одразу, з перемикачами «ділитися». Компанія зі своїм ключем у цій картці завжди бере свій; без свого — платформний, якщо ділення дозволено. Платформний ключ Google працює лише для голосу Ломі, платформний ключ Anthropic — лише для її мозку; інші ШІ-співробітники компанії платформних ключів не бачать.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «не задано (у картці чи .env): ANTHROPIC_API_KEY» | «Перевірити» без ключа | Введіть ключ |
| «Помилка: LlmError: Ключ не прийнято» | Ключ недійсний або відкликаний | Створіть новий ключ у консолі сервісу |
| «Немає ключа моделі: додайте його в «Інтеграції → ШІ → …»» | ШІ-співробітник обрав провайдера без ключа | Введіть ключ у відповідну картку |
| «Для цього ШІ не обрано модель з ключем — оберіть провайдера у вкладці «Підключення»» | У налаштуваннях ШІ не вибрано провайдера | Налаштування ШІ → «API» → «Модель» → провайдер і модель |
| «На сервері не встановлено бібліотеку anthropic» | Проблема сервера | Зверніться до підтримки Helomi |
| Кнопки «Додати», «Підключити» сірі | Ви не адміністратор | Попросіть адміністратора |

## Для ШІ-співробітників
5`). ШІ-співробітник не просить вставити ключ у чат — лише в картку «Інтеграції → ШІ». Свій стан і витрати ШІ бачить у пульті. Статтю ШІ читає інструментом `help("int-ai-keys")`.

## Додаткова інформація
- Пов'язані статті: [ШІ-співробітники](ai-employees.md), [Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM](ai-ostap.md), [Ломі](kamila.md).