Команды OpenCode: полный справочник для работы в терминале

Команды OpenCode — это главный инструмент управления ИИ-агентом в терминале. Зная базовые команды opencode cli и флаги, вы сможете запускать задачи, выбирать модели и агентов, работать с Git и автоматизировать рутину в несколько раз быстрее. В этом справочнике собраны все ключевые команды OpenCode с примерами.

Запуск OpenCode

Команда	Назначение
opencode	Запуск интерактивной сессии в текущей папке
opencode --help	Показать справку по всем командам
opencode --version	Показать версию установленного OpenCode
opencode run "задача"	Выполнить задачу без интерактивного режима
opencode serve	Запустить локальный сервер (для интеграций)

Пример запуска интерактивной сессии:

cd ~/Projects/my-app
opencode

Флаги запуска

Выбор модели и агента

# конкретная модель
opencode --model gpt-4o

# конкретный агент
opencode --agent code-reviewer

# модель и агент вместе
opencode --model claude-sonnet --agent builder

Рабочая директория и сессия

# запуск в конкретной папке
opencode --directory ~/Projects/api

# продолжение последней сессии
opencode --continue

# продолжение конкретной сессии по ID
opencode --session 4f2a9c1e

Вывод и форматирование

# неинтерактивный вывод ответа
opencode run "объясни файл main.py" --print

# формат вывода (text, json, stream-json)
opencode run "покажи структуру" --format json

Команда run — выполнение задач

Команда opencode run выполняет задачу без открытия интерактивного интерфейса — идеально для скриптов и автоматизации:

# простая задача
opencode run "найди баги в тестах и исправь"

# с выбором модели
opencode run --model gpt-4o "оптимизируй запросы к БД"

# с выводом в файл
opencode run "создай README" --print > README.md

Полезные флаги команды run:

• --print — вывести результат в stdout без интерактивного интерфейса
• --format json — вывод в JSON для парсинга
• --model — модель для задачи
• --agent — специализированный агент
• --directory — рабочая папка

Команды для работы с агентами и скиллами

OpenCode позволяет создавать и использовать собственных агентов и скиллы:

Команда	Назначение
opencode agent --help	Справка по управлению агентами
opencode skill --help	Справка по скиллам
opencode provider	Управление провайдерами моделей
opencode auth	Авторизация и ключи API

Создание агента — это создание Markdown-файла в папке .opencode/agent/ с описанием роли, инструкций и доступных инструментов.

Работа с Git из OpenCode

OpenCode умеет выполнять Git-команды в рамках сессии, но полезно знать и прямые команды для скорости:

# проверить статус репозитория
opencode run "покажи git status и незакоммиченные изменения"

# создать коммит
opencode run "закоммить все изменения с понятным сообщением"

# создать пул-реквест
opencode run "создай pull request для текущей ветки"

Сокращения и горячие клавиши в интерактивной сессии

Внутри интерактивной сессии работают стандартные клавиши:

• Ctrl+C — прервать текущий ответ
• Ctrl+D — выйти из сессии
• Стрелки вверх/вниз — история команд
• Tab — автодополнение
• @ — упоминание файлов и контекста в сообщении

Примеры типовых сценариев

Сценарий 1: быстрый запуск с моделью

opencode --model claude-sonnet --directory ~/Projects/blog

Сценарий 2: автономная генерация кода

opencode run "создай REST API на FastAPI с моделями и эндпоинтами" --print

Сценарий 3: ревью кода

opencode run --agent code-reviewer "проверь код в src/ на баги и безопасность" --format json

Таблица: команды одной строкой

Задача	Команда
Проверить версию	opencode --version
Получить справку	opencode --help
Запустить сессию	opencode
Выполнить задачу	opencode run "..."
Выбрать модель	opencode --model gpt-4o
Продолжить сессию	opencode --continue
Вывести без интерфейса	opencode run "..." --print
Запустить сервер	opencode serve

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

• Какие основные команды opencode cli нужно знать? — opencode, opencode run, opencode --help, opencode serve, opencode --version.
• Как запустить OpenCode в неинтерактивном режиме? — Командой opencode run "задача" с опциональными флагами.
• Как посмотреть справку по командам OpenCode? — opencode --help и opencode run --help.
• Какие флаги часто используются? — --model, --agent, --directory, --print, --format, --continue, --session.
• Как выйти из интерактивной сессии? — Ctrl+D дважды или команда exit.

Что дальше

Теперь, когда вы освоили команды opencode cli, переходите к следующим темам:

• Подключение MCP-серверов к OpenCode
• Создание агентов в OpenCode
• Провайдеры моделей в OpenCode
• Документация OpenCode (рус.)

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

Заключение

Справочник команд OpenCode покрывает 90% ежедневных задач: запуск сессий, выполнение задач, выбор моделей и автоматизация. Сохраните эту страницу в закладки — таблицы команд пригодятся в ежедневной работе.

---

Отчёт создан: [email protected] · refertur.net · t.me/realhikaz · WhatsApp SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в WhatsApp — ответим в течение часа.