Использование OpenCode CLI
OpenCode предоставляет мощный интерфейс командной строки (CLI). Он может не только запускать интерактивный TUI, но и выполнять автоматизированные и скриптовые операции с помощью команд.
По умолчанию OpenCode CLI запускает TUI, но его настоящая сила заключается в программируемом вызове.
OpenCode CLI — это не просто инструмент команд; это программируемый интерфейс для AI-разработки.
OpenCode CLI можно абстрагировать в три уровня:
- Уровень взаимодействия：
tui / web / attach - Уровень выполнения：
run / agent / mcp / github - Сервисный уровень：
serve / acp
👉 По сути, этоAI Agent + локальная среда разработки + программируемый CLI + Server APIединая точка входа.
Ниже представлена полная таблица команд OpenCode CLI:
Базовое поведение
| Команда/Использование | Описание | Примечания |
|---|---|---|
opencode |
Запуск TUI по умолчанию | Когда параметры не указаны |
opencode run "msg" |
Выполнять задачи в неинтерактивном режиме | Автоматизация/скриптинг |
Параметры запуска TUI
| Флаг | Short | Описание |
|---|---|---|
--continue |
-c |
Продолжить предыдущую сессию |
--session |
-s |
Указать ID сессии |
--fork |
— | Ответвить сессию |
--prompt |
— | Начальный запрос |
--model |
-m |
Указать модель |
--agent |
— | Указать агента |
--port |
— | Порт прослушивания |
--hostname |
— | Адрес хоста |
Основные команды CLI
| Команда | Описание | Основные подкоманды |
|---|---|---|
agent |
Управление агентами | create / list |
auth |
Управление аутентификацией | login / list / logout |
attach |
Подключение к удалённому бэкенду | — |
github |
Автоматизация GitHub | install / run |
mcp |
Управление службой MCP | add / list / auth / debug |
models |
Просмотр списка моделей | — |
run |
Неинтерактивное выполнение | — |
serve |
Запустить службу API | — |
web |
Служба веб-интерфейса | — |
session |
Управление сеансами | list |
stats |
Статистика токенов/стоимости | — |
export |
Экспортировать сеансы | — |
import |
Импортировать сеансы | — |
acp |
Запустить службу протокола ACP | — |
uninstall |
Удаление | — |
upgrade |
Обновить версию | — |
параметры команды run
| Флаг | Short | Описание |
|---|---|---|
--continue |
-c |
Продолжить сеанс |
--session |
-s |
Указать сеанс |
--fork |
— | Форк |
--share |
— | Поделиться сессией |
--model |
-m |
Указать модель |
--agent |
— | Указать агента |
--file |
-f |
Прикрепить файлы |
--format |
— | Формат вывода (json) |
--title |
— | Название сессии |
--attach |
— | Подключиться к существующему сервису |
--port |
— | Локальный порт |
Параметры команды сервиса
serve / web / acp
| Флаг | Описание |
|---|---|
--port |
Порт прослушивания |
--hostname |
Адрес хоста |
--mdns |
Обнаружение в локальной сети |
--cors |
Разрешить cross-origin |
Параметры session / stats
| Команда | Флаг | Описание |
|---|---|---|
| session | --max-count (-n) |
Последние N записей |
| session | --format |
table/json |
| stats | --days |
Последние N дней |
| stats | --tools |
Статистика инструментов |
| stats | --models |
Использование модели |
| stats | --project |
Фильтр по проекту |
Глобальные флаги
| Флаг | Short | Описание |
|---|---|---|
--help |
-h |
Справка |
--version |
-v |
Version |
--print-logs |
— | Журнал вывода |
--log-level |
— | Уровень логирования |
Переменные среды
| Переменная | Type | Назначение |
|---|---|---|
OPENCODE_AUTO_SHARE |
логическое значение | Авто-шеринг |
OPENCODE_CONFIG |
string | Путь к конфигурации |
OPENCODE_TUI_CONFIG |
string | Конфигурация TUI |
OPENCODE_DISABLE_AUTOUPDATE |
логическое значение | Отключить обновления |
OPENCODE_SERVER_PASSWORD |
string | Аутентификация API |
OPENCODE_MODELS_URL |
string | Источник модели |
Экспериментальные функции
| Переменная | Type | Назначение |
|---|---|---|
OPENCODE_EXPERIMENTAL |
логическое значение | Включить все экспериментальные функции |
OPENCODE_EXPERIMENTAL_LSP_TOOL |
логическое значение | Инструменты LSP |
OPENCODE_EXPERIMENTAL_PLAN_MODE |
логическое значение | Режим планирования |
OPENCODE_EXPERIMENTAL_FILEWATCHER |
логическое значение | Отслеживание файлов |
I. Базовое использование
1. Запуск TUI (поведение по умолчанию)
opencode
Эквивалентно входу в интерактивный интерфейс терминала
2. Указать каталог проекта
opencode /path/to/project
Запустите TUI в указанном каталоге, например, запустите его в каталоге opencode-example-test:
opencode opencode-example-test
3. Неинтерактивный режим (вызов скрипта)
opencode run 解释一下 JavaScript 中闭包的原理
Возвращает результаты напрямую, не входя в интерфейс.
II. Основные возможности CLI
Основные возможности OpenCode CLI можно обобщить в три категории:
- Интерактивный режим:TUI (по умолчанию)
- Выполнение команд:run / serve
- Управление системой:agent / auth / session и т.д.
III. Общие параметры (флаги)
| Параметр | Short | Описание |
|---|---|---|
| --continue | -c | Продолжить предыдущую сессию |
| --session | -s | Указать ID сессии |
| --fork | Ответвление от текущей сессии | |
| --model | -m | Указать модель (provider/model) |
| --agent | Указать агента | |
| --port | Порт сервиса | |
| --hostname | Адрес прослушивания |
IV. Подробности основных команд
1. run (используется чаще всего)
Используется для неинтерактивного выполнения:
opencode run 分析这个 Go 项目的上下文使用方式
Применимые сценарии:
- Автоматизация скриптов
- CI/CD
- Быстрые вопросы и ответы
Подключение к фоновому сервису (избежать холодного старта)
# 启动后台服务 opencode serve # 使用 run 连接 opencode run --attach http://localhost:4096 解释 async/await
Общие параметры
| Параметр | Описание |
|---|---|
| --model | Указать модель |
| --file | Прикрепить файлы |
| --format | Формат вывода (json / default) |
| --share | Поделиться сессией |
V. auth (управление аутентификацией)
Вход
opencode auth login
Настроить API-ключ (хранится локально)
Просмотреть провайдеров, в которых выполнен вход
opencode auth list
Выход
opencode auth logout
VI. models (управление моделями)
Просмотреть все модели
opencode models
Фильтровать по провайдеру
opencode models anthropic
Обновить список моделей
opencode models --refresh
VII. agent (система агентов)
Создать агента
opencode agent create
Настраиваемые промпты + инструменты
Просмотр агентов
opencode agent list
VIII. session (управление сессиями)
Просмотр сессий
opencode session list
Ограничение количества
opencode session list -n 10
IX. serve (сервисный режим)
Запуск сервиса API:
opencode serve
Предоставляет HTTP-интерфейс (без UI)
Необязательные параметры:
- --port: Порт
- --hostname: адрес прослушивания
X. web (веб-интерфейс)
opencode web
Запуск версии с веб-интерфейсом
XI. mcp (возможность расширения)
Добавить сервис MCP
opencode mcp add
Просмотреть список
opencode mcp list
MCP используется для расширения возможностей ИИ (например, вызов инструментов)
XII. Статистика (статистика использования)
opencode stats
Просмотреть использование токенов и затраты
XIII. Экспорт / импорт
Экспортировать сеансы
opencode export
Импортировать сеансы
opencode import session.json
XIV. Обновление и удаление
Обновление
opencode upgrade
Удаление
opencode uninstall
XV. Глобальные параметры
| Параметр | Описание |
|---|---|
| --help | Просмотр справки |
| --version | Просмотреть версию |
| --log-level | Уровень логирования |
XVI. Переменные окружения (расширенная конфигурация)
OpenCode поддерживает управление поведением через переменные среды, например:
OPENCODE_DISABLE_AUTOUPDATE=true OPENCODE_SERVER_PASSWORD=123456
Распространённые способы использования:
- Отключение автоматических обновлений
- Настройка аутентификации сервиса
- Пользовательский путь к конфигурации
XVII. Рекомендации по использованию (ключевые моменты)
- Используйте TUI для повседневной разработки
- Используйте run для автоматизации
- Комбинируйте agent для сложных задач
- Используйте serve + attach для высокочастотных вызовов