OpenCode

OpenCode на универсальном ключе Guard API.

Протокол модели

Claude, Kimi, Composer и Grok

Команды этого раздела берут ключ из переменной GUARD_API_KEY. Введите его в скрытом приглашении; переменная действует только в этом терминале и запущенном из него клиенте.

Переменные окружения

bash · macOS / Linux

{
unset GUARD_API_KEY
until [ -n "${GUARD_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_API_KEY || break; printf "\n"; done
export GUARD_API_KEY
}

PowerShell · Windows

do {
  $guardKey = Read-Host "Guard API key" -AsSecureString
  $env:GUARD_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
} until ($env:GUARD_API_KEY)

OpenCode настраивается аналогично Claude Code — через переменные Anthropic.

Переменные окружения

bash · macOS / Linux

export ANTHROPIC_BASE_URL="https://api.guardrelay.ai"
export ANTHROPIC_API_KEY="$GUARD_API_KEY"

PowerShell · Windows

$env:ANTHROPIC_BASE_URL = "https://api.guardrelay.ai"
$env:ANTHROPIC_API_KEY = "$env:GUARD_API_KEY"

Kimi, Composer и Grok

Переменные ANTHROPIC_* ведут OpenCode на /v1/messages. Composer и Grok эту поверхность принимают вместе с клиентскими инструментами.

Переменные окружения

bash · macOS / Linux

export ANTHROPIC_BASE_URL="https://api.guardrelay.ai"
export ANTHROPIC_API_KEY="$GUARD_API_KEY"
# затем в клиенте выберите модель, например cursor-grok-4.6-high или composer-2.5

PowerShell · Windows

$env:ANTHROPIC_BASE_URL = "https://api.guardrelay.ai"
$env:ANTHROPIC_API_KEY = "$env:GUARD_API_KEY"
# затем в клиенте выберите модель, например cursor-grok-4.6-high или composer-2.5

Для Kimi настройте в OpenCode OpenAI-совместимого провайдера на https://api.guardrelay.ai/v1 и укажите один из четырёх Kimi ID.

Kimi в OpenCode

Переменные ANTHROPIC_* уводят OpenCode на протокол Anthropic Messages. Ниже описан путь через OpenAI-совместимого провайдера: он настраивается теми же двумя значениями, адресом и ключом.

Возьмите OpenAI-совместимого провайдера. Базовый адрес https://api.guardrelay.ai/v1 ровно с /v1, заголовок Authorization: Bearer gd-…, в поле модели один из четырёх id: k3, k3-256k, kimi-for-coding или kimi-for-coding-highspeed.

Сначала убедитесь, что ключ отвечает. Команда ниже возвращает текст модели:

bash

curl -X POST https://api.guardrelay.ai/v1/chat/completions \
  -H "Authorization: Bearer $GUARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "k3",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 128
  }'

GLM 5.3 в OpenCode

Установите OpenCode

Следуйте официальной инструкции OpenCode. На macOS/Linux используйте первый блок; на Windows с Node.js — второй.

bash

curl -fsSL https://opencode.ai/install | bash
opencode --version

powershell

npm install -g opencode-ai
opencode --version

Получите ключ Guard

Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.

Создайте отдельную конфигурацию GLM

Сохраните пример отдельным файлом ~/.config/opencode-guard-glm/opencode.json (Windows: %USERPROFILE%\.config\opencode-guard-glm\opencode.json). Не заменяйте обычный global config: переменная OPENCODE_CONFIG подключит этот файл только к запуску GLM. Полное имя модели — openai/glm-5.3.

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/glm-5.3",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "{env:GUARD_GLM_BASE_URL}",
        "apiKey": "{env:GUARD_GLM_API_KEY}"
      },
      "models": {
        "glm-5.3": { "name": "GLM 5.3" },
        "glm-5.3-flash": { "name": "GLM 5.3 Flash" }
      }
    }
  }
}

Конфигурация содержит только ссылки на переменные. Перед запуском задайте ключ, Base URL и путь OPENCODE_CONFIG.

macOS / Linux: введите ключ в скрытом приглашении. Переменная действует только в этом терминале и запущенном из него клиенте.

