Интеграция с OpenCode
Использование open-source терминального AI-ассистента OpenCode с QCode API
Интеграция с OpenCode¶
⚠️ Важное замечание: требуется разрешение на прямой доступ к API
Для использования OpenCode необходимо разрешение на прямой доступ к API. Поскольку прямые вызовы API не используют механизм сессий Claude Code, расход токенов будет значительно выше, поэтому данное разрешение отключено по умолчанию.
Для активации обратитесь в онлайн-поддержку или отправьте письмо на hi@qcode.cc, и мы включим это разрешение для вашего приобретённого API-ключа.
OpenCode — это полностью открытый терминальный AI-ассистент для программирования, аналогичный Claude Code, но с большей гибкостью и возможностями настройки. Он поддерживает переключение между моделями, интеграцию с LSP, TUI-интерфейс и не привязан к какому-либо конкретному AI-провайдеру.

О проекте¶
OpenCode¶
OpenCode — это open-source AI-агент для программирования, разработанный командой SST. Основные характеристики:
-
100% открытый исходный код — лицензия MIT, полная прозрачность
-
Поддержка нескольких моделей — одновременное использование Claude, OpenAI, Google Gemini и других
-
Нативная поддержка LSP — встроенный Language Server Protocol для интеллектуального анализа кода
-
TUI-ориентированный — спроектирован для пользователей терминала, создан пользователями Neovim
-
Клиент-серверная архитектура — поддержка удалённого управления: запуск сервера локально и управление с мобильного устройства
-
Два встроенных агента —
build(по умолчанию, полные права) иplan(только чтение, для анализа и планирования)
Статистика проекта (по состоянию на январь 2026 г.):
-
GitHub Stars: 46.1k+
-
Участников: 490+
-
Версия: v1.0.223+
oh-my-opencode¶
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
Распространённые способы установки:
# Установка через curl (рекомендуется)
curl -fsSL https://opencode.ai/install | bash
# Через пакетный менеджер
npm install -g opencode # или bun/pnpm/yarn
# macOS Homebrew
brew install opencode
Шаг 2: Установка oh-my-opencode (рекомендуется)¶
oh-my-opencode предоставляет готовую профессиональную конфигурацию — настоятельно рекомендуется:
bunx oh-my-opencode install
Официальная документация: https://github.com/code-yeongyu/oh-my-opencode
Подсказка: во время установки вас спросят, какие AI-подписки у вас есть (Claude, ChatGPT, Gemini) — выберите в соответствии с вашей ситуацией.
Шаг 3: Настройка QCode API¶
Это ключевой шаг! Создайте или отредактируйте файл конфигурации ~/.config/opencode/opencode.json:
О выборе моделей: в конфигурации ниже используются модели серий Claude и GPT Codex, предоставляемые QCode. Мы рекомендуем использовать комбинацию этих двух серий для разработки — они показывают отличные результаты в различных тестах по программированию. На нашем сервисе не продаются модели Gemini, Grok и т.д.; если они вам действительно нужны, вы можете настроить других провайдеров по аналогии с приведённым форматом (но мы не рекомендуем это, так как Gemini и Grok уступают сериям Claude и Codex в тестах по программированию).
О блоке провайдера Google: блок провайдера
gemini-2.5-pro,gemini-3.5-flash). Обратите внимание: официальный Gemini CLI заменяется на Google Antigravity CLI (тарифы Pro/бесплатный Gemini CLI прекращают поддержку 2026-06-18; корпоративные платные ключи не затронуты). Если вам нужен инструментарий для моделей Google, рекомендуем перейти на Antigravity CLI.
{
"$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-4-8",
"small_model": "anthropic/claude-haiku-4-5",
"default_agent": "build",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "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-4-8",
"temperature": 0.1,
"prompt": "Ты опытный технический руководитель. Цель: разбить требования на выполнимые шаги (с критериями приёмки/рисками/откатом). По умолчанию только чтение, не изменяй файлы и не запускай команды; если выполнение действительно необходимо, сначала объясни причину и предложи переключиться на build/codex.",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "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-4-8",
"temperature": 0.2,
"prompt": "Ты основной agent по разработке ПО. Приоритеты: минимальные жизнеспособные изменения, читаемость, тестируемость. Перед внесением изменений кратко опиши план; после внесения обязательно укажи: ключевые точки diff, как проверить локально (команды), потенциальные граничные условия.",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "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",
"codesearch": "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",
"codesearch": "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",
"codesearch": "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-4-6",
"temperature": 0.2,
"prompt": "Ты sub-agent общего анализа: акцент на объяснениях, компромиссах, написании документации и сравнении вариантов решений; по умолчанию только чтение, по возможности не изменяй код.",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "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",
"codesearch": "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(Гонконг) для лучшей скорости — установитеbaseURLhttps://asia.qcode.cc/claude/v1иhttps://asia.qcode.cc/openai.
Доступные модели¶
QCode в настоящее время поддерживает следующие популярные модели:
Серия Claude (путь: /claude/v1):
-
claude-opus-4-8— Opus 4.8, максимальные флагманские возможности рассуждения -
claude-sonnet-4-6— 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 4.8 | primary | Планирование/декомпозиция/техническое проектирование (только чтение) |
| build | Claude Opus 4.8 | primary | Основная разработка, end-to-end реализация |
| codex | GPT-5.4 | primary | Рефакторинг/миграция/крупные изменения |
| review | GPT-5.3-Codex | subagent | Ревью кода (только чтение) |
| explore | Claude Haiku 4.5 | subagent | Быстрый поиск по коду/локализация файлов (только чтение) |
| general | Claude Sonnet 4.6 | subagent | Общие исследования/документация (только чтение) |
| think | GPT-5.4-Mini | subagent | Помощь в размышлениях/анализ граничных условий (только чтение) |
Вы можете настроить model, prompt и permission для каждого агента по своему усмотрению.
Шаг 4: Настройка API-ключа¶
После запуска OpenCode используйте команду /connect для настройки API-ключа:
Настройка Anthropic (Claude)¶
-
В OpenCode введите
/connect -
Выберите Anthropic
-
Выберите Manually enter API Key
-
Введите API-ключ, приобретённый на QCode
-
Нажмите Enter для сохранения
Настройка OpenAI (Codex)¶
-
Введите
/connect -
Выберите OpenAI
-
Выберите Manually enter API Key
-
Введите API-ключ, приобретённый на QCode
-
Нажмите Enter для сохранения
Сохранение и перезапуск¶
После завершения настройки:
-
Введите
/exitдля выхода из OpenCode -
Запустите OpenCode заново
Ваш API-ключ сохраняется в файле ~/.local/share/opencode/auth.json, который можно редактировать напрямую для дальнейшей настройки.
Проверка конфигурации¶
После перезапуска OpenCode проверьте конфигурацию следующим образом:
# Запустите OpenCode
opencode
# Тестовое сообщение в OpenCode
> Привет, расскажи о себе
Если диалог работает нормально — настройка прошла успешно!
Советы по использованию¶
Режим ultrawork¶
Если установлен oh-my-opencode, просто добавьте ultrawork или ulw в промпт, чтобы активировать максимальный режим параллельной мультимодельной оркестрации:
ultrawork помоги мне рефакторить модуль аутентификации этого проекта
Фоновые задачи¶
Используйте синтаксис @ для вызова специализированных агентов:
@oracle проведи ревью архитектуры этого кода
@librarian найди похожие open-source реализации
@explore найди все API-эндпоинты в проекте
Переключение агентов через Tab¶
Нажмите Tab для переключения между агентами build и plan:
-
build — полные права, для разработки
-
plan — режим только для чтения, для анализа и планирования
Часто задаваемые вопросы¶
Не удаётся подключиться к API¶
-
Проверьте правильность настройки API-эндпоинта
-
Убедитесь, что API-ключ сохранён корректно
-
Попробуйте переключиться на другой API-эндпоинт (например,
asia.qcode.cc/us/eu) -
Проверьте, не требуется ли прокси для сети
Модель недоступна¶
Убедитесь, что модели в opencode.json настроены правильно и их ID совпадают с поддерживаемыми QCode.
Проблемы с конфигурацией oh-my-opencode¶
См. официальную документацию: https://github.com/code-yeongyu/oh-my-opencode#configuration
Полезные ссылки¶
Следующие шаги¶
-
Ознакомьтесь с интеграцией с VS Code для работы в IDE
-
Изучите интеграцию с Codex для использования моделей OpenAI Codex
-
Узнайте советы по CLI для повышения эффективности в терминале