Быстрая установка и настройка: настройка Provider и проверка

Что вы узнаете

✅ Используйте рекомендуемый метод установки AI-агента для автоматической установки и настройки
✅ Выполните настройку вручную с помощью интерактивного установщика CLI
✅ Настройте несколько AI Providerов, включая Claude, OpenAI, Gemini и GitHub Copilot
✅ Проверьте успешную установку и диагностируйте проблемы с настройкой
✅ Поймите приоритет Provider и механизм отката
✅ Поймите структуру файла настройки

Ваши текущие проблемы

Вы только установили OpenCode, но видите пустой интерфейс настройки и не знаете, с чего начать
У вас есть несколько подписок на AI сервисы (Claude, ChatGPT, Gemini) и вы не знаете, как их настроить единообразно
Вы хотите, чтобы AI помогло вам установить, но не знаете, как предоставить точные инструкции по установке
Вы боитесь, что ошибки в настройке приведут к тому, что плагин не будет работать правильно

Когда использовать это руководство

Первая установка oh-my-opencode: Это первый шаг и должен быть выполнен
После добавления новой подписки: Например, когда вы только что купили Claude Max или ChatGPT Plus
При смене среды разработки: Настройка среды разработки на новой машине
При проблемах с подключением Provider: Устрановляйте проблемы с настройкой через диагностические команды

🎒 Предварки

Предварки

Это руководство предполагает, что вы уже:

Установлен OpenCode >= 1.0.150
Имеете хотя бы одну подписку на AI Provider (Claude, OpenAI, Gemini, GitHub Copilot и т.д.)

Если OpenCode не установлен, обратитесь к официальной документации OpenCode для завершения установки сначала.

Проверьте версию OpenCode

bash

opencode --version
# Должен отображать 1.0.150 или выше

Основные концепции

Проект установки oh-my-opencode основан на двух основных принципах:

1. AI-агент в первую очередь (рекомендуется)

Позвольте AI-агентам помочь вам установить и настроить вместо ручных операций. Почему?

AI не пропустит шаги (у него есть полное руководство по установке)
AI автоматически выберет лучшую настройку на основе вашей подписки
AI может автоматически диагностировать и исправлять ошибки при их возникновении

2. Интерактивный против неинтерактивный

Интерактивная установка: Выполните bunx oh-my-opencode install, настройте через вопросы и ответы
Неинтерактивная установка: Используйте параметры командной строки (подходит для автоматизации или AI-агентов)

3. Приоритет Provider

oh-my-opencode использует трехэтапный механизм разрешения моделей:

Переопределение пользователя: Если модель явно указана в файле настройки, используйте эту модель
Откат Provider: Попробуйте по цепочке приоритетов: Native (anthropic/openai/google) > GitHub Copilot > OpenCode Zen > Z.ai Coding Plan
Системное значение по умолчанию: Если все Providerы недоступны, используйте модель по умолчанию OpenCode

Что такое Provider?

Provider — это поставщик моделей AI, например:

Anthropic: Предоставляет модели Claude (Opus, Sonnet, Haiku)
OpenAI: Предоставляет модели GPT (GPT-5.2, GPT-5-nano)
Google: Предоставляет модели Gemini (Gemini 3 Pro, Flash)
GitHub Copilot: Предоставляет различные модели, размещенные на GitHub, в качестве отката

oh-my-opencode может настроить несколько Providerов одновременно, автоматически выбирая оптимальную модель на основе типа задачи и приоритета.

Следуйте за инструкциями

Шаг 1: Рекомендуемый метод — позвольте AI-агенту установить (человеческий)

Почему Это официально рекомендуемый метод установки, позволяющий AI-агентам автоматически завершить настройку во избежание человеческих ошибок при пропущенных шагах.

Как сделать

Откройте интерфейс AI-чата (Claude Code, AmpCode, Cursor и т.д.) и введите следующее приглашение:

bash

Please install and configure oh-my-opencode following this guide:
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md