{
unset GUARD_GLM_API_KEY
until [ -n "${GUARD_GLM_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_GLM_API_KEY || break; printf "\n"; done
export GUARD_GLM_API_KEY
export GUARD_GLM_BASE_URL="https://api.guardrelay.ai/glm/v1"
export OPENCODE_CONFIG="$HOME/.config/opencode-guard-glm/opencode.json"
opencode
}

Windows PowerShell: выполните команды в том же окне, из которого запускаете клиент. При открытии нового PowerShell задайте ключ снова.

powershell

$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_GLM_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
$env:GUARD_GLM_BASE_URL = "https://api.guardrelay.ai/glm/v1"
$env:OPENCODE_CONFIG = "$HOME/.config/opencode-guard-glm/opencode.json"
opencode

Быстрая проверка и продолжение

В интерактивном окне выберите openai/glm-5.3 через /models. Для короткой команды и последующего продолжения используйте:

bash

opencode run --model openai/glm-5.3 "Reply with exactly GLM_OK and remember PINE"
opencode run --continue "What word were you asked to remember?"

Модели и подтверждённые возможности

Model ID	Что использовать
`glm-5.3`	Основная модель; текст и задачи с кодом.
`glm-5.3-flash`	Быстрая модель; на уровне API принимает PNG и PDF во всех трёх протоколах, MP4 — только в Chat Completions.

Работают Responses, локальные инструменты чтения, правки и shell, а также --continue для того же сеанса.
Инструменты чтения, правки и терминала исполняет сам клиент. Этот профиль не подключает инструменты или MCP Z.AI автоматически.
Проверка этой версии была текстовой и не подтверждает её кнопку вложений. Возможности Flash на уровне API не означают, что конкретный интерфейс умеет передать файл.
Профиль использует OpenAI Responses. Серверный промпт 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`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции API format; из старого профиля не перенесены reasoning, temperature, MCP или другие непроверенные поля.
`402 insufficient_balance`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
Модель отсутствует в `/models`	Проверьте `OPENCODE_CONFIG`, `provider.openai.models`, полное имя `openai/glm-5.3` и отсутствие project-level файла, который переопределяет эту модель.

Gemini в OpenCode

Установите OpenCode

Следуйте официальной инструкции OpenCode. На macOS/Linux используйте первый блок; на Windows с Node.js — второй.

bash

curl -fsSL https://opencode.ai/install | bash
opencode --version

powershell

npm install -g opencode-ai
opencode --version

Получите ключ Guard

Создайте отдельную конфигурацию Gemini

Сохраните пример отдельным файлом ~/.config/opencode-guard-gemini/opencode.json (Windows: %USERPROFILE%\.config\opencode-guard-gemini\opencode.json). Не заменяйте обычный global config: переменная OPENCODE_CONFIG подключит этот файл только к запуску Gemini. Полное имя модели — openai/gemini-4-argon.

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/gemini-4-argon",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "{env:GUARD_GEMINI_BASE_URL}",
        "apiKey": "{env:GUARD_GEMINI_API_KEY}"
      },
      "models": {
        "gemini-4-argon": { "name": "Gemini 4 Argon" },
        "gemini-3.8-flash": { "name": "Gemini 3.8 Flash" }
      }
    }
  }
}

Конфигурация содержит только ссылки на переменные. Перед запуском задайте ключ, Base URL и путь OPENCODE_CONFIG.

{
unset GUARD_GEMINI_API_KEY
until [ -n "${GUARD_GEMINI_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_GEMINI_API_KEY || break; printf "\n"; done
export GUARD_GEMINI_API_KEY
export GUARD_GEMINI_BASE_URL="https://api.guardrelay.ai/v1"
export OPENCODE_CONFIG="$HOME/.config/opencode-guard-gemini/opencode.json"
opencode
}

powershell

$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_GEMINI_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
$env:GUARD_GEMINI_BASE_URL = "https://api.guardrelay.ai/v1"
$env:OPENCODE_CONFIG = "$HOME/.config/opencode-guard-gemini/opencode.json"
opencode

Быстрая проверка и продолжение

В интерактивном окне выберите openai/gemini-4-argon через /models. Для короткой команды и последующего продолжения используйте:

bash

opencode run --model openai/gemini-4-argon "Reply with exactly GEMINI_OK and remember PINE"
opencode run --continue "What word were you asked to remember?"

Модели и возможности Gemini

Model ID	Вход и окно
`gemini-4-argon`	Текст, изображения, PDF; окно 1 048 576 токенов, общее на вход и ответ.
`gemini-3.8-flash`	Текст, изображения, PDF; окно 1 048 576 токенов на вход.

Локальные инструменты чтения, правки и shell исполняет сам OpenCode; --continue продолжает тот же сеанс.
Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
Профиль использует OpenAI Responses. Серверный промпт — отдельная настройка семейства Gemini: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.

Если подключение не получилось

Признак	Что проверить
`401 invalid_api_key`	Клиент получил полный действующий ключ `gd-…`; переменная задана в том же процессе, где запущен клиент.
`404 model_not_found`	Model ID — точный ID из таблицы выше или короткое имя `gemini`; другие написания не поддерживаются.
`404` или неверный путь	Base URL равен `https://api.guardrelay.ai/v1`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие.
`402 insufficient_credit`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
Модель отсутствует в `/models`	Проверьте `OPENCODE_CONFIG`, `provider.openai.models`, полное имя `openai/gemini-4-argon` и отсутствие project-level файла, который переопределяет эту модель.

Muse в OpenCode

Установите OpenCode

Следуйте официальной инструкции OpenCode. На macOS/Linux используйте первый блок; на Windows с Node.js — второй.

bash

curl -fsSL https://opencode.ai/install | bash
opencode --version

powershell

npm install -g opencode-ai
opencode --version

Получите ключ Guard

Создайте отдельную конфигурацию Muse

Сохраните пример отдельным файлом ~/.config/opencode-guard-muse/opencode.json (Windows: %USERPROFILE%\.config\opencode-guard-muse\opencode.json). Не заменяйте обычный global config: переменная OPENCODE_CONFIG подключит этот файл только к запуску Muse. Полное имя модели — openai/muse-wonder-1.0.

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/muse-wonder-1.0",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "{env:GUARD_MUSE_BASE_URL}",
        "apiKey": "{env:GUARD_MUSE_API_KEY}"
      },
      "models": {
        "muse-wonder-1.0": { "name": "Muse Wonder 1.0" },
        "muse-spark-1.3": { "name": "Muse Spark 1.3" },
        "muse-spark-1.2": { "name": "Muse Spark 1.2" }
      }
    }
  }
}

