CLI

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

opencode

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

opencode run "Explain how closures work in JavaScript"

tui

Запустите TUI opencode.

opencode [project]

Флаги

Команды

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

attach

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

opencode attach [url]

Это позволяет использовать TUI с удаленным сервером opencode. Например:

# Start the backend server for web/mobile access
opencode web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
opencode attach http://10.20.30.40:4096

Флаги

auth

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

opencode auth [command]

login

opencode использует список провайдеров с Models.dev, поэтому вы можете использовать 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

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

run

Запустите агент GitHub. Обычно это используется в действиях GitHub.

opencode github run

Флаги

mcp

Управляйте серверами протокола контекста модели.

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.

Это полезно для определения точного названия модели, которое будет использоваться в вашем config.

При желании вы можете передать идентификатор поставщика, чтобы фильтровать модели по этому поставщику.

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 при каждом запуске:

# Start a headless server in one terminal
opencode serve

# In another terminal, run commands that attach to it
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

Флаги

serve

Запустите автономный сервер opencode для доступа к API. Полный HTTP-интерфейс можно найти в server docs.

opencode serve

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

Флаги

session

Управляйте сессиями opencode.

opencode session [command]

list

Перечислите все сеансы opencode.

opencode session list

Флаги

stats

Покажите статистику использования токенов и затрат для ваших сеансов opencode.

opencode stats

Флаги

export

Экспортируйте данные сеанса в формате JSON.

opencode export [sessionID]

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

import

Импортируйте данные сеанса из файла JSON.

opencode import <file>

opencode import session.json

web

Запустите автономный сервер opencode с веб-интерфейсом.

opencode web

При этом запускается HTTP-сервер и открывается веб-браузер для доступа к opencode через веб-интерфейс. Установите OPENCODE_SERVER_PASSWORD, чтобы включить базовую аутентификацию HTTP (имя пользователя по умолчанию — opencode).

Флаги

acp

Запустите сервер ACP (агент-клиентский протокол).

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 можно настроить с помощью переменных среды.

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

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