Что вы должны увидеть AI-агент сделает следующее:

Спросит о ваших подписках (Claude, OpenAI, Gemini, GitHub Copilot и т.д.)
Автоматически выполнит команды установки
Настроит аутентификацию Provider
Проверит результаты установки
Сообщит вам, что установка завершена

Тестовая фраза AI-агента

После завершения установки AI-агент будет использовать "oMoMoMoMo..." как тестовую фразу, чтобы подтвердить с вами.

Шаг 2: Ручная установка — использование интерактивного установщика CLI

Почему Используйте это, если вы хотите полностью контролировать процесс установки или если установка AI-агента не удалась.

Использование Bun (рекомендуется)Использование npm

bash

bunx oh-my-opencode install

bash

npx oh-my-opencode install

Примечание: CLI автоматически загружает автономный бинарный файл, подходящий для вашей платформы. После установки не требуется среда выполнения Bun/Node.js.
Поддерживаемые платформы: macOS (ARM64, x64), Linux (x64, ARM64, Alpine/musl), Windows (x64)

Что вы должны увидеть Установщик задаст следующие вопросы:

oMoMoMoMo... Установка

[?] Есть ли у вас подписка Claude Pro/Max? (Y/n)
[?] Вы на max20 (20x режим)? (Y/n)
[?] Есть ли у вас подписка OpenAI/ChatGPT Plus? (Y/n)
[?] Будете ли вы интегрировать модели Gemini? (Y/n)
[?] Есть ли у вас подписка GitHub Copilot? (Y/n)
[?] Есть ли у вас доступ к OpenCode Zen (opencode/ модели)? (Y/n)
[?] Есть ли у вас подписка Z.ai Coding Plan? (Y/n)

Сводка настроений
──────────────────────────────────────────────

  [OK] Claude (max20)
  [OK] OpenAI/ChatGPT (GPT-5.2 для Oracle)
  [OK] Gemini
  [OK] GitHub Copilot (fallback)
  ○ OpenCode Zen (opencode/ модели)
  ○ Z.ai Coding Plan (Librarian/Multimodal)

──────────────────────────────────────────────

Назначение моделей

  [i] Модели автоматически настроены на основе приоритета provider
  * Priority: Native > Copilot > OpenCode Zen > Z.ai

✓ Плагин зарегистрирован в opencode.json
✓ Настройка записана в ~/.config/opencode/oh-my-opencode.json
✓ Подсказки по настройке аутентификации отображены

[!] Пожалуйста, настройте аутентификацию для ваших providerов:

1. Anthropic (Claude): Выполните 'opencode auth login' → Выберите Anthropic
2. Google (Gemini): Выполните 'opencode auth login' → Выберите Google → Выберите OAuth с Google (Antigravity)
3. GitHub (Copilot): Выполните 'opencode auth login' → Выберите GitHub

Готово! 🎉

Шаг 3: Настройка аутентификации Provider

3.1 Аутентификация Claude (Anthropic)

Почему Главный оркестратор Сизифус настоятельно рекомендует использовать модель Opus 4.5, поэтому вы должны сначала аутентифицироваться.

Как сделать

bash

opencode auth login

Затем следуйте подсказкам:

Выберите Provider: Выберите Anthropic
Выберите метод входа: Выберите Claude Pro/Max
Завершите поток OAuth: Войдите в браузер и авторизуйтесь
Дождитесь завершения: Терминал отобразит успешную аутентификацию

Что вы должны увидеть

✓ Аутентификация успешна
✓ Provider Anthropic настроен

Ограничение доступа к Claude OAuth

С января 2026 года Anthropic ограничил сторонний доступ OAuth, ссылаясь на нарушения ToS.
Anthropic указал этот проект oh-my-opencode как причину блокировки OpenCode
Действительно в сообществе существуют плагины, которые подделывают запросы OAuth Claude Code. Эти инструменты могут быть технически выполнимыми, но пользователи должны быть осведомы о последствиях ToS. Я лично не рекомендую использовать их.
Этот проект не несет ответственности за любые проблемы, вызванные использованием неофициальных инструментов, и у нас нет собственной реализации системы OAuth.

