OpenCode 2.1.4: настройка QCode 2026

OpenCode 2.1.4 (2026-10-23): QCode.cc в opencode.json через baseURL для anthropic и openai, ключ сохраняется через /connect.

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Последняя проверка: 2026-10-26 · 📄 По официальной документации (OpenCode 2 v2.1.4, выпуск 2026-10-23; последняя версия OpenCode 1 — v1.19.4, выпуск 2026-10-22 (репозиторий теперь anomalyco/opencode); при проверке 2026-10-20 на странице были v2.1.0 и v1.19.3)

Кратко¶

⚠️ Важное замечание: требуется разрешение на прямой доступ к 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 и других

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

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

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

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

OpenCode 2 (2026-10-20): OpenCode 2 принимает и сохраняет конфигурацию lsp, но не запускает языковые серверы, не предоставляет инструменты LSP и не выдаёт диагностику LSP (официальная документация).

Статистика проекта (по состоянию на 2026-10-20):

• GitHub Stars: 218,397 (по состоянию на 2026-10-20; 213k+ по состоянию на 2026-10-15)

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

• Version: OpenCode 2 v2.1.4 (2026-10-23); последняя версия OpenCode 1 — v1.19.4 (2026-10-22). Ранее указанные v2.1.0 (2026-10-20), v1.19.3 (2026-10-16) и v1.19.0 (2026-10-11) теперь являются историческими выпусками.

oh-my-opencode¶

oh-my-opencode — сторонний плагин-расширение для OpenCode, которое в сообществе называют «OpenCode на стероидах». Учтите: по состоянию на 2026-10-15 репозиторий переименован в code-yeongyu/oh-my-openagent, в README проект называется OmO, а основной точкой входа стала отдельная команда omo. Прежняя версия для OpenCode в README названа «OpenCode edition», а перейти с неё можно командой omo setup (см. руководство Migrating from OpenCode). Ключевое слово ultrawork в README по-прежнему описано.

Поскольку его форма изменилась, на этой странице больше нет таблицы встроенных ролей агентов прежней версии и старой команды установки bunx oh-my-opencode install. При необходимости ориентируйтесь на официальный README: code-yeongyu/oh-my-openagent. Приведённая ниже конфигурация OpenCode от него не зависит.

По состоянию на 2026-10-20 в README проект обозначен как OmO 5.0, а команда установки указана как curl -fsSL https://get.omo.dev/install.sh | bash; там же сказано, что OmO работает на senpi — форке pi от этого проекта.

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

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

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

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

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

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

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

# macOS Homebrew
brew install anomalyco/tap/opencode

По состоянию на 2026-10-20 этот скрипт устанавливает только OpenCode 1. Для OpenCode 2 используются отдельные команды установки; см. раздел OpenCode 2 ниже.

Шаг 2: oh-my-opencode (необязательно)¶

oh-my-opencode не обязателен. Если хотите его использовать, установите по официальному README по ссылке выше; приведённая ниже конфигурация OpenCode от него не зависит.

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

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

О выборе моделей: в конфигурации ниже используются модели Claude серии 5.5 и GPT от QCode. Повседневные модели по умолчанию — claude-sonnet-5-5 / claude-opus-5-5, для лёгких задач — claude-haiku-5-5; из GPT — gpt-6.1-sol / gpt-6-sol / gpt-5.6-terra. Какие модели можно вызывать, указано на qcode.cc/models. QCode сейчас не предоставляет ни Gemini, ни Grok, поэтому в конфигурации только два провайдера — anthropic и openai. ID китайских моделей — в разделе Китайские модели.

