# OpenCode

OpenCode принимает любой провайдер, который говорит на OpenAI Chat Completions, поэтому API моделей это одна запись в `opencode.json`. Кроме самого OpenCode ставить ничего не надо. Модель `auto` сама выбирает модель каталога для разговора.

Что нужно: OpenCode (версию показывает `opencode --version`), ключ API моделей и деньги на [балансе организации](https://console.samreshuuu.ru).

## 1. Создайте ключ

В [консоли разработчика](https://console.samreshuuu.ru) откройте «Ключи API», оставьте в поле **Доступ** вариант **Ключ API моделей** и создайте ключ. Секрет показывается один раз. Положите его в профиль оболочки (`~/.zshrc`, `~/.bashrc`), чтобы OpenCode его прочитал:

```bash
export SAMRESHUUU_API_KEY="sk-org-your_api_key"
```

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

Общая настройка OpenCode лежит в `~/.config/opencode/opencode.json`; `opencode.json` в корне проекта действует только на этот проект. Если файла нет, создайте его, или добавьте запись `provider` в тот, что есть.

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "samreshuuu": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Сам Решу",
      "options": {
        "baseURL": "https://api.samreshuuu.ru/v1",
        "apiKey": "{env:SAMRESHUUU_API_KEY}"
      },
      "models": {
        "auto": {
          "name": "auto",
          "variants": {
            "low": {
              "reasoningEffort": "low"
            },
            "medium": {
              "reasoningEffort": "medium"
            },
            "high": {
              "reasoningEffort": "high"
            }
          }
        }
      }
    }
  },
  "model": "samreshuuu/auto"
}
```

| Настройка | Что делает |
| --- | --- |
| `npm` | `@ai-sdk/openai-compatible` заставляет OpenCode звать `POST /v1/chat/completions`. Пакет OpenCode скачивает сам при первом запуске. |
| `options.baseURL` | Адрес API моделей. Оставьте `/v1` в конце. |
| `options.apiKey` | `{env:SAMRESHUUU_API_KEY}` читает ключ из окружения, и в файле его нет. |
| `models` | Модели в выборе OpenCode. `auto` одна из них; другой может быть любой id со страницы [«Модели»](/models). |
| `variants` | Уровни рассуждений, которые OpenCode предлагает для модели; каждый уходит как `reasoning_effort`. |
| `model` | Модель, с которой начинаются новые сессии, в виде `samreshuuu/<id>`. |

OpenCode не знает окна `auto` и рассчитывает сжатие разговора на окно по умолчанию. Если добавляете модель каталога с окном меньше, дайте ей `"limit": {"context": …, "output": …}` из `context_length` и `max_output_tokens` в `GET /v1/models`.

## 3. Запустите OpenCode

Запустите `opencode` и выберите модель через `/models`: модели API моделей называются `samreshuuu/<id>`. Проверить настройку без сессии можно командой `opencode models`: она перечисляет известные OpenCode модели, среди них `samreshuuu/auto`.

Отправьте запрос. Вызов появится в журнале вызовов [консоли](https://console.samreshuuu.ru) с моделью, которую выбрал `auto`, и его стоимостью. Инструменты работают как функции OpenAI: исполняет их OpenCode, вызывает модель.

## Как отменить настройку

Уберите запись `samreshuuu` из `provider` и строку `model`, если она на неё указывает. OpenCode вернётся к другим вашим провайдерам.

## Если что-то не так

| Что видно | Что проверить |
| --- | --- |
| Моделей API моделей нет в `/models` | Файл настроек не является корректным JSON, или `SAMRESHUUU_API_KEY` не задана в оболочке, из которой запущен OpenCode. Выполните `opencode models`. |
| `401` | Ключ неверный или отозван. Проверьте его в «Ключах API» консоли. |
| `404` на каждый запрос | В `baseURL` нет `/v1` в конце. |
| `model_not_found` | id модели в `models` нет в каталоге: возьмите его из `GET /v1/models`. |
| `402` | Баланс не покрывает резерв вызова или исчерпан лимит расхода ключа. |

| HTTP | type | Код | message | Повтор |
| --- | --- | --- | --- | --- |
| 401 | `authentication_error` | `invalid_api_key` | The API key is unknown, disabled, revoked or expired. Switch a disabled key back on in the developer console; create a new one in place of a revoked or expired key. | нет |
| 404 | `not_found_error` | `model_not_found` | The model does not exist. GET /v1/models lists the models this API sells. | нет |
| 400 | `invalid_request_error` | `no_auto_model` | No model meets the request for auto. | нет |
| 402 | `billing_error` | `insufficient_balance` | The organization balance does not cover this request (max_tokens is held in full until the answer is settled). Top up the balance or lower max_tokens. | нет |
| 402 | `billing_error` | `key_limit_exceeded` | This API key has reached its spending limit. Raise the limit or use another key. | нет |

Если ошибка не проходит, напишите в поддержку и приложите `x-request-id` ответа.