3.2 Google Gemini (Antigravity OAuth) Аутентификация

Почему Модели Gemini используются для Multimodal Looker (анализ медиа) и некоторых специализированных задач.

Как сделать

Шаг 1: Добавьте плагин Antigravity Auth

Отредактируйте ~/.config/opencode/opencode.json, добавьте opencode-antigravity-auth@latest в массив plugin:

json

{
  "plugin": [
    "oh-my-opencode",
    "opencode-antigravity-auth@latest"
  ]
}

Шаг 2: Настройте модели Gemini (важно!)

Скопируйте полную конфигурацию модели из документации opencode-antigravity-auth, аккуратно объедините ее в ~/.config/opencode/oh-my-opencode.json, чтобы не сломать существующую настройку.

Плагин использует систему вариантов — модели такие как antigravity-gemini-3-pro поддерживают варианты low/high, а не отдельные записи -low/-high.

Доступные модели (квота Antigravity):

google/antigravity-gemini-3-pro — варианты: low, high
google/antigravity-gemini-3-flash — варианты: minimal, low, medium, high
google/antigravity-claude-sonnet-4-5 — варианты: low, max
google/antigravity-claude-sonnet-4-5-thinking — варианты: low, max

Доступные модели (квота Gemini CLI):

google/gemini-2.5-flash, google/gemini-2.5-pro, google/gemini-3-flash-preview, google/gemini-3-pro-preview

Примечание: Традиционные имена с суффиксами типа google/antigravity-gemini-3-pro-high все еще доступны, но варианты рекомендуются. :::

Шаг 3: Переопределите модели агентов oh-my-opencode

Переопределите агента модели в oh-my-opencode.json (или .opencode/oh-my-opencode.json):

jsonc

{
  "agents": {
    "multimodal-looker": { "model": "google/antigravity-gemini-3-flash" }
  }
}

Шаг 4: Выполните аутентификацию

bash

opencode auth login

Затем следуйте подсказкам:

Выберите Provider: Выберите Google
Выберите метод входа: Выберите OAuth with Google (Antigravity)
Завершите поток OAuth: (автообнаружено) Завершите вход в браузер
Опционально: Добавьте больше аккаунтов Google для балансировки нагрузки

Что вы должны увидеть

✓ Аутентификация успешна
✓ Provider Google настроен (Antigravity)
✓ Доступно несколько аккаунтов для балансировки нагрузки

Балансировка нагрузки по нескольким аккаунтам

Плагин поддерживает до 10 аккаунтов Google. Когда один аккаунт достигает пределов скорости, он автоматически переключается на следующий доступный аккаунт.

3.3 GitHub Copilot (Provider отката)

Почему GitHub Copilot служит в качестве Provider отката, используемый, когда нативные Providerы недоступны.

Приоритет: Native (anthropic/, openai/, google/) > GitHub Copilot > OpenCode Zen > Z.ai Coding Plan

Как сделать

bash

opencode auth login

Затем следуйте подсказкам:

Выберите Provider: Выберите GitHub
Выберите метод входа: Выберите Authenticate via OAuth
Завершите поток OAuth: Поток OAuth GitHub

Что вы должны увидеть

✓ Аутентификация успешна
✓ GitHub Copilot настроен как отката

Сопоставление моделей GitHub Copilot

Когда GitHub Copilot является лучшим доступным Providerом, oh-my-opencode использует следующее сопоставление моделей:

Агент	Модель	Назначение
Сизифус	`github-copilot/claude-opus-4.5`	Главный оркестратор
Oracle	`github-copilot/gpt-5.2`	Обзор архитектуры
Explore	`opencode/gpt-5-nano`	Быстрый поиск
Librarian	`zai-coding-plan/glm-4.7` (если Z.ai доступен) или отката	Поиск документации

