~/.config/opencode/
Глобальные opencode.json, AGENTS.md, commands/, skills/ и plugins/. Падение настольного приложения часто даёт плагин. Очистите ключ plugin и перезапустите. См. устранение неполадок рабочего стола.
Список возможностей из продукта
Что OpenCode реально делает
Каждый заголовок ниже - именованная возможность с главной OpenCode, из введения, TUI, агентов или документации по правам. Если вы здесь ради установки, переходите на страницу загрузки.
Три поверхности, один агент
На главной это названо «любой редактор»: терминальный интерфейс, настольное приложение и расширение IDE. Именно рабочий стол получил вкладки для активных сессий. Официальная страница загрузки по-прежнему ставит Terminal первым, затем Desktop, затем Extensions.
Конфиг TUI лежит в tui.json (тема, сочетания клавиш, курсор, звуки внимания). Рабочий конфиг лежит в opencode.json. Это разные файлы.
Пустое окно рабочего стола на Windows обычно связано с WebView2. Разбор в руководствах.
Модели, входы и Zen
«Любая модель» на главной значит 75+ провайдеров LLM через Models.dev, включая локальные модели. /connect добавляет провайдера. Модели указываются как provider/model, например openai/gpt-4.1 или opencode/kimi-k2.
| Путь | Что это |
|---|---|
| /connect | Добавьте провайдера и вставьте API-ключ, либо войдите в Copilot, ChatGPT, Claude или Zen. |
| /models | Откройте список. В оболочке выполните opencode models, чтобы увидеть, что реально можно вызвать. |
| OpenCode Zen | Отобранные модели, которые проект проверил для агентов кода, чтобы качество провайдера было меньше лотереей. |
| GitHub Copilot | Войдите через GitHub. v1.18.31 запрашивает сжатое адаптивное рассуждение для моделей Copilot. |
| ChatGPT Plus/Pro | Войдите через OpenAI. В v1.18.29 исправлена видимость gpt-6-astra для пользователей подписки OpenAI. |
| Локальные модели | И главная, и FAQ говорят, что локальные модели подключаются через тот же список провайдеров. |
Цикл агента
- Tab · Plan / Build
- Build - основной агент по умолчанию с включёнными инструментами. Plan ограничен: edit и bash по умолчанию спрашивают или отклоняются, чтобы модель могла предложить работу, не трогая дерево.
- /init · AGENTS.md
- Пошаговая настройка, которая пишет правила проекта. Закоммитьте файл. Глобальные правила также могут лежать в ~/.config/opencode/AGENTS.md.
- /undo · /redo
- Откатывает или возвращает последний ход пользователя и правки файлов после него. Нужен Git. Отменять можно不止 раз.
- /share · /unshare
- Публикует сессию для ревью или отладки. Разговоры не публикуются, пока вы не выполните команду.
Права - это ограничитель
С v1.1.1 старый булев tools свёрнут в permission. Каждое правило: allow, ask или deny. opencode --auto подтверждает запросы, которые не запрещены.
- read / edit / bash / grep / glob
- Инструменты файлов и оболочки. Шаблоны могут разрешать
git *и запрещатьrm *. - external_directory
- Срабатывает, когда инструмент выходит из рабочей директории. По умолчанию ask. Раскрытие домашней папки через ~ эту защиту не обходит.
- doom_loop
- Срабатывает, когда один и тот же вызов инструмента повторяется три раза с одинаковым вводом. По умолчанию ask.
- .env files
- Для read стоит allow, но
*.envи*.env.*по умолчанию deny.*.env.exampleостаётся allow.
MCP, агенты и файлы проекта
Конфиг лежит в известных папках. Ниже те пути, которые реально названы в шпаргалке.
.opencode/ в репозитории
Конфиг, команды, навыки и плагины конкретного проекта. В markdown агента можно задать mode: subagent и запретить edit, чтобы рецензент не писал файлы.
/mcp
Показывает настроенные серверы MCP и статус соединения. Ключи прав могут целиться в сервер шаблонами вроде mymcp_*.
Вкладки рабочего стола
Заголовок страницы загрузки: раскладывайте работу и активные сессии по вкладкам на macOS, Windows и Linux.