HarmonyAI API

Самый короткий путь: агент читает адрес сервера и ключ из переменных окружения, переделывать ничего не нужно.

1. Установите Claude Code

   Нужен Node.js 18 или новее.

   npm install -g @anthropic-ai/claude-code

2. Укажите адрес и ключ

   macOS и Linux

   export ANTHROPIC_BASE_URL="https://api.harmonyai.ru"
   export ANTHROPIC_AUTH_TOKEN="sk-h-ваш-ключ"
   export ANTHROPIC_MODEL="dynatos"
   export ANTHROPIC_DEFAULT_HAIKU_MODEL="adanatos"

   Windows, PowerShell

   $env:ANTHROPIC_BASE_URL="https://api.harmonyai.ru"
   $env:ANTHROPIC_AUTH_TOKEN="sk-h-ваш-ключ"
   $env:ANTHROPIC_MODEL="dynatos"
   $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="adanatos"

3. Запустите

   claude

   Модель на ходу переключает флаг --model или команда /model.

4. Чтобы не задавать переменные каждый раз

   Перенесите их в ~/.claude/settings.json — файл сильнее оболочки.

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://api.harmonyai.ru",
       "ANTHROPIC_AUTH_TOKEN": "sk-h-ваш-ключ",
       "ANTHROPIC_MODEL": "dynatos",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "adanatos",
       "ANTHROPIC_DEFAULT_SONNET_MODEL": "dynatos",
       "ANTHROPIC_DEFAULT_OPUS_MODEL": "dynatos"
     }
   }

Настольное приложение Claude Code для macOS и Windows берёт настройки из того же файла, что и CLI, — достаточно прописать адрес шлюза и перезапустить программу.

1. Откройте файл настроек

   macOS и Linux

   ~/.claude/settings.json

   Windows

   %USERPROFILE%\.claude\settings.json

   Если файла нет — создайте его.

2. Впишите блок env

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://api.harmonyai.ru",
       "ANTHROPIC_AUTH_TOKEN": "sk-h-ваш-ключ",
       "ANTHROPIC_MODEL": "dynatos",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "adanatos",
       "ANTHROPIC_DEFAULT_SONNET_MODEL": "dynatos",
       "ANTHROPIC_DEFAULT_OPUS_MODEL": "dynatos"
     }
   }

3. Полностью закройте и снова откройте приложение

   Файл настроек читается при запуске: пока окно не перезапущено, программа продолжает обращаться к прежнему серверу.

Встроенные модели Cursor к чужому адресу не переключаются, зато редактор понимает расширения VS Code — подключаемся через Cline или Roo Code.

1. Установите расширение

   Ctrl/Cmd + Shift + X → найдите Cline (или Roo Code — настройки те же) → Install.

2. Откройте настройки расширения

   Значок шестерёнки на его панели.

3. Заполните три поля

   API Provider	Anthropic
   Use custom base URL	включить → https://api.harmonyai.ru
   API Key	sk-h-ваш-ключ

4. Выберите модель

   dynatos для сложных задач, adanatos для быстрых. Если список предлагает только официальные названия — введите идентификатор вручную.

OpenCode умеет добавлять свои провайдеры. Описываем HarmonyAI как провайдер формата Anthropic — и обе модели появляются в общем списке.

1. Откройте файл настроек

   Общий для всех проектов — ~/.config/opencode/opencode.json. Только для текущего — opencode.json в корне проекта.

2. Добавьте провайдер

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "harmony": {
         "npm": "@ai-sdk/anthropic",
         "name": "HarmonyAI",
         "options": {
           "baseURL": "https://api.harmonyai.ru/v1",
           "apiKey": "sk-h-ваш-ключ"
         },
         "models": {
           "dynatos":  { "name": "Dynatos" },
           "adanatos": { "name": "Adanatos" }
         }
       }
     }
   }

3. Выберите модель в интерфейсе

   opencode

   Команда /models → раздел HarmonyAI.

Прямые запросы к шлюзу. Формат — Anthropic Messages API, так что подходит любая библиотека, которая умеет его отправлять.

1. Обычный запрос

   curl https://api.harmonyai.ru/v1/messages \
     -H "Authorization: Bearer $HARMONY_API_KEY" \
     -H "Content-Type: application/json" \
     -H "anthropic-version: 2023-06-01" \
     -d '{
       "model": "adanatos",
       "max_tokens": 1024,
       "messages": [
         { "role": "user", "content": "Объясни, что такое SSE" }
       ]
     }'

2. Потоковый ответ

   Добавьте "stream": true и флаг -N, чтобы cURL не буферизовал вывод.

   curl -N https://api.harmonyai.ru/v1/messages \
     -H "Authorization: Bearer $HARMONY_API_KEY" \
     -H "Content-Type: application/json" \
     -H "anthropic-version: 2023-06-01" \
     -d '{
       "model": "dynatos",
       "max_tokens": 2048,
       "stream": true,
       "messages": [{ "role": "user", "content": "Напиши хайку про кэш" }]
     }'