GitHub Copilot действует как Provider-прокси, направляя запросы базовой модели на соответствующие модели.

Шаг 4: Неинтерактивная установка (подходит для AI-агентов)

Почему AI-агентам нужно использовать неинтерактивный режим, завершая все настройки сразу через параметры командной строки.

Как сделать

bash

bunx oh-my-opencode install --no-tui \
  --claude=<yes|no|max20> \
  --openai=<yes|no> \
  --gemini=<yes|no> \
  --copilot=<yes|no> \
  [--opencode-zen=<yes|no>] \
  [--zai-coding-plan=<yes|no>]

Описание параметров

Параметр	Значение	Описание
`--no-tui`	-	Отключить интерактивный интерфейс (обязательно указать другие параметры)
`--claude`	`yes/no/max20`	Статус подписки Claude
`--openai`	`yes/no`	Подписка OpenAI/ChatGPT Plus (GPT-5.2 для Oracle)
`--gemini`	`yes/no`	Интеграция моделей Gemini
`--copilot`	`yes/no`	Подписка GitHub Copilot
`--opencode-zen`	`yes/no`	Доступ к OpenCode Zen (opencode/ модели)
`--zai-coding-plan`	`yes/no`	Подписка Z.ai Coding Plan

Примеры

bash

# У вас есть все нативные подписки
bunx oh-my-opencode install --no-tui \
  --claude=max20 \
  --openai=yes \
  --gemini=yes \
  --copilot=no

# У вас только Claude
bunx oh-my-opencode install --no-tui \
  --claude=yes \
  --openai=no \
  --gemini=no \
  --copilot=no

# У вас только GitHub Copilot
bunx oh-my-opencode install --no-tui \
  --claude=no \
  --openai=no \
  --gemini=no \
  --copilot=yes

# У вас нет подписок
bunx oh-my-opencode install --no-tui \
  --claude=no \
  --openai=no \
  --gemini=no \
  --copilot=no

Что вы должны увидеть Тот же вывод, что и при интерактивной установке, но без ответов на вопросы.

Контрольная точка ✅

Проверьте успешную установку

Проверка 1: Подтвердите версию OpenCode

bash

opencode --version

Ожидаемый результат: Отображает 1.0.150 или выше версию.

Требование к версии OpenCode

Если вы используете версию 1.0.132 или ранее, ошибки OpenCode могут повредить вашу настройку.

Это исправление было объединено после 1.0.132—используйте более новую версию. Интересный факт: Это PR был обнаружен и исправлен благодаря OhMyOpenCode's Librarian, Explore и Oracle настройкам.

Проверка 2: Подтвердите регистрацию плагина

bash

cat ~/.config/opencode/opencode.json

Ожидаемый результат: Смейте "oh-my-opencode" в массиве plugin.

json

{
  "plugin": [
    "oh-my-opencode",
    "opencode-antigravity-auth@latest"
  ]
}

Проверка 3: Подтвердите создание файла настройки

bash

cat ~/.config/opencode/oh-my-opencode.json

Ожидаемый результат: Отобразите полную структуру настройки, включая поля agents, categories, disabled_agents и другие.

json

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  // Включите автозаполнение

  "agents": {
    "sisyphus": {
      "model": "anthropic/claude-opus-4-5"
    },
    "oracle": {
      "model": "openai/gpt-5.2"
    },
    ...
  },
  "categories": {
    "quick": {
      "model": "anthropic/claude-haiku-4-5",
      "temperature": 0.1
    },
    ...
  },
  "disabled_agents": [],
  "disabled_skills": [],
  "disabled_hooks": [],
  "disabled_mcps": []
}

Запустите диагностическую команду

bash

oh-my-opencode doctor --verbose

Что вы должны увидеть:

Проверка разрешения моделей
Проверка конфигурации агентов
Проверка состояния подключения MCP серверов
Подтверждение аутентификации

bash