Конфигурация содержит только ссылки на переменные. Перед запуском задайте ключ, Base URL и путь OPENCODE_CONFIG.

{
unset GUARD_MUSE_API_KEY
until [ -n "${GUARD_MUSE_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_MUSE_API_KEY || break; printf "\n"; done
export GUARD_MUSE_API_KEY
export GUARD_MUSE_BASE_URL="https://api.guardrelay.ai/v1"
export OPENCODE_CONFIG="$HOME/.config/opencode-guard-muse/opencode.json"
opencode
}

powershell

$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_MUSE_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
$env:GUARD_MUSE_BASE_URL = "https://api.guardrelay.ai/v1"
$env:OPENCODE_CONFIG = "$HOME/.config/opencode-guard-muse/opencode.json"
opencode

Быстрая проверка и продолжение

В интерактивном окне выберите openai/muse-wonder-1.0 через /models. Для короткой команды и последующего продолжения используйте:

bash

opencode run --model openai/muse-wonder-1.0 "Reply with exactly MUSE_OK and remember PINE"
opencode run --continue "What word were you asked to remember?"

Модели и возможности Muse

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 токенов.

Локальные инструменты чтения, правки и shell исполняет сам OpenCode; --continue продолжает тот же сеанс.
Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
Профиль использует OpenAI Responses. Серверный промпт — отдельная настройка семейства Muse: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.

Если подключение не получилось

Признак	Что проверить
`401 invalid_api_key`	Клиент получил полный действующий ключ `gd-…`; переменная задана в том же процессе, где запущен клиент.
`404 model_not_found`	Model ID — точный ID из таблицы выше или короткое имя `muse`; другие написания не поддерживаются.
`404` или неверный путь	Base URL равен `https://api.guardrelay.ai/v1`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие.
`402 insufficient_credit`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
Модель отсутствует в `/models`	Проверьте `OPENCODE_CONFIG`, `provider.openai.models`, полное имя `openai/muse-wonder-1.0` и отсутствие project-level файла, который переопределяет эту модель.

Установите OpenCode

Установите терминальный OpenCode по официальной инструкции. На macOS и Linux выполните первую команду; на Windows при установленном Node.js используйте вторую. После установки проверьте opencode --version.

bash

curl -fsSL https://opencode.ai/install | bash
opencode --version

powershell

npm install -g opencode-ai
opencode --version

Получите ключ Guard

Откройте @guardapi, выберите пакет и сохраните ключ gd-…. Один ключ покрывает все восемь семейств; для профиля Codex нужен отдельный адрес https://api.guardrelay.ai/codex/v1. Подробнее: Ключ и адрес.

Добавьте провайдера и модель

Перед запуском задайте GUARD_API_KEY в окружении и откройте проект командой opencode. Проверенный профиль читает ключ через {env:GUARD_API_KEY} и не требует отдельного /connect.
Откройте глобальный файл ~/.config/opencode/opencode.json или opencode.jsonc (Windows: %USERPROFILE%\.config\opencode\opencode.json). В существующем файле добавьте только guard внутрь объекта providers, сохранив другие поля и провайдеров.
Для нативного Responses укажите package: @opencode/ai/providers/openai/responses и settings.baseURL: https://api.guardrelay.ai/codex/v1. Если в папке проекта есть свой opencode.json(c), проверьте, что он не переопределяет тот же ID.
Сохраните файл. В OpenCode введите /models и выберите guard/gpt-6-astra. Остальные шесть точных ID — в разделе Модели.

jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "model": "guard/gpt-6-astra",
  "providers": {
    "guard": {
      "name": "GUARD API · Codex",
      "env": ["GUARD_API_KEY"],
      "package": "@opencode/ai/providers/openai/responses",
      "settings": {
        "baseURL": "https://api.guardrelay.ai/codex/v1",
        "apiKey": "{env:GUARD_API_KEY}"
      },
      "models": {
        "gpt-6-astra": {"modelID": "gpt-6-astra", "name": "GPT-6 Astra"}
      }
    }
  }
}