3. Официальный SDK — TypeScript и JavaScript

   import Anthropic from '@anthropic-ai/sdk';
   
   const client = new Anthropic({
     baseURL: 'https://api.harmonyai.ru',
     apiKey: process.env.HARMONY_API_KEY,
   });
   
   const stream = await client.messages.stream({
     model: 'adanatos',
     max_tokens: 1024,
     messages: [{ role: 'user', content: 'Напиши регулярку для e-mail' }],
   });
   
   for await (const event of stream) {
     if (event.type === 'content_block_delta' && event.delta.type === 'text_delta') {
       process.stdout.write(event.delta.text);
     }
   }

4. Список моделей и подсчёт токенов

   curl https://api.harmonyai.ru/v1/models \
     -H "Authorization: Bearer $HARMONY_API_KEY"

   Сколько токенов займёт запрос — до его отправки и без списания:

   curl https://api.harmonyai.ru/v1/messages/count_tokens \
     -H "Authorization: Bearer $HARMONY_API_KEY" \
     -H "Content-Type: application/json" \
     -H "anthropic-version: 2023-06-01" \
     -d '{
       "model": "dynatos",
       "messages": [{ "role": "user", "content": "Длинный текст…" }]
     }'

Официальная библиотека anthropic работает со шлюзом без изменений — достаточно передать base_url.

1. Установите библиотеку

   pip install anthropic

2. Положите ключ в переменную окружения

   macOS и Linux

   export HARMONY_API_KEY="sk-h-ваш-ключ"

   Windows, PowerShell

   $env:HARMONY_API_KEY="sk-h-ваш-ключ"

3. Потоковый ответ

   import os
   from anthropic import Anthropic
   
   client = Anthropic(
       base_url="https://api.harmonyai.ru",
       api_key=os.environ["HARMONY_API_KEY"],
   )
   
   with client.messages.stream(
       model="dynatos",
       max_tokens=2048,
       messages=[{"role": "user", "content": "Разбери этот SQL-запрос"}],
   ) as stream:
       for text in stream.text_stream:
           print(text, end="", flush=True)

4. Обычный ответ и расход токенов

   msg = client.messages.create(
       model="adanatos",
       max_tokens=512,
       messages=[{"role": "user", "content": "Привет!"}],
   )
   
   print(msg.content[0].text)
   print(msg.usage.input_tokens, msg.usage.output_tokens)

Запрос из Invoke-RestMethod, без сторонних модулей.

1. Сохраните ключ

   Только на текущую сессию:

   $env:HARMONY_API_KEY = "sk-h-ваш-ключ"

   Навсегда — для своей учётной записи:

   [Environment]::SetEnvironmentVariable(
     "HARMONY_API_KEY", "sk-h-ваш-ключ", "User")

2. Отправьте запрос

   $body = @{
     model      = "adanatos"
     max_tokens = 512
     messages   = @(@{ role = "user"; content = "Привет! Ответь одним предложением." })
   } | ConvertTo-Json -Depth 5
   
   $res = Invoke-RestMethod -Method Post `
     -Uri "https://api.harmonyai.ru/v1/messages" `
     -Headers @{
       "Authorization"     = "Bearer $env:HARMONY_API_KEY"
       "anthropic-version" = "2023-06-01"
     } `
     -ContentType "application/json" `
     -Body ([Text.Encoding]::UTF8.GetBytes($body))
   
   $res.content[0].text

3. Claude Code в том же окне

   $env:ANTHROPIC_BASE_URL = "https://api.harmonyai.ru"
   $env:ANTHROPIC_AUTH_TOKEN = "sk-h-ваш-ключ"
   $env:ANTHROPIC_MODEL = "dynatos"
   $env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "adanatos"
   
   claude

Ключ хранится в отдельном файле, а не в истории команд, — и любой запрос становится одной строкой.

1. Положите ключ в файл и закройте доступ другим

   printf '%s' 'sk-h-ваш-ключ' > ~/.harmony-key
   chmod 600 ~/.harmony-key

2. Подключите его к оболочке

   Строка для ~/.zshrc или ~/.bashrc:

   export HARMONY_API_KEY="$(cat ~/.harmony-key)"

   Применить сразу, не открывая новое окно: source ~/.zshrc.

3. Спросите что-нибудь одной командой

   Ответ разбираем через jq, чтобы не читать JSON глазами.

   ask() {
     curl -s https://api.harmonyai.ru/v1/messages \
       -H "Authorization: Bearer $HARMONY_API_KEY" \
       -H "Content-Type: application/json" \
       -H "anthropic-version: 2023-06-01" \
       -d "$(jq -n --arg q "$*" '{
             model: "adanatos",
             max_tokens: 1024,
             messages: [{ role: "user", content: $q }]
           }')" | jq -r '.content[0].text'
   }
   
   ask "Чем tar отличается от zip?"

4. Claude Code в этой же оболочке

   export ANTHROPIC_BASE_URL="https://api.harmonyai.ru"
   export ANTHROPIC_AUTH_TOKEN="$HARMONY_API_KEY"
   export ANTHROPIC_MODEL="dynatos"
   export ANTHROPIC_DEFAULT_HAIKU_MODEL="adanatos"
   
   claude