# Подключение LobsterAI к QCode

> **Последняя проверка**: 2026-11-10 · 📄 По официальной документации (LobsterAI 2026.11.6, выпуск 2026-11-06: README, руководство пользователя, исходный код репозитория)

Можно ли в LobsterAI использовать свой API-ключ? Да. По состоянию на 2026-11-10, согласно официальному README, исходному коду репозитория и ответу сопровождающего: откройте **Settings → Custom Model**, нажмите **+ Add Custom** внизу списка провайдеров, в поле **API Format** выберите **Anthropic Compatible (Messages)** или **OpenAI Compatible (Chat Completions)**, введите Base URL QCode и свой ключ `cr_`, добавьте ID модели и нажмите **Test Connection**.

## Кратко

| Пункт | Подробности |
|---|---|
| Доступные модели | Claude ✅ (Anthropic Compatible) · GPT ✅ (OpenAI Compatible) · GLM / Kimi / DeepSeek / Qwen ✅ (оба формата) · Gemini ❌ (QCode пока не предоставляет) |
| Base URL | Anthropic Compatible (Messages): `https://api.qcode.cc/api` · OpenAI Compatible (Chat Completions): `https://api.qcode.cc/openai/v1` |
| Где настраивать | В приложении: **Settings → Custom Model → + Add Custom** |
| Официальная документация | [Model configuration guide](https://lobsterai.youdao.com/en/docs/lobsterai_model_config_guide) · [User manual](https://lobsterai.youdao.com/en/docs/lobsterai_user_manual) · [Репозиторий на GitHub](https://github.com/netease-youdao/LobsterAI) |

Официальный FAQ описывает LobsterAI (китайское название — Youdao Lobster) как открытый десктопный ИИ-агент от NetEase Youdao, задуманный как офисный помощник для любых задач. Он построен на открытом агентном фреймворке OpenClaw, работает на macOS (Apple Silicon и Intel) и Windows и опубликован на GitHub (netease-youdao/LobsterAI) под лицензией MIT. Это отдельный продукт, не [OpenClaw](/docs/ide/openclaw): OpenClaw — фреймворк среды выполнения, а LobsterAI — десктопный клиент со своим интерфейсом.

Версия: на 2026-11-10 релиз с меткой **Latest** на GitHub — `LobsterAI 2026.11.6` (опубликован 2026-11-06); на главной странице официального сайта в тот же день указана версия 2026.10.30. Названия элементов интерфейса ниже сверены с исходным кодом 2026.11.6.

## Какой протокол выбрать

У пользовательского провайдера несколько форматов API; для повседневной работы с QCode нужны два:

- **Anthropic Compatible (Messages)** + `https://api.qcode.cc/api`: модели Claude, а также GLM / Kimi / DeepSeek / Qwen.
- **OpenAI Compatible (Chat Completions)** + `https://api.qcode.cc/openai/v1`: модели GPT, а также GLM / Kimi / DeepSeek / Qwen.

Один ключ `cr_` подходит для обоих. Модели Claude доступны только через эндпоинт Anthropic, модели GPT — только через эндпоинты OpenAI; полная таблица — в разделе [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths). Формат **OpenAI Compatible (Responses)** описан ниже в необязательном разделе.

## Установка

Официальный README ведёт на [страницу загрузки](https://lobsterai.youdao.com/#/download-list) (macOS Apple Silicon, macOS Intel, Windows x64) или к последним установщикам в GitHub Releases. Аккаунт у разработчика моделей не нужен: создайте ключ `cr_` в [панели управления](https://qcode.cc/dashboard) и держите его под рукой.

## Настройка

Официальные источники описывают путь в меню немного по-разному:

- README: свой API-ключ добавляется в **Settings → Custom Model**.
- Ответ сопровождающего репозитория в issue #362 (2026-10-06): «add a custom provider under Settings → Custom Models … choose OpenAI-compatible with base URL … and the … key, add a model ID … and run Test Connection». В том же ответе сказано, что после успешной проверки провайдер включается автоматически и его можно выбрать в селекторе моделей поля ввода; второй вариант — Anthropic-совместимый формат.
- В руководстве пользователя и руководстве по настройке моделей встроенные провайдеры (DeepSeek, Moonshot, Zhipu, MiniMax, Qwen и другие) настраиваются в **Settings → Models**. QCode добавляется в **Custom Model**.

### Шаг 1: добавьте пользовательского провайдера

1. Откройте Settings и перейдите в **Custom Model**.
2. Нажмите **+ Add Custom** внизу списка провайдеров.
3. Заполните поля (названия — как в английских строках интерфейса в исходном коде 2026.11.6).

| Поле | Claude и китайские модели | GPT и китайские модели |
|---|---|---|
| Display Name | `QCode` (любое имя) | `QCode OpenAI` (любое имя) |
| API Format | `Anthropic Compatible (Messages)` | `OpenAI Compatible (Chat Completions)` |
| API Base URL | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| API Key | `cr_xxx` | `cr_xxx` |

Чтобы пользоваться обоими форматами, добавьте двух пользовательских провайдеров. По официальному журналу изменений одновременно можно подключить несколько пользовательских провайдеров, не более 30.

### Шаг 2: нужен ли `/v1` в Base URL?

Ответ дают три официальных источника:

1. Подсказка под полем **API Format**: «Must match the protocol behind your Base URL; OpenAI-compatible URLs usually end with /v1».
2. Примеры под полем Base URL («Examples (SiliconFlow, click to fill)») связывают **OpenAI Compatible** с `https://api.siliconflow.cn/v1`, а **Anthropic Compatible** — с `https://api.siliconflow.cn`, без `/v1` (исходный код репозитория).
3. **Test Connection** сам собирает путь запроса (исходный код репозитория, 2026.11.6). Формат Anthropic отправляет запрос на Base URL + `/v1/messages`, а если Base URL уже заканчивается на `/v1`, добавляет только `/messages`. Формат OpenAI Chat Completions добавляет `/chat/completions`, когда Base URL заканчивается версией вроде `/v1`, а иначе сначала дописывает `/v1`. Формат Responses отправляет на Base URL + `/responses` и тоже сначала дописывает `/v1`, если его нет.

Поэтому для Anthropic Compatible укажите `https://api.qcode.cc/api` (проверка обратится к `/api/v1/messages`), а для OpenAI Compatible — `https://api.qcode.cc/openai/v1` (проверка обратится к `/openai/v1/chat/completions`). Не дописывайте в поле `/v1/messages` или `/chat/completions` вручную. На установленном LobsterAI мы эту настройку не проверяли, поэтому окончательный ответ даёт результат **Test Connection**. При нестабильной сети можно заменить хост на `asia.qcode.cc` (Азия) или `us.qcode.cc` (Северная Америка); путь не меняется.

### Шаг 3: добавьте модель и проверьте соединение

1. В новом провайдере нажмите **Add Model** и заполните **Model Name** (название в списке) и **Model ID**.
2. **Model ID** должен символ в символ совпадать с моделью в продаже на [qcode.cc/models](https://qcode.cc/models), например:

| API Format | Примеры Model ID |
|---|---|
| Anthropic Compatible (Messages) | `claude-sonnet-5-5`, `claude-opus-5-5`, `claude-haiku-5-5`, `glm-5.3`, `deepseek-v4.1-flash`, `kimi-k3`, `qwen3.8-max` |
| OpenAI Compatible (Chat Completions) | `gpt-6.1-sol`, `gpt-6.1-terra`, `glm-5.3`, `deepseek-v4.1-flash`, `kimi-k3`, `qwen3.8-max` |

3. Нажмите **Test Connection**. Согласно ответу сопровождающего в issue #362, после успешной проверки провайдер включается автоматически, и его можно выбрать в селекторе моделей поля ввода. Цены по моделям — на https://qcode.cc/models.

### Необязательно: OpenAI Compatible (Responses)

В официальных примечаниях к выпуску 2026.10.23 сказано: «Custom providers now support OpenAI Responses and Gemini native APIs.» Вариант называется **OpenAI Compatible (Responses)**, подсказка к нему: «Requires the provider to support the OpenAI Responses API. Requests go to Base URL + /responses.» В QCode Responses обслуживает модели GPT; с Base URL `https://api.qcode.cc/openai/v1` запрос уходит на `/openai/v1/responses`, а страница эндпоинтов указывает, что этот путь равнозначен `/openai/responses`. Для повседневной работы достаточно **OpenAI Compatible (Chat Completions)**. Модели Gemini QCode пока не предоставляет, поэтому вариант **Gemini (generateContent)** не нужен.

## Проверка

1. Нажмите **Test Connection**; сообщение «Connection successful» значит, что путь и ключ в порядке.
2. Вернитесь в поле ввода, выберите новую модель в селекторе и отправьте `ping`.
3. Чтобы сначала проверить сеть и ключ из терминала (ответ 400 на пустое тело означает, что путь и ключ в порядке):

```bash
KEY="cr_your_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/api/v1/messages -H "x-api-key: $KEY"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# 400 = path and key fine; 401 = bad key; 404 = wrong path prefix
```

Каждый запрос отображается на [probe.qcode.cc](https://probe.qcode.cc): введите свой ключ, чтобы увидеть модель и код ответа каждого вызова.

## Известные ограничения и частые ошибки

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

- **Responses у пользовательских провайдеров (issue #185)**: в issue #185 (открыт 2026-02-28) просили поддержать новый формат API OpenAI у пользовательских провайдеров; тогда сопровождающий советовал переключить язык приложения на английский и использовать встроенного провайдера OpenAI. Сейчас: начиная с 2026.10.23 пользовательские провайдеры поддерживают OpenAI Responses (см. необязательный раздел выше).
- **Язык интерфейса меняет список встроенных провайдеров**: в issue #87 и #185 сопровождающий объясняет, что в английском интерфейсе появляются дополнительные встроенные провайдеры, например OpenAI и Gemini. Сейчас: в исходном коде 2026.11.6 встроенный список по-прежнему зависит от языка интерфейса, а пользовательские провайдеры показываются на обоих языках, так что настройка QCode одинакова в китайском и английском интерфейсе.
- **ID Claude добавлен в формате OpenAI**: QCode отвечает `model_not_available_on_endpoint`. Переключите **API Format** этого провайдера на **Anthropic Compatible (Messages)** и укажите `https://api.qcode.cc/api`; это несовпадение протокола, а не проблема ключа.
- **Неизвестный ID модели**: в issue #87 другой сервис ответил `invalid param model:claude-haiku-4-5-20251001` (400), потому что не знал такой ID. С QCode используйте только ID, которые продаются на [qcode.cc/models](https://qcode.cc/models).
- Таблица ошибок в официальном руководстве по настройке моделей содержит четыре сообщения: «API Key Invalid», «Insufficient Balance», «Network Error» и «Service Unavailable». Для QCode: заново скопируйте ключ `cr_` целиком, проверьте баланс QCode, проверьте сеть, затем — состояние сервиса.
- Хранение ключа: в официальном руководстве сказано, что API-ключ хранится только на вашем устройстве и не загружается ни на какой сервер.

## Связанные документы

- [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths) — протоколы и заполнение Base URL
- [Обзор совместимости инструментов](/docs/ide/tool-compatibility) — поддержка протоколов во всех инструментах
- [Подключение OpenClaw](/docs/ide/openclaw) — фреймворк OpenClaw, на котором построен LobsterAI
- [AutoClaw](/docs/ide/autoclaw) — локальное приложение OpenClaw от Zhipu (пользовательские модели работают по протоколу OpenAI)
- [Qoder](/docs/ide/qoder) — ещё один десктопный агент, в пользовательских моделях которого можно указать эндпоинты Anthropic и OpenAI
- [Китайские модели](/docs/usage/cn-models) — актуальные ID GLM / Kimi / DeepSeek / Qwen в продаже
- [Руководство по устранению неисправностей](/docs/reference/troubleshooting)