Команды 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](/articles/opencode-mcp/)

[Создание агентов в OpenCode](/articles/opencode-agenty/)

[Провайдеры моделей в OpenCode](/articles/opencode-provaydery/)

[Документация OpenCode (рус.)](/docs/overview/)

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

Заключение

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

---

*Отчёт создан: [email protected] · [refertur.net](https://refertur.net) · [t.me/realhikaz](https://t.me/realhikaz) · [WhatsApp](https://wa.me/+77054384888)*

*SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в [WhatsApp](https://wa.me/+77054384888?text=%D0%97%D0%B4%D1%80%D0%B0%D0%B2%D1%81%D1%82%D0%B2%D1%83%D0%B9%D1%82%D0%B5%2C%20%D1%85%D0%BE%D1%87%D1%83%20%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0%D1%82%D1%8C%20%D1%81%D0%B5%D0%BE) — ответим в течение часа.*