✅ Версия OpenCode: 1.0.150 (требуется: >=1.0.150)
✅ Плагин зарегистрирован: oh-my-opencode
✅ Файл настройки найден: ~/.config/opencode/oh-my-opencode.json
✅ Anthropic provider: аутентифицирован
✅ OpenAI provider: аутентифицирован
✅ Google provider: аутентифицирован (Antigravity)
✅ GitHub Copilot: аутентифицирован (откат)
✅ MCP серверы: 3 подключены (websearch, context7, grep_app)
✅ Агенты: 10 включены
✅ Хуки: 32 включены
✓ Все модели разрешены успешно

Если диагностика не удалась

Если диагностика показывает какие-либо ошибки, устраните их в первую очередь:

Сбой аутентификации Provider: Повторно запустите opencode auth login
Ошибка в файле настройки: Проверьте oh-my-opencode.json синтакс (JSONC поддерживает комментарии и конечные запятые)
Несовместимость версий: Обновите OpenCode до последней версии
Плагин не зарегистрирован: Повторно запустите bunx oh-my-opencode install


## Частые ошибки

### ❌ Ошибка 1: Забыли настроить аутентификацию Provider

**Проблема**: Модели не работают после прямой установки.

**Причина**: Плагин установлен, но Provider не был аутентифицирован через OpenCode.

