Roo Code — форк Cline для VS Code, настраивается так же. Сторонний ключ — без ограничений.
- Установите расширение Roo Code из Marketplace VS Code.
- Settings → API Provider → Anthropic.
- Отметьте Use custom base URL →
https://api.guardrelay.ai. - API Key —
gd-…из бота. - Model —
claude-sonnet-5-5илиclaude-opus-5.
Kimi работает с обоими провайдерами. У Anthropic впишите Custom Base URL https://api.guardrelay.ai, у OpenAI-совместимого Base URL https://api.guardrelay.ai/v1. Ключ тот же gd-… и баланс общий, в поле Model один из четырёх Kimi ID.
Принимают оба адреса: https://api.guardrelay.ai у провайдера Anthropic и https://api.guardrelay.ai/v1 у OpenAI-совместимого. В Model укажите точный id, например cursor-grok-4.6-medium или composer-2.5-fast.
Эта инструкция относится к уже установленному Roo Code 3.54. Для новой установки предпочтительнее поддерживаемый Cline. Откройте в VS Code отдельную тестовую папку и панель Roo Code.
Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
- Нажмите шестерёнку Roo Code и выберите API Provider → OpenAI Compatible. Не выбирайте Native Responses.
- Укажите Base URL
https://api.guardrelay.ai/glm/v1, API Keygd-…и Modelglm-5.3. - Оставьте Enable streaming включённым. Выключите Enable R1 model parameters, Use Azure, Enable Reasoning Effort и custom temperature; Custom Headers оставьте пустым.
- Если включён Include max output tokens, задайте Max Output Tokens
4096как ограниченный клиентский пример. Не считайте значение Context Window Size лимитом GLM и не публикуйте его как характеристику модели.
| Поле Roo Code | Значение |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.guardrelay.ai/glm/v1 |
| API Key | gd-… |
| Model | glm-5.3 |
| Max Output Tokens | 4096 |
| Итоговый запрос | POST https://api.guardrelay.ai/glm/v1/chat/completions |
- Откройте новую задачу и отправьте:
Прочитай README.md и ответь ровно GUARD_GLM_OK. Ничего не меняй. - Разрешите только чтение. Затем в той же задаче попросите назвать строку без повторного открытия файла.
- Если первая команда сообщает об отсутствующем
rgили не находит файлы, это клиентская зависимость Roo: используйте переустановку/обновление или Cline.
| Model ID | Что использовать |
|---|---|
glm-5.3 | Основная модель; текст и задачи с кодом. |
glm-5.3-flash | Быстрая модель; на уровне API принимает PNG и PDF во всех трёх протоколах, MP4 — только в Chat Completions. |
- С учётом указанной зависимости подтверждены streaming Chat, локальные инструменты и продолжение одной задачи.
- Инструменты чтения, правки и терминала исполняет сам клиент. Этот профиль не подключает инструменты или MCP Z.AI автоматически.
- Chat API допускает MP4 с Flash, а PNG/PDF — на уровне API; вложения через интерфейс Roo не проверялись.
- Профиль использует OpenAI-compatible Chat Completions. Серверный промпт GLM для обычного API выключен по умолчанию; настройка клиента сама его не включает.
- Native TXT, DOCX и XLSX не входят в подтверждённый GLM-контракт. Для документов используйте PDF; для изображений — PNG и модель
glm-5.3-flash.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID равен ровно glm-5.3 или glm-5.3-flash; старые GLM ID, aliases, Turbo и FlashX не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/glm/v1. Клиент сам добавляет /chat/completions; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции API format; из старого профиля не перенесены reasoning, temperature, MCP или другие непроверенные поля. |
402 insufficient_balance | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
| Модель подменяется или запрос идёт не туда | Выберите именно OpenAI Compatible, exact glm-5.3 и выключите Native Responses, R1 и Reasoning Effort. |
Для новой установки предпочтительнее поддерживаемый Cline. Откройте в VS Code отдельную тестовую папку и панель Roo Code.
Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
- Нажмите шестерёнку Roo Code и выберите API Provider → OpenAI Compatible. Не выбирайте Native Responses.
- Укажите Base URL
https://api.guardrelay.ai/v1, API Keygd-…и Modelgemini-4-argon. - Оставьте Enable streaming включённым. Выключите Enable R1 model parameters, Use Azure, Enable Reasoning Effort и custom temperature; Custom Headers оставьте пустым.
- Если включён Include max output tokens, задайте Max Output Tokens
4096как ограниченный клиентский пример.
| Поле Roo Code | Значение |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.guardrelay.ai/v1 |
| API Key | gd-… |
| Model | gemini-4-argon |
| Max Output Tokens | 4096 |
| Итоговый запрос | POST https://api.guardrelay.ai/v1/chat/completions |
- Откройте новую задачу и отправьте:
Прочитай README.md и ответь ровно GUARD_GEMINI_OK. Ничего не меняй. - Разрешите только чтение. Затем в той же задаче попросите назвать строку без повторного открытия файла.
| Model ID | Вход и окно |
|---|---|
gemini-4-argon | Текст, изображения, PDF; окно 1 048 576 токенов, общее на вход и ответ. |
gemini-3.8-flash | Текст, изображения, PDF; окно 1 048 576 токенов на вход. |
- Файловые и терминальные инструменты исполняет сам Roo Code; историю задачи он передаёт Gemini в каждом запросе.
- Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
- Профиль использует OpenAI-compatible Chat Completions. Серверный промпт — отдельная настройка семейства Gemini: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID — точный ID из таблицы выше или короткое имя gemini; другие написания не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/v1. Клиент сам добавляет /chat/completions; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие. |
402 insufficient_credit | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
| Модель подменяется или запрос идёт не туда | Выберите именно OpenAI Compatible, точный gemini-4-argon и выключите Native Responses, R1 и Reasoning Effort. |
Для новой установки предпочтительнее поддерживаемый Cline. Откройте в VS Code отдельную тестовую папку и панель Roo Code.
Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
- Нажмите шестерёнку Roo Code и выберите API Provider → OpenAI Compatible. Не выбирайте Native Responses.
- Укажите Base URL
https://api.guardrelay.ai/v1, API Keygd-…и Modelmuse-wonder-1.0. - Оставьте Enable streaming включённым. Выключите Enable R1 model parameters, Use Azure, Enable Reasoning Effort и custom temperature; Custom Headers оставьте пустым.
- Если включён Include max output tokens, задайте Max Output Tokens
4096как ограниченный клиентский пример.
| Поле Roo Code | Значение |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.guardrelay.ai/v1 |
| API Key | gd-… |
| Model | muse-wonder-1.0 |
| Max Output Tokens | 4096 |
| Итоговый запрос | POST https://api.guardrelay.ai/v1/chat/completions |
- Откройте новую задачу и отправьте:
Прочитай README.md и ответь ровно GUARD_MUSE_OK. Ничего не меняй. - Разрешите только чтение. Затем в той же задаче попросите назвать строку без повторного открытия файла.
| Model ID | Вход и окно |
|---|---|
muse-wonder-1.0 | Текст, изображения, PDF; окно 1 048 576 токенов. |
muse-spark-1.3 | Текст, изображения, PDF; окно 1 048 576 токенов. |
muse-spark-1.2 | Текст, изображения, PDF; окно 1 048 576 токенов. |
- Файловые и терминальные инструменты исполняет сам Roo Code; историю задачи он передаёт Muse в каждом запросе.
- Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
- Профиль использует OpenAI-compatible Chat Completions. Серверный промпт — отдельная настройка семейства Muse: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID — точный ID из таблицы выше или короткое имя muse; другие написания не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/v1. Клиент сам добавляет /chat/completions; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие. |
402 insufficient_credit | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
| Модель подменяется или запрос идёт не туда | Выберите именно OpenAI Compatible, точный muse-wonder-1.0 и выключите Native Responses, R1 и Reasoning Effort. |
Этот раздел для тех, у кого расширение Roo Code уже установлено: разработка расширения закрыта. Для новой установки используйте поддерживаемый Cline. В существующем Roo Code семейство Codex настраивается через OpenAI Compatible и Chat Completions. Ключ gd-… получите в боте Guard.
Для проверки можно использовать обычный чат без файлов: отправьте «Ответь: связь установлена». Чтобы проверить работу с проектом, создайте в Проводнике или Finder отдельную папку guard-test, откройте её в редакторе и создайте файл README.md с текстом «Это тестовый проект Guard». Дальнейший пример чтения относится к этой папке.
| Model ID | Название |
|---|---|
gpt-6-astra | GPT-6 Astra |
gpt-6.1-sol | GPT-6.1 Sol |
gpt-6-sol | GPT-6 Sol |
gpt-6-luna | GPT-6 Luna |
gpt-5.6-sol | GPT-5.6 Sol |
gpt-5.6-terra | GPT-5.6 Terra |
gpt-5.6-luna | GPT-5.6 Luna |
- Откройте VS Code и через File → Open Folder тестовую папку без секретов с
README.md. Откройте панель Roo Code значком сбоку и нажмите шестерёнку настроек. - В API Provider выберите OpenAI Compatible, а не Anthropic, OpenAI или Native Responses.
- В Base URL укажите
https://api.guardrelay.ai/codex/v1. - В API Key вставьте свой ключ
gd-…из бота; не помещайте его в текст задачи или файл проекта. - В Model выберите или вручную введите ровно
gpt-6-astra. Выключите Enable Streaming, Include Max Output Tokens, R1 format, Use Azure, Set reasoning level и Advanced → Use custom temperature; оставьте Custom Headers пустым. Другие точные ID и effort — на странице Модели. - Сохраните настройки, откройте новую задачу Roo Code и отправьте:
Прочитай README.md и объясни в двух предложениях, о чём этот тестовый проект. Ничего не меняй. Если Roo Code спросит разрешение, разрешайте только чтение файла. - Продолжите в той же задаче:
Назови один факт из README.md, на котором основано объяснение. Для другого вопроса создайте новую задачу.
| Поле Roo Code | Значение |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.guardrelay.ai/codex/v1 |
| API Key | gd-… |
| Model | gpt-6-astra |
| Итоговый запрос | POST https://api.guardrelay.ai/codex/v1/chat/completions |
После проверки чтения можно поручить изменение: «Добавь в README.md раздел Проверка и одну строку описания». Просмотрите предложенную правку и подтвердите её, если она соответствует задаче. Команды, доступ к файлам и инструменты разрешаются в самом клиенте; для подключения Guard не нужно заранее выдавать неограниченный доступ ко всему компьютеру.