В OpenCode V1 limit.context и limit.output задаются вместе. Считайте limit.output клиентским бюджетом: переданный max_output_tokens Guard принимает и сохраняет, но managed Codex не гарантирует жёсткое усечение. Для пользовательского провайдера автоматическое получение полного окна не подтверждено; индикатор клиента не является пределом сервера.

Последний сохранённый нативный каталог Guard объявляет следующие значения максимального окна для настройки клиентского бюджета. Это не проверенный жёсткий предел входа; клиент может сжать историю раньше. В подключении Guard все семь моделей принимают и сохраняют max_output_tokens (Responses), max_completion_tokens (Chat) и max_tokens (Messages) как advisory, без гарантии жёсткого лимита вывода managed Codex; списание идёт по фактическим токенам и денежным правилам ключа.

ID модели	Контекст для настройки клиента
`gpt-6-astra`	`872000`
`gpt-6.1-sol`	`872000`
`gpt-6-sol`	`872000`
`gpt-6-luna`	`872000`
`gpt-5.6-sol`	`872000`
`gpt-5.6-terra`	`872000`
`gpt-5.6-luna`	`872000`

Сделайте первый запрос и продолжите

После выбора модели введите в OpenCode: Ответь ровно OK. Для разового запроса без интерактивного окна выполните команду ниже в папке проекта. Следующий вопрос в том же окне продолжает беседу; после закрытия терминала вернитесь к ней через opencode --continue или opencode run --continue "Продолжи предыдущую задачу".

bash

opencode run --model guard/gpt-6-astra "Ответь ровно OK"

Если подключение не получилось

Признак	Что проверить
Модели нет в `/models`	`providers.guard` существует, `model` равен `guard/gpt-6-astra`, файл лежит в указанной папке, JSON/JSONC не повреждён.
`401` или отказ по ключу	Процесс OpenCode видит `GUARD_API_KEY`, а `settings.apiKey` равен `{env:GUARD_API_KEY}`.
`404` или неверный путь	Base URL оканчивается ровно на `/codex/v1`, без второго `/v1`; выбран точный ID из Моделей.
`402`	Проверьте остаток и лимиты ключа в кабинете.

OpenCode

Claude, Kimi, Composer и Grok

Kimi, Composer и Grok

Kimi в OpenCode

GLM 5.3 в OpenCode

Установите OpenCode

Получите ключ Guard

Создайте отдельную конфигурацию GLM

Быстрая проверка и продолжение

Модели и подтверждённые возможности

Если подключение не получилось

Gemini в OpenCode

Установите OpenCode

Получите ключ Guard

Создайте отдельную конфигурацию Gemini

Быстрая проверка и продолжение

Модели и возможности Gemini

Если подключение не получилось

Muse в OpenCode

Установите OpenCode

Получите ключ Guard

Создайте отдельную конфигурацию Muse

Быстрая проверка и продолжение

Модели и возможности Muse

Если подключение не получилось

Установите OpenCode

Получите ключ Guard

Добавьте провайдера и модель

Сделайте первый запрос и продолжите

Если подключение не получилось

Разделы

На этой странице