Интеграция с 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.6 с поддержкой параллельных фоновых задач

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

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

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

Шаг 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 в тестах по программированию).

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

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://asia.qcode.cc/claude/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://asia.qcode.cc/openai"
      }
    }
  },

  "model": "anthropic/claude-opus-4-5-20251101",
  "small_model": "anthropic/claude-haiku-4-5-20251001",
  "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-5-20251101",
      "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.6",
      "model": "anthropic/claude-opus-4-5-20251101",
      "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.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "你是 Codex 风格的工程 agent，擅长大规模重构、迁移、代码审阅与复杂工具链协作。优先保持工程可运行：分步提交、每步可验证；遇到不确定先加防护与测试。",
      "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.1-Codex-Max",
      "model": "openai/gpt-5.1-codex-max",
      "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-20251001",
      "temperature": 0.1,
      "prompt": "你是快速探索子 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-5-20250929",
      "temperature": 0.2,
      "prompt": "你是通用分析子 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.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "你是推理与边界条件推演子 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:

Для пользователей из материкового Китая: используйте прямое подключение через Шэньчжэнь для лучшей скорости — измените baseURL на http://103.236.53.153/claude/v1 и http://103.236.53.153/openai.

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

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

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

• claude-sonnet-4-5-20250929 — Sonnet 4.6, оптимальный выбор по соотношению цена/качество

• claude-opus-4-5-20251101 — Opus 4.6, максимальные возможности рассуждения

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

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

• gpt-5.2-2025-12-11 — GPT 5.2, последняя версия (рекомендуется)

• gpt-5.1-codex-max — Codex Max, специализированная для программирования

• gpt-5.1-codex — Codex, стандартная версия

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

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

Вы можете настроить 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 проверьте конфигурацию следующим образом:

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

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

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

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

Режим ultrawork¶

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

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

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

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

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

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

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

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

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

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

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

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

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

3. Попробуйте переключиться на другой API-эндпоинт (например, прямое подключение через Шэньчжэнь)

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

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

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

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

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

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

• Официальный сайт OpenCode

• OpenCode на GitHub

• oh-my-opencode на GitHub

• Официальная документация OpenCode

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

• Ознакомьтесь с интеграцией с VS Code для работы в IDE

• Изучите интеграцию с Codex для использования моделей OpenAI Codex

• Узнайте советы по CLI для повышения эффективности в терминале