О baseURL: в документации OpenCode пример baseURL для Anthropic заканчивается на /v1 (https://api.anthropic.com/v1), поэтому и здесь пишем до /v1: для Anthropic — https://api.qcode.cc/claude/v1, для OpenAI — https://api.qcode.cc/openai/v1; пути совпадают с разделом Точки доступа и форматы API.

О китайских моделях: встроенный провайдер openai в OpenCode (@ai-sdk/openai) работает через интерфейс Responses, а интерфейс Responses у QCode китайские модели не обслуживает. Для них создайте отдельный провайдер @ai-sdk/openai-compatible (chat/completions, baseURL https://api.qcode.cc/openai/v1); ID моделей — в разделе Китайские модели. В документации OpenCode по провайдерам сказано: для /v1/responses используйте @ai-sdk/openai, для /v1/chat/completions — @ai-sdk/openai-compatible.

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

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

  "model": "anthropic/claude-opus-5-5",
  "small_model": "anthropic/claude-haiku-5-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-5",
      "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 5.5",
      "model": "anthropic/claude-opus-5-5",
      "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-6.1 Sol",
      "model": "openai/gpt-6.1-sol",
      "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.6 Terra",
      "model": "openai/gpt-5.6-terra",
      "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 5.5",
      "model": "anthropic/claude-haiku-5-5",
      "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 5.5",
      "model": "anthropic/claude-sonnet-5-5",
      "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-6.1 Sol",
      "model": "openai/gpt-6.1-sol",
      "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:

Для пользователей из материкового Китая: используйте asia.qcode.cc (азиатская точка доступа) и установите baseURL на два адреса из строки «Азия» в таблице выше.

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

QCode в настоящее время поддерживает следующие популярные модели (полный список и цены — на qcode.cc/models):

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

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

• claude-sonnet-5-5 — дневное умолчание (claude-sonnet-5 и claude-sonnet-4-6 по-прежнему можно вызывать)

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

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

• gpt-6.1-sol — основной флагман, контекст 1.05M (рекомендуется)

• gpt-6-sol — GPT-6 Sol, контекст 1.05M

• gpt-5.6-terra — программирование / Codex CLI

• gpt-5.6-sol — соседний вариант 5.6

QCode сейчас не предоставляет ни серию Gemini, ни gpt-6-luna / gpt-5.6-luna.

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

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

Вы можете настроить 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 2 сохранённые API-ключи и токены OAuth находятся в базе данных SQLite на сервере. При миграции базы V2 импортирует поддерживаемые учётные данные из старого auth.json (официальная документация, 2026-10-20).

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

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

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

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

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

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

Режим ultrawork¶

В прежней версии oh-my-opencode (OpenCode edition) достаточно добавить в промпт ultrawork или ulw, чтобы включить параллельную оркестрацию нескольких моделей; новая версия OmO — отдельная команда omo, ориентируйтесь на её README. Пример для прежней версии:

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

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

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

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

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

В OpenCode 2 стандартная клавиша переключения агентов — Shift+Tab (официальная документация, 2026-10-20).

OpenCode 2¶

OpenCode 2 — отдельная мажорная версия того же проекта. Стандартный установщик по-прежнему устанавливает только OpenCode 1; обе версии используют команду opencode, поэтому при использовании команды по умолчанию они не могут быть установлены одновременно (официальный установщик и руководство по миграции, 2026-10-20).

Установка OpenCode 2¶

В документации V2 перечислены следующие команды установки:

# OpenCode 2
curl -fsSL https://opencode.ai/v2/install | bash
npm install -g @opencode/cli
brew install anomalyco/tap/opencode-v2
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
yarn global add @opencode/cli

Перед установкой V2 удалите V1, установленную через пакетный менеджер: установщик V2 (curl) заменяет исполняемый файл V1. Чтобы обновить существующую установку OpenCode 1, выполните opencode upgrade --major (официальная документация, 2026-10-20).

Конфигурация работает в обеих версиях¶

OpenCode 2 читает системную, глобальную и проектную конфигурацию из тех же мест, что и V1, включая ~/.config/opencode/opencode.json(c). Предполагается, что существующая поддерживаемая конфигурация V1 продолжит работать; формат конфигурации V1 по-прежнему поддерживается, а нативный формат V2 необязателен. OpenCode 2 нормализует поддерживаемые поля V1 и нативного V2 в памяти, не перезаписывая исходный файл. Руководство по миграции предупреждает: не указывайте V1 на файлы после их преобразования в форму, предназначенную только для нативного V2.

Поэтому конфигурация provider / options.baseURL выше работает и в OpenCode 1, и в OpenCode 2. Если вы используете только OpenCode 2 и предпочитаете нативный формат V2, те же эндпоинты записываются так:

{
  "providers": {
    "anthropic": { "settings": { "baseURL": "https://api.qcode.cc/claude/v1" } },
    "openai": { "settings": { "baseURL": "https://api.qcode.cc/openai/v1" } }
  }
}

Этот нативный вариант предназначен только для OpenCode 2.

Различия в поведении, влияющие на конфигурацию выше¶

• Каталоги вне проекта: V1 запрашивает подтверждение перед доступом к путям вне проекта, а V2 по умолчанию разрешает external_directory. В руководстве по миграции не сказано, как V2 обрабатывает правила external_directory в формате V1 выше (здесь они заданы как deny), поэтому проверьте их действие в V2 самостоятельно. Чтобы в нативном V2 сохранить поведение V1, руководство предлагает добавить правило external_directory с эффектом ask.
• Действия в правилах доступа: lsp и doom_loop не являются текущими действиями разрешений V2 Core.
• Языковые серверы: OpenCode 2 принимает и сохраняет конфигурацию lsp, но не запускает языковые серверы, не предоставляет инструменты LSP и не выдаёт диагностику LSP.
• Учётные данные: сохранённые API-ключи и токены OAuth находятся в базе данных SQLite на сервере. При миграции базы V2 импортирует поддерживаемые учётные данные из старого auth.json; новые и обновлённые учётные данные сохраняются в SQLite и не записываются обратно в этот файл.
• Переключение агентов: стандартная клавиша для agent.cycle — Shift+Tab.
• Плагины: реализации плагинов V1 не работают в V2; плагины используют новый API плагинов.

Описание обновления до OpenCode 2 на qcode.cc, включая отключение общего доступа к сессиям в 1.19.1, см. в разделе Обновление до OpenCode 2 и отключение общего доступа к сессиям.

Изменения 2.1.3–2.1.4 и 1.19.4 (2026-10-26)¶

OpenCode 2.1.4 выпущен 2026-10-23, 2.1.3 — 2026-10-22, последняя версия ветки 1.x — 1.19.4 — 2026-10-22. Пункты, которые касаются конфигурации выше:

• 2.1.3 — настройки baseURL пользовательского провайдера теперь переопределяют конечные точки моделей из каталога, как и ожидается.
• 2.1.3 — встроенный рантайм Bun обновлён до 1.4.4: исправления безопасности для Brotli, TLS, HTTP/1.1, HTTP/2, HTTP/3, WebSocket и fetch, а также обновление корневых сертификатов до NSS 3.131.1.
• 2.1.4 — когда MCP-сервер запрашивает ввод во время вызова инструмента, форма теперь появляется, а вызов не ждёт до тайм-аута; экспериментальное фоновое сжатие включается через experimental.background_compaction.
• 1.19.4 — ветка 1.x получила те же исправления безопасности Bun 1.4.4.

Команды установки V2 выше не изменились в документации, проверенной 2026-10-26.

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

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

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

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

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

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

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

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

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

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

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

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

• OpenCode на GitHub

• oh-my-opencode на GitHub

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

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

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

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

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

Enterprise →