**Решение**:
```bash
opencode auth login
# Выберите соответствующий Provider и завершите аутентификацию

❌ Ошибка 2: Версия OpenCode слишком старая

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

Причина: Версия OpenCode 1.0.132 или ранее имеет ошибку, которая повреждает настройку.

Решение:

bash

# Обновите OpenCode
npm install -g @opencode/cli@latest

# Или используйте менеджер пакетов (Bun, Homebrew и т.д.)
bun install -g opencode@latest

❌ Ошибка 3: Неверные параметры CLI

Проблема: Ошибка в параметрах при запуске неинтерактивной установки.

Причина: --claude — обязательный параметр и должен быть указан как yes, no или max20.

Решение:

bash

# ❌ Неверно: отсутствует --claude
bunx oh-my-opencode install --no-tui --gemini=yes

# ✅ Правильно: укажите все обязательные параметры
bunx oh-my-opencode install --no-tui --claude=yes --gemini=yes

❌ Ошибка 4: Исчерпан квоты Antigravity

Проблема: Модели Gemini внезапно перестали работать.

Причина: Квота Antigravity ограничена, и одна учетная запись может достичь пределов скорости.

Решение: Добавьте несколько аккаунтов Google для балансировки нагрузки

bash

opencode auth login
# Выберите Google
# Добавьте больше аккаунтов для балансировки нагрузки

❌ Ошибка 5: Неверное расположение файла настройки

Проблема: Изменения не вступают в силу.

Причина: Изменили не тот файл настройки (проектная настройка vs пользовательская настройка).

Решение: Подтвердите расположение файла настройки

Тип настройки	Путь к файлу	Приоритет
Пользовательская настройка	`~/.config/opencode/oh-my-opencode.json`	Высокий
Проектная настройка	`.opencode/oh-my-opencode.json`	Низкий

Правила слияния настроек

Если существуют и пользовательская и проектная настройки, пользовательская настройка переопределяет проектную настройку.

Резюме

Рекомендуется использовать AI-агента для установки: Позвольте AI автоматически завершить настройку во избежание человеческих ошибок
CLI поддерживает интерактивный и неинтерактивный режимы: Интерактивный подходит для людей, неинтерактивный для AI
Provider приоритет: Native > Copilot > OpenCode Zen > Z.ai
Аутентификация обязательна: После установки вы должны настроить Provider аутентификацию для использования
Диагностические команды важны: oh-my-opencode doctor --verbose может быстро устрановлять проблемы
Поддерживается JSONC формат: Файлы настроек поддерживают комментарии и конечные запятые

Запомните:

Пользовательская настройка (~/.config/opencode/oh-my-opencode.json) имеет приоритет над проектной настройкой (.opencode/oh-my-opencode.json)
Используйте JSONC для повышения читаемости настроек
Запустите oh-my-opencode doctor --verbose для проверки состояния системы

Предпросмотр следующего урока

В следующем уроке мы узнаем Познакомьтесь с Сизифусом: главный оркестратор.
Вы узнаете:
Основные функции и философия дизайна агента Сизифус
Как использовать Сизифус для планирования и делегирования задач
Как параллельные фоновые задачи работают
Принцип механизма принудительного завершения TODO

5 минут для начала

Подключение ваших учётных записей ИИ

Работа как команда

Что делать при возникновении проблем

Справочник и миграция

Журнал изменений

Быстрая установка и настройка: настройка Provider и проверка

Что вы узнаете

Ваши текущие проблемы

Когда использовать это руководство

🎒 Предварки

Основные концепции

Следуйте за инструкциями

Шаг 1: Рекомендуемый метод — позвольте AI-агенту установить (человеческий)

Шаг 2: Ручная установка — использование интерактивного установщика CLI

Шаг 3: Настройка аутентификации Provider

3.1 Аутентификация Claude (Anthropic)

3.2 Google Gemini (Antigravity OAuth) Аутентификация

3.3 GitHub Copilot (Provider отката)

Шаг 4: Неинтерактивная установка (подходит для AI-агентов)

Контрольная точка ✅

Проверьте успешную установку

Запустите диагностическую команду

❌ Ошибка 2: Версия OpenCode слишком старая

❌ Ошибка 3: Неверные параметры CLI

❌ Ошибка 4: Исчерпан квоты Antigravity

❌ Ошибка 5: Неверное расположение файла настройки

Резюме

Предпросмотр следующего урока

Быстрая установка и настройка: настройка Provider и проверка ​

Что вы узнаете ​

Ваши текущие проблемы ​

Когда использовать это руководство ​

🎒 Предварки ​

Основные концепции ​

Следуйте за инструкциями ​

Шаг 1: Рекомендуемый метод — позвольте AI-агенту установить (человеческий) ​

Шаг 2: Ручная установка — использование интерактивного установщика CLI ​

Шаг 3: Настройка аутентификации Provider ​

3.1 Аутентификация Claude (Anthropic) ​

3.2 Google Gemini (Antigravity OAuth) Аутентификация ​

3.3 GitHub Copilot (Provider отката) ​

Шаг 4: Неинтерактивная установка (подходит для AI-агентов) ​

Контрольная точка ✅ ​

Проверьте успешную установку ​

Запустите диагностическую команду ​

❌ Ошибка 2: Версия OpenCode слишком старая ​

❌ Ошибка 3: Неверные параметры CLI ​

❌ Ошибка 4: Исчерпан квоты Antigravity ​

❌ Ошибка 5: Неверное расположение файла настройки ​

Резюме ​

Предпросмотр следующего урока ​

Быстрая установка и настройка: настройка Provider и проверка

Что вы узнаете

Ваши текущие проблемы

Когда использовать это руководство

🎒 Предварки

Основные концепции

Следуйте за инструкциями

Шаг 1: Рекомендуемый метод — позвольте AI-агенту установить (человеческий)

Шаг 2: Ручная установка — использование интерактивного установщика CLI

Шаг 3: Настройка аутентификации Provider

3.1 Аутентификация Claude (Anthropic)

3.2 Google Gemini (Antigravity OAuth) Аутентификация

3.3 GitHub Copilot (Provider отката)

Шаг 4: Неинтерактивная установка (подходит для AI-агентов)

Контрольная точка ✅

Проверьте успешную установку

Запустите диагностическую команду

❌ Ошибка 2: Версия OpenCode слишком старая

❌ Ошибка 3: Неверные параметры CLI

❌ Ошибка 4: Исчерпан квоты Antigravity

❌ Ошибка 5: Неверное расположение файла настройки

Резюме

Предпросмотр следующего урока