CLI

Параметры и команды CLI OpenCode.

CLI OpenCode по умолчанию запускает TUI при запуске без аргументов.

opencode

Но также принимает команды, описанные на этой странице. Это позволяет взаимодействовать с OpenCode программно.

opencode run "Explain how closures work in JavaScript"

tui

Запуск терминального пользовательского интерфейса OpenCode.

opencode [project]

Флаги

Команды

CLI OpenCode также имеет следующие команды.

agent

Управление агентами для OpenCode.

opencode agent [command]

attach

Подключение терминала к уже запущенному серверу OpenCode, запущенному через команды serve или web.

opencode attach [url]

Это позволяет использовать TUI с удалённым бэкендом OpenCode. Например:

# Запуск бэкенд-сервера для веб/мобильного доступа
opencode web --port 4096 --hostname 0.0.0.0
 
# В другом терминале подключаем TUI к работающему бэкенду
opencode attach http://10.20.30.40:4096

Флаги

create

Создание нового агента с пользовательской конфигурацией.

opencode agent create

Эта команда проведёт вас через создание нового агента с пользовательским системным промптом и конфигурацией инструментов.

list

Список всех доступных агентов.

opencode agent list

auth

Команда для управления учётными данными и входом для провайдеров.

opencode auth [command]

login

OpenCode использует список провайдеров с Models.dev (opens in a new tab), поэтому вы можете использовать opencode auth login для настройки API-ключей любого провайдера. Данные хранятся в ~/.local/share/opencode/auth.json.

opencode auth login

При запуске OpenCode загружает провайдеров из файла учётных данных. А также ключи, определённые в переменных окружения или файле .env в вашем проекте.

list

Список всех аутентифицированных провайдеров из файла учётных данных.

opencode auth list

Или короткая версия.

opencode auth ls

logout

Выход из провайдера путём удаления из файла учётных данных.

opencode auth logout

github

Управление GitHub-агентом для автоматизации репозитория.

opencode github [command]

install

Установка GitHub-агента в ваш репозиторий.

opencode github install

Это настраивает необходимый workflow GitHub Actions и проводит вас через процесс конфигурации. Подробнее.

run

Запуск GitHub-агента. Обычно используется в GitHub Actions.

opencode github run

Флаги

mcp

Управление серверами Model Context Protocol.

opencode mcp [command]

add

Добавление MCP-сервера в вашу конфигурацию.

opencode mcp add

Эта команда проведёт вас через добавление локального или удалённого MCP-сервера.

list

Список всех настроенных MCP-серверов и их статус подключения.

opencode mcp list

Или короткая версия.

opencode mcp ls

auth

Аутентификация на MCP-сервере с поддержкой OAuth.

opencode mcp auth [name]

Если вы не укажете имя сервера, вам будет предложено выбрать из доступных серверов с поддержкой OAuth.

Вы также можете просмотреть серверы с поддержкой OAuth и их статус аутентификации.

opencode mcp auth list

Или короткая версия.

opencode mcp auth ls

logout

Удаление OAuth-учётных данных для MCP-сервера.

opencode mcp logout [name]

debug

Отладка проблем OAuth-подключения для MCP-сервера.

opencode mcp debug <name>

models

Список всех доступных моделей от настроенных провайдеров.

opencode models [provider]

Эта команда отображает все доступные модели от ваших настроенных провайдеров в формате provider/model.

Это полезно для определения точного имени модели для использования в вашей конфигурации.

Вы можете опционально передать ID провайдера для фильтрации моделей по этому провайдеру.

opencode models anthropic

Флаги

Используйте флаг --refresh для обновления кэшированного списка моделей. Это полезно, когда у провайдера появились новые модели и вы хотите увидеть их в OpenCode.

opencode models --refresh

run

Запуск opencode в неинтерактивном режиме путём передачи промпта напрямую.

opencode run [message..]

Это полезно для скриптов, автоматизации или когда вам нужен быстрый ответ без запуска полного TUI. Например.

opencode run "Explain the use of context in Go"

Вы также можете подключиться к работающему экземпляру opencode serve, чтобы избежать времени холодного запуска MCP-сервера при каждом запуске:

# Запуск headless-сервера в одном терминале
opencode serve
 
# В другом терминале выполняем команды, подключаясь к нему
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

Флаги

serve

Запуск headless-сервера OpenCode для API-доступа. Смотрите документацию сервера для полного HTTP-интерфейса.

opencode serve

Это запускает HTTP-сервер, предоставляющий API-доступ к функциональности opencode без TUI-интерфейса. Установите OPENCODE_SERVER_PASSWORD для включения HTTP basic auth (имя пользователя по умолчанию opencode).

Флаги

session

Управление сессиями OpenCode.

opencode session [command]

list

Список всех сессий OpenCode.

opencode session list

Флаги

stats

Показать статистику использования токенов и стоимости для ваших сессий OpenCode.

opencode stats

Флаги

export

Экспорт данных сессии в JSON.

opencode export [sessionID]

Если вы не укажете ID сессии, вам будет предложено выбрать из доступных сессий.

import

Импорт данных сессии из JSON-файла или URL для обмена OpenCode.

opencode import <file>

Вы можете импортировать из локального файла или URL для обмена OpenCode.

opencode import session.json
opencode import https://opncd.ai/s/abc123

web

Запуск headless-сервера OpenCode с веб-интерфейсом.

opencode web

Это запускает HTTP-сервер и открывает веб-браузер для доступа к OpenCode через веб-интерфейс. Установите OPENCODE_SERVER_PASSWORD для включения HTTP basic auth (имя пользователя по умолчанию opencode).

Флаги

acp

Запуск сервера ACP (Agent Client Protocol).

opencode acp

Эта команда запускает сервер ACP, который взаимодействует через stdin/stdout с использованием nd-JSON.

Флаги

uninstall

Удаление OpenCode и всех связанных файлов.

opencode uninstall

Флаги

upgrade

Обновление opencode до последней версии или определённой версии.

opencode upgrade [target]

Для обновления до последней версии.

opencode upgrade

Для обновления до определённой версии.

opencode upgrade v0.1.48

Флаги

Глобальные флаги

CLI opencode принимает следующие глобальные флаги.

Переменные окружения

OpenCode можно настроить с помощью переменных окружения.

Экспериментальные

Эти переменные окружения включают экспериментальные функции, которые могут измениться или быть удалены.