# Интеграция с OpenCode

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (OpenCode v1.18.31, выпуск 2026-09-14 (репозиторий теперь anomalyco/opencode))

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (провайдер anthropic) · GPT ✅ · китайские модели ✅ (openai) · Gemini ✅ (google) |
| Протокол и Base URL | Anthropic: `https://api.qcode.cc/claude/v1` · OpenAI: `https://api.qcode.cc/openai/v1` · Gemini: `https://api.qcode.cc/gemini/v1beta` (`options.baseURL` провайдера) |
| Где настраивается | `~/.config/opencode/opencode.json`; ключи — через `opencode auth login` в `auth.json` |
| Официальная документация | [opencode.ai/docs](https://opencode.ai/docs) |

> ⚠️ **Важное замечание: требуется разрешение на прямой доступ к API**
>
> Для использования OpenCode необходимо разрешение на прямой доступ к API. Поскольку прямые вызовы API не используют механизм сессий Claude Code, расход токенов будет значительно выше, поэтому данное разрешение **отключено по умолчанию**.
>
> Для активации обратитесь в онлайн-поддержку или отправьте письмо на **hi@qcode.cc**, и мы включим это разрешение для вашего приобретённого API-ключа.

[OpenCode](https://github.com/anomalyco/opencode) — это полностью открытый терминальный AI-ассистент для программирования, аналогичный Claude Code, но с большей гибкостью и возможностями настройки. Он поддерживает переключение между моделями, интеграцию с LSP, TUI-интерфейс и не привязан к какому-либо конкретному AI-провайдеру.

## О проекте

### OpenCode

[OpenCode](https://github.com/anomalyco/opencode) — это open-source AI-агент для программирования, разработанный командой SST. Основные характеристики:

- **100% открытый исходный код** — лицензия MIT, полная прозрачность

- **Поддержка нескольких моделей** — одновременное использование Claude, OpenAI, Google Gemini и других

- **Нативная поддержка LSP** — встроенный Language Server Protocol для интеллектуального анализа кода

- **TUI-ориентированный** — спроектирован для пользователей терминала, создан пользователями Neovim

- **Клиент-серверная архитектура** — поддержка удалённого управления: запуск сервера локально и управление с мобильного устройства

- **Два встроенных агента** — `build` (по умолчанию, полные права) и `plan` (только чтение, для анализа и планирования)

**Статистика проекта** (по состоянию на январь 2026 г.):

- GitHub Stars: 208k+ (as of 2026-09)

- Repository: `anomalyco/opencode` (formerly `sst/opencode`; old URL redirects)

- Version: v1.18.31 (released 2026-09-14)

### oh-my-opencode

[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) — это расширенный плагин для OpenCode, предоставляющий профессиональный уровень AI-программирования:

**Ключевые возможности**:

- **Асинхронные субагенты** — параллельная обработка задач, аналогичная Claude Code

- **Готовые конфигурации агентов** — предварительно настроенные профессиональные роли (Oracle, Librarian, Explore и др.)

- **Инструменты LSP/AST** — интеллектуальный рефакторинг, анализ кода, поиск по символам и другие продвинутые функции

- **Слой совместимости с Claude Code** — поддержка hooks, commands, skills из Claude Code

- **Главный агент Sisyphus** — мощный агент-оркестратор на базе Claude Opus 4.8 с поддержкой параллельных фоновых задач

- **Режим ultrawork** — просто добавьте `ultrawork` в промпт, чтобы активировать максимальный параллельный режим

**Встроенные роли агентов**:

| Имя агента | Модель | Назначение |
|------------|--------|------------|
| **Sisyphus** | Claude Opus 4.8 | Главный агент-оркестратор, планирование и делегирование задач |
| **Oracle** | GPT 5.4 | Проектирование архитектуры, ревью кода, стратегический анализ |
| **Librarian** | Claude Sonnet 4.6 | Анализ нескольких репозиториев, изучение документации, примеры реализации |
| **Explore** | Grok Code | Быстрое исследование кодовой базы и поиск паттернов |
| **Frontend UI/UX** | Gemini 2.5 Pro | Фронтенд-разработка, создание красивых UI |

## Установка и настройка

### Шаг 1: Установка OpenCode

OpenCode развивается очень быстро — обращайтесь к актуальной инструкции по установке на официальном сайте:

**Официальная документация по установке**: [https://opencode.ai/docs](https://opencode.ai/docs)

Распространённые способы установки:

```bash
# Установка через curl (рекомендуется)
curl -fsSL https://opencode.ai/install | bash

# Через пакетный менеджер
npm install -g opencode-ai  # или bun/pnpm/yarn

# macOS Homebrew
brew install anomalyco/tap/opencode
```

### Шаг 2: Установка oh-my-opencode (рекомендуется)

oh-my-opencode предоставляет готовую профессиональную конфигурацию — настоятельно рекомендуется:

```bash
bunx oh-my-opencode install
```

**Официальная документация**: [https://github.com/code-yeongyu/oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)

> **Подсказка**: во время установки вас спросят, какие AI-подписки у вас есть (Claude, ChatGPT, Gemini) — выберите в соответствии с вашей ситуацией.

### Шаг 3: Настройка QCode API

Это ключевой шаг! Создайте или отредактируйте файл конфигурации `~/.config/opencode/opencode.json`:

> **О выборе моделей**: ниже — линейка Claude 5 и GPT Codex с QCode. Дневные умолчания `claude-sonnet-5` / `claude-opus-5`; 4.x всё ещё в продаже. QCode **продаёт Gemini** (см. [qcode.cc/models](https://qcode.cc/models)) и **не продаёт grok**. Китайские id: [китайские семейства моделей](/docs/usage/cn-models).

> **О блоке провайдера Google**: блок провайдера `google` в конфигурации используется для подключения к Gemini (например, `gemini-2.5-pro`, `gemini-3.5-flash`). Обратите внимание: тарифы Pro/бесплатный у официального Gemini CLI закончились 2026-06-18 ([объявление Google](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)); преемник — **Google Antigravity CLI**. Корпоративные платные ключи не затронуты. Если вам нужен инструментарий для моделей Google, рекомендуем перейти на Antigravity CLI.

```json
{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.qcode.cc/claude/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.qcode.cc/openai"
      }
    },
    "google": {
      "options": {
        "baseURL": "https://api.qcode.cc/gemini/v1beta"
      }
    }
  },

  "model": "anthropic/claude-opus-5",
  "small_model": "anthropic/claude-haiku-4-5",
  "default_agent": "build",

  "permission": {
    "read": "allow",
    "list": "allow",
    "glob": "allow",
    "grep": "allow",
    "lsp": "allow",

    "edit": "ask",
    "bash": "ask",
    "webfetch": "ask",
    "websearch": "ask",

    "external_directory": "deny",
    "doom_loop": "ask"
  },

  "agent": {
    "plan": {
      "mode": "primary",
      "description": "Планирование/декомпозиция/техническое проектирование (только чтение, без модификации кода)",
      "model": "anthropic/claude-opus-5",
      "temperature": 0.1,
      "prompt": "Ты опытный технический руководитель. Цель: разбить требования на выполнимые шаги (с критериями приёмки/рисками/откатом). По умолчанию только чтение, не изменяй файлы и не запускай команды; если выполнение действительно необходимо, сначала объясни причину и предложи переключиться на build/codex.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "build": {
      "mode": "primary",
      "description": "Основная разработка (end-to-end реализация/отладка/тесты) — Claude Opus 4.8",
      "model": "anthropic/claude-opus-5",
      "temperature": 0.2,
      "prompt": "Ты основной agent по разработке ПО. Приоритеты: минимальные жизнеспособные изменения, читаемость, тестируемость. Перед внесением изменений кратко опиши план; после внесения обязательно укажи: ключевые точки diff, как проверить локально (команды), потенциальные граничные условия.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "allow",
        "bash": "allow",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "ask"
      }
    },

    "codex": {
      "mode": "primary",
      "description": "Рефакторинг/миграция/крупные изменения (Codex) — GPT-5.4",
      "model": "openai/gpt-5.4",
      "temperature": 0.2,
      "prompt": "Ты инженерный agent в стиле Codex, специализирующийся на масштабном рефакторинге, миграциях, ревью кода и работе со сложными цепочками инструментов. В приоритете — сохранять проект работоспособным: коммить поэтапно, каждый шаг должен быть проверяемым; при неопределённости сначала добавляй защиту и тесты.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "allow",
        "bash": "allow",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "ask"
      }
    },

    "review": {
      "mode": "subagent",
      "description": "Ревью кода/второе мнение (только чтение) — GPT-5.3-Codex",
      "model": "openai/gpt-5.6-terra",
      "temperature": 0.1,
      "prompt": "Ты строгий code reviewer. Выдай: 1) ключевые риски (bug/безопасность/конкурентность/границы) 2) рекомендации по поддерживаемости 3) рекомендации по минимальным изменениям (можно псевдо-diff) 4) необходимые точки тестирования. По умолчанию только чтение, не изменяй файлы/не запускай команды.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "explore": {
      "mode": "subagent",
      "description": "Быстрый поиск по коду/локализация файлов/обзор контекста (только чтение) — Claude Haiku 4.5",
      "model": "anthropic/claude-haiku-4-5",
      "temperature": 0.1,
      "prompt": "Ты sub-agent быстрого исследования: за минимальное число шагов находи нужные файлы/функции/цепочки вызовов, давай чёткие пути и краткое резюме. По умолчанию только чтение, не изменяй файлы/не запускай команды.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "general": {
      "mode": "subagent",
      "description": "Общие исследования/документация/сравнение решений (средняя стоимость) — Claude Sonnet 4.6",
      "model": "anthropic/claude-sonnet-5",
      "temperature": 0.2,
      "prompt": "Ты sub-agent общего анализа: акцент на объяснениях, компромиссах, написании документации и сравнении вариантов решений; по умолчанию только чтение, по возможности не изменяй код.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "think": {
      "mode": "subagent",
      "description": "Помощь в размышлениях/анализ граничных условий (только чтение) — GPT-5.4-Mini",
      "model": "openai/gpt-5.6-mini",
      "temperature": 0.2,
      "prompt": "Ты sub-agent рассуждений и анализа граничных условий: давай структурированный анализ и рекомендации по проектированию, аномальным путям, конкурентности/согласованности, узким местам производительности. По умолчанию только чтение.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    }
  }
}
```

#### Выбор API-эндпоинта

В зависимости от вашей сетевой среды можно изменить `baseURL` в разделе `provider`:

| Эндпоинт | Anthropic (Claude) | OpenAI (Codex) | Сценарий использования |
|----------|-------------------|----------------|------------------------|
| **Подключение по домену** (рекомендуется) | `https://api.qcode.cc/claude/v1` | `https://api.qcode.cc/openai` | Глобальные пользователи, автоматический выбор оптимального узла |
| **Прямое подключение через IP Шэньчжэня** | `https://api.qcode.cc/claude/v1` | `https://api.qcode.cc/openai` | Рекомендуется для пользователей из материкового Китая |

> **Для пользователей из материкового Китая**: рекомендуем `asia.qcode.cc` (Гонконг) для лучшей скорости — установите `baseURL` `https://asia.qcode.cc/claude/v1` и `https://asia.qcode.cc/openai`.

#### Доступные модели

QCode в настоящее время поддерживает следующие популярные модели:

**Серия Claude** (путь: `/claude/v1`):

- `claude-opus-5` — текущий флагман (`claude-opus-4-8` всё ещё в продаже)

- `claude-sonnet-5` — дневное умолчание (`claude-sonnet-4-6` всё ещё в продаже)

- `claude-haiku-4-5` — Haiku 4.5, молниеносная скорость отклика

**Серия OpenAI/Codex** (путь: `/openai`):

- `gpt-5.5` — Новейший флагман, максимальные возможности

- `gpt-5.4` — Сложные задачи / общее назначение (рекомендуется)

- `gpt-5.6-mini` — Лёгкие задачи / цена-качество

- `gpt-5.6-terra` — Программирование / Codex CLI (рекомендуется)

#### Описание конфигурации

Приведённая конфигурация содержит полный мультиагентный рабочий процесс:

| Агент | Модель | Режим | Назначение |
|-------|--------|-------|------------|
| **plan** | Claude Opus 5 | primary | Планирование/декомпозиция/техническое проектирование (только чтение) |
| **build** | Claude Opus 5 | primary | Основная разработка, end-to-end реализация |
| **codex** | GPT-5.4 | primary | Рефакторинг/миграция/крупные изменения |
| **review** | GPT-5.3-Codex | subagent | Ревью кода (только чтение) |
| **explore** | Claude Haiku 4.5 | subagent | Быстрый поиск по коду/локализация файлов (только чтение) |
| **general** | Claude Sonnet 5 | subagent | Общие исследования/документация (только чтение) |
| **think** | GPT-5.4-Mini | subagent | Помощь в размышлениях/анализ граничных условий (только чтение) |

Вы можете настроить `model`, `prompt` и `permission` для каждого агента по своему усмотрению.

### Шаг 4: Настройка API-ключа

После запуска OpenCode используйте команду `/connect` для настройки API-ключа:

#### Настройка Anthropic (Claude)

1. В OpenCode введите `/connect`

2. Выберите **Anthropic**

3. Выберите **Manually enter API Key**

4. Введите API-ключ, приобретённый на QCode

5. Нажмите Enter для сохранения

#### Настройка OpenAI (Codex)

1. Введите `/connect`

2. Выберите **OpenAI**

3. Выберите **Manually enter API Key**

4. Введите API-ключ, приобретённый на QCode

5. Нажмите Enter для сохранения

#### Сохранение и перезапуск

После завершения настройки:

1. Введите `/exit` для выхода из OpenCode

2. Запустите OpenCode заново

Ваш API-ключ сохраняется в файле `~/.local/share/opencode/auth.json`, который можно редактировать напрямую для дальнейшей настройки.

## Проверка конфигурации

После перезапуска OpenCode проверьте конфигурацию следующим образом:

```bash
# Запустите OpenCode
opencode

# Тестовое сообщение в OpenCode
> Привет, расскажи о себе
```

Если диалог работает нормально — настройка прошла успешно!

## Советы по использованию

### Режим ultrawork

Если установлен oh-my-opencode, просто добавьте `ultrawork` или `ulw` в промпт, чтобы активировать максимальный режим параллельной мультимодельной оркестрации:

```text
ultrawork помоги мне рефакторить модуль аутентификации этого проекта
```

### Фоновые задачи

Используйте синтаксис `@` для вызова специализированных агентов:

```text
@oracle проведи ревью архитектуры этого кода
@librarian найди похожие open-source реализации
@explore найди все API-эндпоинты в проекте
```

### Переключение агентов через Tab

Нажмите `Tab` для переключения между агентами `build` и `plan`:

- **build** — полные права, для разработки

- **plan** — режим только для чтения, для анализа и планирования

## Часто задаваемые вопросы

### Не удаётся подключиться к API

1. Проверьте правильность настройки API-эндпоинта

2. Убедитесь, что API-ключ сохранён корректно

3. Попробуйте переключиться на другой API-эндпоинт (например, `asia.qcode.cc` / `us` / `eu`)

4. Проверьте, не требуется ли прокси для сети

### Модель недоступна

Убедитесь, что модели в `opencode.json` настроены правильно и их ID совпадают с поддерживаемыми QCode.

### Проблемы с конфигурацией oh-my-opencode

См. официальную документацию: [https://github.com/code-yeongyu/oh-my-opencode#configuration](https://github.com/code-yeongyu/oh-my-opencode#configuration)

## Полезные ссылки

- [Официальный сайт OpenCode](https://opencode.ai)

- [OpenCode на GitHub](https://github.com/anomalyco/opencode)

- [oh-my-opencode на GitHub](https://github.com/code-yeongyu/oh-my-opencode)

- [Официальная документация OpenCode](https://opencode.ai/docs)

## Следующие шаги

- Ознакомьтесь с [интеграцией с VS Code](/docs/ide/vscode) для работы в IDE

- Изучите [интеграцию с Codex](/docs/ide/codex) для использования моделей OpenAI Codex

- Узнайте [советы по CLI](/docs/usage/cli-tips) для повышения эффективности в терминале